aws_client_config

Секция aws_client_config задает значения по умолчанию для клиента AWS SDK, который YDB использует при обращении к S3 и к другим объектным хранилищам с совместимым API. В ней задаются таймауты, параметры TLS и логирование для всех таких исходящих подключений процесса узла кластера; при необходимости их переопределяет конфигурация конкретного хранилища.

Синтаксис

aws_client_config:
  log_config:
    log_level: 0
    filename_prefix: ""
  verify_ssl: true
  request_timeout_ms: 0
  http_request_timeout_ms: 0
  connection_timeout_ms: 10000
  enable_tcp_keep_alive: true
  tcp_keep_alive_interval_ms: 30000
  max_connections_count: 32
  executor_threads_count: 32
  ca_path: "/etc/ssl/certs"

Параметры

Параметр Значение по умолчанию Описание
log_config.log_level 0 (Off) Числовое значение уровня детализации логов AWS SDK. Имена уровней и числовые значения см. в разделе «Уровни логов».
log_config.filename_prefix — Префикс для файлов логов AWS SDK. При задании файлы создаются как <prefix>YYYY-MM-DD-HH.log; иначе вывод идёт в stdout.
verify_ssl true Проверять TLS-сертификаты при подключении к endpoint AWS (и совместимые API). Отключать стоит только в тестовых средах.
request_timeout_ms 0 (выкл.) Таймаут на уровне AWS SDK для запроса целиком (включая DNS, установление соединения, TLS и передачу данных). Значение задается в миллисекундах. 0 — без ограничения со стороны SDK.
http_request_timeout_ms 0 (выкл.) Таймаут на уровне HTTP-клиента (Curl), в миллисекундах. 0 — без таймаута.
connection_timeout_ms 10000 Таймаут установления TCP-соединения в миллисекундах.
enable_tcp_keep_alive true Включить TCP keep-alive на клиентских сокетах.
tcp_keep_alive_interval_ms 30000 (дефолт AWS SDK) Интервал между keep-alive пакетами в миллисекундах. Если параметр не задан в конфигурации YDB, используется дефолт AWS SDK — 30000 мс. В Curl значение округляется до секунд; должен быть не меньше 15000.
max_connections_count 32 Максимум одновременных TCP‑соединений, которые может открыть HTTP-клиент в составе AWS SDK.
executor_threads_count 32 Размер пула потоков, выделяемого для каждого уникального S3 endpoint. Задает параллелизм асинхронных запросов к этому endpoint.
ca_path "/etc/ssl/certs" Путь к каталогу с корневыми сертификатами для проверки TLS при исходящих подключениях.
ca_file — Путь к файлу с набором корневых сертификатов. Используется, если хранилище доверенных сертификатов расположено нестандартно.

Уровни логов

Уровень Значение Описание
Off 0 Отключить логирование AWS SDK.
Fatal 1 Только фатальные ошибки.
Error 2 Некритические ошибки.
Warn 3 Предупреждения, требующие внимания.
Info 4 Общая информационная сводка.
Debug 5 Отладочная информация.
Trace 6 Максимально подробная диагностика.

См. также

  • log_config — логирование серверного процесса YDB; вложенный в aws_client_config блок log_config относится только к AWS SDK и с ним не связан.
  • Выгрузка и загрузка данных — импорт и экспорт через S3 из CLI; доступ к хранилищу задается там, а не в aws_client_config.

Связанные сценарии («S3 в YDB»)

Другие задачи с объектным хранилищем; настройки из этих материалов могут переопределять настройки, заданные в секции aws_client_config.

Предыдущая
auth_config
Следующая
blob_storage_config