Spec-Zone.ru › MySQL 9.2

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

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

  • Настройка сервера

  • Настройка клиента

  • Пример конфигурации клиента

Настройка сервера

Ниже приведены переменные конфигурации телеметрии трассировки сервера:

  • telemetry.trace_enabled

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

    Управляет сбором телеметрических трассировок.

  • telemetry.query_text_enabled

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

    Управляет включением текста SQL-запроса в трассировку.

  • telemetry.otel_log_level

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

    SILENT

    INFO

    ERROR

    WARNING

    DEBUG

    Управляет тем, какие логи OpenTelemetry выводятся в логи сервера.

  • telemetry.otel_resource_attributes

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

    См. соответствующую переменную OpenTelemetry OTEL_RESOURCE_ATTRIBUTES.

  • telemetry.otel_exporter_otlp_traces_protocol

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

    http/protobuf

    http/json

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

  • telemetry.otel_exporter_otlp_traces_endpoint

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

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

  • telemetry.otel_exporter_otlp_traces_certificates

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

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

  • telemetry.otel_exporter_otlp_traces_client_key

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

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

  • telemetry.otel_exporter_otlp_traces_client_certificates

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

    Доверенный сертификат/цепь сертификатов для закрытого ключа клиента в формате PEM.

  • telemetry.otel_exporter_otlp_traces_headers

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

    См. соответствующую переменную OpenTelemetry OTEL_EXPORTER_TRACES_HEADERS.

  • telemetry.otel_exporter_otlp_traces_compression

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

    none (no compression)

    gzip

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

  • telemetry.otel_exporter_otlp_traces_timeout

    Системная переменная telemetry.otel_exporter_otlp_traces_timeout
    Область видимости Глобальная
    Динамическая Нет
    SET_VAR Подсказка применяется Нет
    Тип Целое число
    Значение по умолчанию 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.2

    1.3

  • telemetry.otel_exporter_otlp_traces_max_tls

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

    [none]

    1.2

    1.3

  • telemetry.otel_exporter_otlp_traces_cipher

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

    Текущий список шифров 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_traces_cipher_suite

    Переменная системы telemetry.otel_exporter_otlp_traces_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

Настройка клиента

MySQL клиент считывает настройки телеметрии из раздела [telemetry_client] файла конфигурации. См. Установка плагина клиента для информации об опции telemetry_client. Доступны следующие параметры конфигурации:

Таблица 35.2 Краткое описание параметров телеметрии клиента MySQL

Таблица 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 Данная переменная системы управляет сбором трассировок телеметрии.

  • trace

    Формат командной строки --otel-trace
    Тип Boolean
    Значение по умолчанию ON

    Управляет сбором трассировок телеметрии.

  • help

    Формат командной строки --otel-help
    Тип Boolean
    Значение по умолчанию OFF

    При включении выводит справку по параметрам telemetry_client.

  • otel_log_level

    Формат командной строки --otel_log_level
    Тип Enumeration
    Значение по умолчанию ERROR
    Допустимые значения

    ERROR

    SILENT

    WARNING

    INFO

    DEBUG

    Управляет тем, какие логи OpenTelemetry выводятся в логах сервера.

  • otel_resource_attributes

    Формат командной строки --otel_resource_attributes
    Тип String
    Значение по умолчанию

    См. соответствующую переменную OpenTelemetry OTEL_RESOURCE_ATTRIBUTES.

  • otel_exporter_otlp_traces_protocol

    Формат командной строки --otel_exporter_otlp_traces_protocol
    Тип Enumeration
    Значение по умолчанию http/protobuf
    Допустимые значения

    http/protobuf

    http/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
    Допустимые значения

    none

    gzip

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

  • otel_exporter_otlp_traces_timeout

    Формат командной строки --otel_exporter_otlp_traces_timeout
    Тип Integer
    Значение по умолчанию 10000

    Время ожидания экспортера OLTP для каждого пакетного экспорта.

  • otel_bsp_schedule_delay

    Формат командной строки --otel_bsp_schedule_delay
    Тип Integer
    Значение по умолчанию 5000

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

  • otel_bsp_max_queue_size

    Формат командной строки --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.
https://docs.oracle.com/cd/E17952_01/mysql-9.2-en/telemetry-trace-configuration.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API