Устранение неполадок gRPC

Этот гайд предназначен для устранения неполадок в реализациях gRPC, основанных на C-ядерной библиотеке (источники большинства из них находятся в репозитории grpc/grpc).

Включение дополнительного логирования и трассировки

Дополнительное логирование может быть очень полезным для диагностики проблем. Все реализации gRPC, основанные на C-ядерной библиотеке, поддерживают переменные окружения GRPC_VERBOSITY и GRPC_TRACE, которые могут использоваться для увеличения количества информации, выводимой в stderr.

GRPC_VERBOSITY

GRPC_VERBOSITY используется для установки минимального уровня сообщений журнала, выводимых gRPC (поддерживаемые значения: DEBUG, INFO и ERROR). Если эта переменная окружения не установлена, будут выводиться только сообщения журнала уровня ERROR.

GRPC_TRACE

GRPC_TRACE может использоваться для включения дополнительного логирования для некоторых внутренних компонентов gRPC. Включение правильных трассировок может быть неоценимым для диагностики причин возникновения проблем, когда что-то не работает так, как ожидалось. Возможные значения для GRPC_TRACE перечислены в Обзоре переменных окружения. Множество трассировок может быть включено одновременно (используйте запятую в качестве разделителя).```

Включение отладочных логов для приложения

GRPC_VERBOSITY=debug ./helloworld_application_using_grpc

Вывод информации о вызовах низкоуровневого C-ядерного API.

Обратите внимание, что трассировочные логи уровня DEBUG не будут отображаться.

Также обратите внимание, что большинство трассировщиков используют уровень журнала INFO, поэтому без установки

переменной окружения GRPC_VERBOSITY соответствующим образом, трассировки не будут выводиться.

GRPC_VERBOSITY=info GRPC_TRACE=api ./helloworld_application_using_grpc

Вывод информации из трёх разных трассировщиков, включая трассировочные логи уровня DEBUG

GRPC_VERBOSITY=debug GRPC_TRACE=tcp,http,api ./helloworld_application_using_grpc

Знайте, что `GRPC_TRACE=tcp` в настоящее время не реализовано для Windows (вы не увидите никаких трассировок TCP).

Обратите внимание, что переменная окружения `GRPC_TRACE` не имеет ничего общего с функцией "трассировки" gRPC (= трассировка RPC в среде микросервисов для получения информации о том, как запросы обрабатываются развертыванием), она используется исключительно для включения вывода дополнительных логов.