35.3.1 Настройка трассировки телеметрии
В этом разделе описывается настройка сервера и клиента.
Конфигурация сервера
Ниже приведены переменные конфигурации телеметрии трассировки сервера:
-
Системная переменная telemetry.trace_enabledОбласть видимости Глобальная Динамическая Да SET_VARПодсказка применимаНет Тип Boolean Значение по умолчанию ONУправляет сбором трассировок телеметрии.
-
Системная переменная telemetry.query_text_enabledОбласть видимости Глобальная Динамическая Да SET_VARПодсказка применимаНет Тип Boolean Значение по умолчанию ONУправляет включением текста SQL-запроса в трассировку.
-
Системная переменная telemetry.otel_log_levelОбласть видимости Глобальная Динамическая Да SET_VARПодсказка применимаНет Тип Enumeration Значение по умолчанию ERRORДопустимые значения SILENTINFOERRORWARNINGDEBUGУправляет тем, какие логи OpenTelemetry выводятся в логах сервера.
-
telemetry.otel_resource_attributesСистемная переменная telemetry.otel_resource_attributesОбласть видимости Глобальная Динамическая Нет SET_VARПодсказка применимаНет Тип String Значение по умолчанию emptyСм. соответствующую переменную OpenTelemetry OTEL_RESOURCE_ATTRIBUTES.
-
telemetry.otel_exporter_otlp_traces_protocolСистемная переменная telemetry.otel_exporter_otlp_traces_protocolОбласть видимости Глобальная Динамическая Нет SET_VARПодсказка применимаНет Тип Enumeration Значение по умолчанию http/protobufДопустимые значения http/protobufhttp/jsonПротокол транспорта OTLP.
-
telemetry.otel_exporter_otlp_traces_endpointСистемная переменная telemetry.otel_exporter_otlp_traces_endpointОбласть видимости Глобальная Динамическая Нет SET_VARПодсказка применимаНет Тип String Значение по умолчанию http://localhost:4318/v1/tracesЦелевой URL, на который экспортер отправляет трассировки.
-
telemetry.otel_exporter_otlp_traces_certificatesСистемная переменная telemetry.otel_exporter_otlp_traces_certificatesОбласть видимости Глобальная Динамическая Нет SET_VARПодсказка применимаНет Тип String Значение по умолчанию Доверенный сертификат, используемый при проверке TLS-удостоверений сервера.
-
telemetry.otel_exporter_otlp_traces_client_keyСистемная переменная telemetry.otel_exporter_otlp_traces_client_keyОбласть видимости Глобальная Динамическая Нет SET_VARПодсказка применимаНет Тип String Значение по умолчанию Закрытый ключ клиента в формате PEM.
-
telemetry.otel_exporter_otlp_traces_client_certificatesСистемная переменная telemetry.otel_exporter_otlp_traces_client_certificatesОбласть видимости Глобальная Динамическая Нет SET_VARПодсказка применимаНет Тип String Значение по умолчанию Сертификат/цепь доверия клиента для закрытого ключа клиента в формате PEM.
-
telemetry.otel_exporter_otlp_traces_headersСистемная переменная telemetry.otel_exporter_otlp_traces_headersОбласть видимости Глобальная Динамическая Нет SET_VARПодсказка применимаНет Тип String Значение по умолчанию emptyСм. соответствующую переменную OpenTelemetry OTEL_EXPORTER_TRACES_HEADERS.
-
telemetry.otel_exporter_otlp_traces_compressionСистемная переменная telemetry.otel_exporter_otlp_traces_compressionОбласть видимости Глобальная Динамическая Нет SET_VARПодсказка применимаНет Тип String Значение по умолчанию none (no compression)Допустимые значения none (no compression)gzipСжатие, используемое экспортером.
-
telemetry.otel_exporter_otlp_traces_timeoutСистемная переменная telemetry.otel_exporter_otlp_traces_timeoutОбласть видимости Глобальная Динамическая Нет SET_VARПодсказка применимаНет Тип Integer Значение по умолчанию 10000Единица измерения миллисекунды Время в миллисекундах, которое экспортер OLTP ожидает для каждого пакетного экспорта.
-
telemetry.otel_bsp_schedule_delayПеременная системы telemetry.otel_bsp_schedule_delayОбласть действия Глобальная Динамическая Нет SET_VARПрименяется подсказкаНет Тип Целое число Значение по умолчанию 5000Единица измерения миллисекунды Интервал задержки между двумя последовательными экспортами в миллисекундах
-
telemetry.otel_bsp_max_queue_sizeПеременная системы telemetry.otel_bsp_max_queue_sizeОбласть действия Глобальная Динамическая Нет SET_VARПрименяется подсказкаНет Тип Целое число Значение по умолчанию 2048Максимальный размер очереди
-
telemetry.otel_bsp_max_export_batch_sizeПеременная системы telemetry.otel_bsp_max_export_batch_sizeОбласть действия Глобальная Динамическая Нет SET_VARПрименяется подсказкаНет Тип Целое число Значение по умолчанию 512Максимальный размер пакета
-
telemetry.otel_exporter_otlp_traces_min_tlsПеременная системы telemetry.otel_exporter_otlp_traces_min_tlsОбласть действия Глобальная Динамическая Нет SET_VARПрименяется подсказкаНет Тип Перечисление Значение по умолчанию [none]Допустимые значения [none]1.21.3 -
telemetry.otel_exporter_otlp_traces_max_tlsПеременная системы telemetry.otel_exporter_otlp_traces_max_tlsОбласть действия Глобальная Динамическая Нет SET_VARПрименяется подсказкаНет Тип Перечисление Значение по умолчанию [none]Допустимые значения [none]1.21.3 -
telemetry.otel_exporter_otlp_traces_cipherПеременная системы telemetry.otel_exporter_otlp_traces_cipherОбласть действия Глобальная Динамическая Нет SET_VARПрименяется подсказкаНет Тип Строка Значение по умолчанию [none] -
telemetry.otel_exporter_otlp_traces_cipher_suiteПеременная системы telemetry.otel_exporter_otlp_traces_cipher_suiteОбласть действия Глобальная Динамическая Нет SET_VARПрименяется подсказкаНет Тип Строка Значение по умолчанию [none]
Настройка клиента
Клиент MySQL считывает конфигурацию телеметрии из раздела [telemetry_client] файла конфигурации. См. Установка плагина клиента для получения информации об опции telemetry_client. Доступны следующие параметры конфигурации:
Таблица 35.2 Краткое описание параметров телеметрии клиента mysql
| Имя параметра | Описание |
|---|---|
| --telemetry_client | Включает клиента телеметрии. |
| --otel_bsp_max_export_batch_size | См. переменную OTEL_BSP_MAX_EXPORT_BATCH_SIZE. |
| --otel_bsp_max_queue_size | См. переменную OTEL_BSP_MAX_QUEUE_SIZE. |
| --otel_bsp_schedule_delay | См. переменную OTEL_BSP_SCHEDULE_DELAY. |
| --otel_exporter_otlp_traces_certificates | В настоящее время не используется. Зарезервировано для будущей разработки. |
| --otel_exporter_otlp_traces_client_certificates | В настоящее время не используется. Зарезервировано для будущей разработки. |
| --otel_exporter_otlp_traces_client_key | В настоящее время не используется. Зарезервировано для будущей разработки. |
| --otel_exporter_otlp_traces_compression | Тип сжатия |
| --otel_exporter_otlp_traces_endpoint | Конечная точка экспорта трассировки |
| --otel_exporter_otlp_traces_headers | Ключевые пары значений, используемые в качестве заголовков, связанных с HTTP-запросами |
| --otel_exporter_otlp_traces_protocol | Протокол передачи OTLP |
| --otel_exporter_otlp_traces_timeout | Время ожидания экспортера OLTP для каждого пакетного экспорта |
| --otel-help | При включении выводит справку о параметрах telemetry_client. |
| --otel_log_level | Управляет выводом журналов opentelemetry в журналы сервера |
| --otel_resource_attributes | См. соответствующую переменную OpenTelemetry OTEL_RESOURCE_ATTRIBUTES. |
| --otel-trace | Данная системная переменная управляет сбором трассировок телеметрии. |
-
Формат командной строки --otel-traceТип Boolean Значение по умолчанию ONУправляет сбором трассировки телеметрии.
-
Формат командной строки --otel-helpТип Boolean Значение по умолчанию OFFПри включении выводит справку по параметрам telemetry_client.
-
Формат командной строки --otel_log_levelТип Enumeration Значение по умолчанию ERRORДопустимые значения ERRORSILENTWARNINGINFODEBUGУправляет тем, какие логи OpenTelemetry выводятся в журналы сервера.
-
Формат командной строки --otel_resource_attributesТип String Значение по умолчанию См. соответствующую переменную OpenTelemetry OTEL_RESOURCE_ATTRIBUTES.
-
otel_exporter_otlp_traces_protocolФормат командной строки --otel_exporter_otlp_traces_protocolТип Enumeration Значение по умолчанию http/protobufДопустимые значения http/protobufhttp/jsonПротокол транспорта OTLP
-
otel_exporter_otlp_traces_endpointФормат командной строки --otel_exporter_otlp_traces_endpointТип String Значение по умолчанию http://localhost:4318/v1/tracesЦелевой URL, на который экспортер отправляет трассировки.
-
otel_exporter_otlp_traces_certificatesФормат командной строки --otel_exporter_otlp_traces_certificatesТип String Значение по умолчанию Доверенный сертификат, используемый при проверке TLS-удостоверений сервера.
-
otel_exporter_otlp_traces_client_keyФормат командной строки --otel_exporter_otlp_traces_client_keyТип String Значение по умолчанию Закрытый ключ клиента в формате PEM.
-
otel_exporter_otlp_traces_client_certificatesФормат командной строки --otel_exporter_otlp_traces_client_certificatesТип String Значение по умолчанию Сертификат/цепь доверия клиента для закрытого ключа клиента в формате PEM.
-
otel_exporter_otlp_traces_headersФормат командной строки --otel_exporter_otlp_traces_headersТип String Значение по умолчанию См. соответствующую переменную OpenTelemetry OTEL_EXPORTER_TRACES_HEADERS.
-
otel_exporter_otlp_traces_compressionФормат командной строки --otel_exporter_otlp_traces_compressionТип String Значение по умолчанию noneДопустимые значения nonegzipСжатие, используемое экспортером.
-
otel_exporter_otlp_traces_timeoutФормат командной строки --otel_exporter_otlp_traces_timeoutТип Integer Значение по умолчанию 10000Время ожидания экспортера OLTP для каждого пакетного экспорта.
-
Формат командной строки --otel_bsp_schedule_delayТип Integer Значение по умолчанию 5000Интервал задержки между двумя последовательными экспортами в миллисекундах.
-
Формат командной строки --otel_bsp_max_queue_sizeТип Integer Значение по умолчанию 2048Максимальный размер очереди.
-
otel_bsp_max_export_batch_sizeФормат командной строки --otel_bsp_max_export_batch_sizeТип Integer Значение по умолчанию 512Максимальный размер пакета.
Пример конфигурации клиента
Ниже приведен пример файла конфигурации my.cnf, содержащего конфигурацию плагина Client Telemetry:
[mysql]
telemetry-client = ON
[telemetry_client]
help = ON
trace = OFF
otel-resource-attributes = "RK1=RV1, RK2=RV2, RK3=RV3"
otel-log-level = "error"
otel-exporter-otlp-traces-headers = "K1=V1, K2=V2"
otel-exporter-otlp-traces-protocol = "http/json"
Если telemetry-client = ON установлен в файле конфигурации, вам не нужно указывать --telemetry-client при запуске клиента.
© 2025 Oracle
Licensed under the GPLv2 License.
