35.5.1 Configuring Log Telemetry — MySQL 9.2

35.5.1 Настройка телеметрии логов

В этом разделе описана настройка сервера.

Для получения информации о настроенных логгерах см. раздел 29.12.21.1, «Таблица setup_loggers».

Переменные системы конфигурации сервера

Ниже приведены переменные системы серверной телеметрии логов:

telemetry.log_enabled

Системная переменная	`telemetry.log_enabled`
Область видимости	Глобальная
Динамическая	Да
`SET_VAR` Подсказка применяется	Нет
Тип	Boolean
Значение по умолчанию	`ON`

Управляет экспортом журналов телеметрии.

telemetry.otel_exporter_otlp_logs_protocol

Системная переменная	`telemetry.otel_exporter_otlp_logs_protocol`
Область видимости	Глобальная
Динамическая	Нет
`SET_VAR` Подсказка применяется	Нет
Тип	Enumeration
Значение по умолчанию	`http/protobuf`
Допустимые значения	`http/protobuf` `http/json`

Протокол транспорта OTLP

telemetry.otel_exporter_otlp_logs_endpoint

Системная переменная	`telemetry.otel_exporter_otlp_logs_endpoint`
Область видимости	Глобальная
Динамическая	Нет
`SET_VAR` Подсказка применяется	Нет
Тип	String
Значение по умолчанию	`http://localhost:4318/v1/logs`

Целевой URL, на который экспортер отправляет журналы.

telemetry.otel_exporter_otlp_logs_certificates

Системная переменная	`telemetry.otel_exporter_otlp_logs_certificates`
Область видимости	Глобальная
Динамическая	Нет
`SET_VAR` Подсказка применяется	Нет
Тип	String
Значение по умолчанию

Доверенный сертификат, используемый для проверки TLS-удостоверений сервера.

telemetry.otel_exporter_otlp_logs_client_key

Системная переменная	`telemetry.otel_exporter_otlp_logs_client_key`
Область видимости	Глобальная
Динамическая	Нет
`SET_VAR` Подсказка применяется	Нет
Тип	String
Значение по умолчанию

Закрытый ключ клиента в формате PEM.

telemetry.otel_exporter_otlp_logs_client_certificates

Системная переменная	`telemetry.otel_exporter_otlp_logs_client_certificates`
Область видимости	Глобальная
Динамическая	Нет
`SET_VAR` Подсказка применяется	Нет
Тип	String
Значение по умолчанию

Цепочка доверия клиентского сертификата/ключа в формате PEM.

telemetry.otel_exporter_otlp_logs_headers

Системная переменная	`telemetry.otel_exporter_otlp_logs_headers`
Область видимости	Глобальная
Динамическая	Нет
`SET_VAR` Подсказка применяется	Нет
Тип	String
Значение по умолчанию

Список заголовков для всех исходящих журналов.

telemetry.otel_exporter_otlp_logs_compression

Системная переменная	`telemetry.otel_exporter_otlp_logs_compression`
Область видимости	Глобальная
Динамическая	Нет
`SET_VAR` Подсказка применяется	Нет
Тип	String
Значение по умолчанию	`none (no compression)`
Допустимые значения	`none (no compression)` `gzip`

Сжатие, используемое экспортером журналов.

telemetry.otel_exporter_otlp_logs_timeout

Системная переменная	`telemetry.otel_exporter_otlp_logs_timeout`
Область видимости	Глобальная
Динамическая	Нет
`SET_VAR` Подсказка применяется	Нет
Тип	Integer
Значение по умолчанию	`10000`
Единица измерения	миллисекунды

Время в миллисекундах, которое экспортер OTLP ожидает каждого пакетного экспорта.

telemetry.otel_blrp_schedule_delay

Системная переменная	`telemetry.otel_blrp_schedule_delay`
Область видимости	Глобальная
Динамическая	Нет
`SET_VAR` Подсказка применяется	Нет
Тип	Integer
Значение по умолчанию	`5000`
Единица измерения	миллисекунды

Интервал задержки между двумя последовательными экспортами в миллисекундах.

telemetry.otel_blrp_max_queue_size

Системная переменная	`telemetry.otel_blrp_max_queue_size`
Область видимости	Глобальная
Динамическая	Нет
`SET_VAR` Подсказка применяется	Нет
Тип	Integer
Значение по умолчанию	`2048`

Максимальный размер очереди.

telemetry.otel_blrp_max_export_batch_size

Системная переменная	`telemetry.otel_blrp_max_export_batch_size`
Область видимости	Глобальная
Динамическая	Нет
`SET_VAR` Подсказка применяется	Нет
Тип	Integer
Значение по умолчанию	`512`

Максимальный размер пакета.

telemetry.otel_exporter_otlp_logs_min_tls

Системная переменная	`telemetry.otel_exporter_otlp_logs_min_tls`
Область видимости	Глобальная
Динамическая	Нет
`SET_VAR` Подсказка применяется	Нет
Тип	Enumeration
Значение по умолчанию	`[none]`
Допустимые значения	`[none]` `1.2` `1.3`

Минимально допустимая версия TLS. Если оставлено пустым, используется TLS 1.2.

telemetry.otel_exporter_otlp_logs_max_tls

Переменная системы	`telemetry.otel_exporter_otlp_logs_max_tls`
Область действия	Глобальная
Динамическая	Нет
`SET_VAR` Применяется подсказка	Нет
Тип	Перечисление
Значение по умолчанию	`[none]`
Допустимые значения	`[none]` `1.2` `1.3`

Максимальная поддерживаемая версия TLS. Если поле пустое, ограничений по версии TLS нет.

telemetry.otel_exporter_otlp_logs_cipher

Переменная системы	`telemetry.otel_exporter_otlp_logs_cipher`
Область действия	Глобальная
Динамическая	Нет
`SET_VAR` Применяется подсказка	Нет
Тип	Строка
Значение по умолчанию	`[list of ciphers]`

Текущий список шифров TLS 1.2 для использования в журнале. Текущее значение по умолчанию:

ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:
ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:
ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-CCM:ECDHE-ECDSA-AES128-CCM:
DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-CCM:
DHE-RSA-AES128-CCM:DHE-RSA-CHACHA20-POLY1305

telemetry.otel_exporter_otlp_logs_cipher_suite

Переменная системы	`telemetry.otel_exporter_otlp_logs_cipher_suite`
Область действия	Глобальная
Динамическая	Нет
`SET_VAR` Применяется подсказка	Нет
Тип	Строка
Значение по умолчанию	`[none]`

Текущий список шифров TLS 1.3 для использования в журнале. Текущее значение по умолчанию:

 TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_CCM_SHA256

Статусные переменные конфигурации сервера

В этом разделе описаны статусные переменные, относящиеся к логгеру.

Telemetry_logs_supported: отображает наличие поддержки Телеметрии в журнале сервера.
Performance_schema_logger_lost: отображает количество инструментов логгера, которые не удалось создать.

Конфигурация сервера через командную строку

В этом разделе описаны опции конфигурации логгера через командную строку.

performance-schema-logger: определяет значения по умолчанию для логгеров. Может быть указано несколько раз, аналогично --performance-schema-instrument.

В следующем примере все логгеры настроены на уровень ошибок ERROR, за исключением foo и bar, которые настроены на уровень ошибок INFO и WARNING соответственно:
```
              --performance-schema-logger = 'logger/% = Level:ERROR' --performance-schema-logger = 'logger/foo/% = Level:INFO'
              --performance-schema-logger = 'logger/bar/% = Level:WARNING'
            
```
Для просмотра настроенных логгеров выполните следующее:
```
select * from performance_schema.setup_loggers;
+------------------------+-------+--------------------+
| NAME                   | LEVEL | DESCRIPTION        |
+------------------------+-------+--------------------+
| logger/error/error_log | info  | MySQL error logger |
+------------------------+-------+--------------------+
            
```
Этот пример демонстрирует стандартный MySQL логгер ошибок. Его можно установить на одно из следующих значений:
- none
- error
- warn
- info
- debug
Следующий пример меняет уровень логгирования ошибок на WARNING:
```
mysql> UPDATE performance_schema.setup_loggers
       SET LEVEL='WARN'
            
```
performance_schema_max_logger_classes: эту системную переменную также можно установить с помощью командной строки. Например:
```
              --performance_schema_max_logger_classes=100
            
```
Изменение этого значения требует перезапуска сервера.