Переменные окружения gRPC

Реализации на основе gRPC C core (содержащиеся в этом репозитории) предоставляют некоторую конфигурацию в виде переменных окружения, которые можно установить.

• grpc_proxy, https_proxy, http_proxy URI прокси-сервера для поддержки HTTP CONNECT. Эти переменные проверяются в указанном порядке, и используется первая из них, которая имеет значение.

• no_grpc_proxy, no_proxy Список через запятую хостов, к которым следует подключаться без использования прокси-сервера, даже если прокси-сервер установлен. Эти переменные проверяются в указанном порядке, и используется первая из них, которая имеет значение.

• GRPC_ABORT_ON_LEAKS Средство отладки для вызова abort() при утечках объектов gRPC после grpc_shutdown(). Установите значение 1 для вызова abort(). Если переменная не установлена или имеет значение 0, процесс не будет завершаться аварийно.

• GOOGLE_APPLICATION_CREDENTIALS Путь к файлу с учетными данными, используемыми при создании учетных данных Google.

• GRPC_SSL_CIPHER_SUITES Список через двоеточие шифровых наборов для использования с OpenSSL. По умолчанию: ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384

• GRPC_DEFAULT_SSL_ROOTS_FILE_PATH PEM-файл для загрузки корневых сертификатов SSL.

• GRPC_POLL_STRATEGY [только для окружений в стиле POSIX] Объявляет, какие механизмы опроса следует использовать при запуске gRPC. Это список через запятую механизмов опроса, которые пробуются в порядке приоритета от первого до последнего. Доступные механизмы опроса включают:

  • epoll (только для Linux) - механизм опроса, основанный на семействе системных вызовов epoll
  • poll - переносимый механизм опроса, основанный на poll(), предназначен для использования в качестве резервного механизма, когда нет ничего лучшего
  • legacy - (устаревший) исходный механизм опроса для gRPC

• GRPC_TRACE Список через запятую имен трассировщиков или шаблонов, которые предоставляют дополнительные сведения о том, как gRPC C core обрабатывает запросы через журналы отладки. Доступные трассировщики и их использование можно найти в Флаги трассировки gRPC

• GRPC_VERBOSITY (УСТАРЕЛО)

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

Мы поддерживаем этот флаг только по историческим причинам. Если эта переменная окружения установлена, то gRPC установит absl MinLogValue и absl SetVLogLevel. Это изменит настройки журнала всего приложения, а не только кода gRPC. По этой причине его использование не рекомендуется. Наша рекомендация - избегать использования этого флага и устанавливать уровень детализации журнала с помощью absl.

Уровень детализации журнала gRPC - один из следующих:

• DEBUG - выводить сообщения INFO, WARNING, ERROR и FATAL. Также включает absl VLOG(2) логи. Это не рекомендуется для производственных систем. Это будет дорогостоящим и для тестовых сред, поэтому его можно использовать только при необходимости отладки конкретной проблемы.
• INFO - выводить сообщения INFO, WARNING, ERROR и FATAL. Это не рекомендуется для производственных систем. Это может быть несколько дорогостоящим и для тестовых сред. Мы рекомендуем использовать свое усмотрение для тестовых сред.
• ERROR - выводить сообщения ERROR и FATAL. Это рекомендуется для производственных систем.
• NONE - не выводить никаких сообщений. GRPC_VERBOSITY устанавливает уровень детализации журнала absl.
• Если внешнее приложение устанавливает другой уровень детализации, то будет использовано то значение, которое было установлено позже.
• Если GRPC_VERBOSITY не установлено, то будет использовано значение, установленное внешним приложением.
• Если внешнее приложение также не устанавливает никакого значения, будет использовано значение по умолчанию, установленное absl.

• GRPC_STACKTRACE_MINLOGLEVEL (УСТАРЕЛО) Это больше не работает.

• GRPC_TRACE_FUZZER Если установлена, фазеры будут выводить трассировку (обычно она подавляется).

• GRPC_DNS_RESOLVER Объявляет, какой DNS-разрешитель следует использовать. По умолчанию используется ares, если gRPC собран с поддержкой c-ares. В противном случае значение этой переменной окружения игнорируется. Доступные DNS-разрешители включают:

  • ares (по умолчанию на большинстве платформ, кроме iOS, Android или Node) - DNS-разрешитель, основанный на библиотеке c-ares
  • native - DNS-разрешитель, основанный на getaddrinfo(), создает новую нить для выполнения разрешения имен

  NetBIOS и DNS: Если ваша сеть зависит от разрешения имен NetBIOS или смешанного разрешения имен DNS и NetBIOS (например, в некоторых сетях Windows), вы должны использовать разрешитель 'native' или убедиться, что все имена NetBIOS также настроены в DNS. Разрешитель 'ares' поддерживает только разрешение имен DNS.

• GRPC_CLIENT_CHANNEL_BACKUP_POLL_INTERVAL_MS По умолчанию: 5000 Объявляет интервал между двумя резервными опросами на клиентских каналах. Эти опросы выполняются в потоке таймера, чтобы gRPC мог обрабатывать сбои соединений, когда нет активного потока опроса. Они помогают восстановить отключенные клиентские каналы (в основном из-за простаивания), чтобы следующий RPC на этом канале не завершился неудачей. Установите значение 0 для отключения резервных опросов.

• grpc_cfstream Установите значение 1 для включения эксперимента CFStream. В этом эксперименте gRPC использует API CFStream для установления TCP-соединений. Эта опция доступна только на платформе iOS и при определении макроса GRPC_CFSTREAM.