MySQL 8.4 Reference Manual  /  ...  /  Configuring TRACE Telemetry

35.2.1 遥测配置

本节描述了服务器和客户端的配置。

以下是服务器遥测配置变量：

表35.1 遥测变量总结

Name Cmd-Line Option File System Var Status Var Var Scope Dynamic
telemetry.live_sessions 是 全局 否
telemetry.metrics_reader_frequency_1 是 全局 否
telemetry.metrics_reader_frequency_2 是 全局 否
telemetry.metrics_reader_frequency_3 是 全局 否
telemetry.otel_bsp_max_export_batch_size 是 全局 否
telemetry.otel_bsp_max_queue_size 是 全局 否
telemetry.otel_bsp_schedule_delay 是 全局 否
telemetry.otel_exporter_otlp_metrics_certificates 是 全局 否
telemetry.otel_exporter_otlp_metrics_cipher 是 全局 否
telemetry.otel_exporter_otlp_metrics_cipher_suite 是 全局 否
telemetry.otel_exporter_otlp_metrics_client_certificates 是 全局 否
telemetry.otel_exporter_otlp_metrics_client_key 是 全局 否
telemetry.otel_exporter_otlp_metrics_compression 是 全局 否
telemetry.otel_exporter_otlp_metrics_endpoint 是 全局 否
telemetry.otel_exporter_otlp_metrics_headers 是 全局 否
telemetry.otel_exporter_otlp_metrics_max_tls 是 全局 否
telemetry.otel_exporter_otlp_metrics_min_tls 是 全局 否
telemetry.otel_exporter_otlp_metrics_protocol 是 全局 否
telemetry.otel_exporter_otlp_metrics_timeout 是 全局 否
telemetry.otel_exporter_otlp_traces_certificates 是 全局 否
telemetry.otel_exporter_otlp_traces_cipher 是 全局 否
telemetry.otel_exporter_otlp_traces_cipher_suite 是 全局 否
telemetry.otel_exporter_otlp_traces_client_certificates 是 全局 否
telemetry.otel_exporter_otlp_traces_client_key 是 全局 否
telemetry.otel_exporter_otlp_traces_compression 是 全局 否
telemetry.otel_exporter_otlp_traces_endpoint 是 全局 否
telemetry.otel_exporter_otlp_traces_headers 是 全局 否
telemetry.otel_exporter_otlp_traces_max_tls 是 全局 否
telemetry.otel_exporter_otlp_traces_min_tls 是 全局 否
telemetry.otel_exporter_otlp_traces_protocol 是 全局 否
telemetry.otel_exporter_otlp_traces_timeout 是 全局 否
telemetry.otel_log_level 是 全局 telemetry.trace_enabled
telemetry.otel_resource_attributes telemetry.trace_enabled Global No
telemetry.query_text_enabled Yes Global Yes
telemetry.trace_enabled Yes Global Yes

MySQL 客户端从配置文件的 [telemetry_client] 部分读取遥测配置。有关 telemetry_client 选项的信息，请参阅Installing Client Plugin。以下配置选项可用：

Table 35.2 mysql client Telemetry Option Summary

Option Name Description
--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 trace 导出端点
--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 该系统变量控制是否收集telemetry 跟踪。

  • trace

    Command-Line Format --otel-trace
    Type 布尔值
    Default Value ON

    控制是否收集telemetry 跟踪。

  • help

    Command-Line Format --otel-help
    Type 布尔值
    Default Value OFF

    启用时，打印telemetry_client选项的帮助信息。

  • otel_log_level

    Command-Line Format --otel_log_level
    Type 枚举
    Default Value ERROR
    Valid Values

    ERROR

    SILENT

    WARNING

    INFO

    DEBUG

    控制服务器日志中显示的OpenTelemetry日志

  • otel_resource_attributes

    Command-Line Format --otel_resource_attributes
    Type 字符串
    Default Value

    请参阅相应的OpenTelemetry变量 OTEL_RESOURCE_ATTRIBUTES。

  • otel_exporter_otlp_traces_protocol

    Command-Line Format --otel_exporter_otlp_traces_protocol
    Type 枚举
    Default Value http/protobuf
    Valid Values

    http/protobuf

    http/json

    OTLP传输协议

  • otel_exporter_otlp_traces_endpoint

    Command-Line Format --otel_exporter_otlp_traces_endpoint
    Type 字符串
    Default Value http://localhost:4318/v1/traces

    将跟踪发送到目标URL

  • otel_exporter_otlp_traces_certificates

    Command-Line Format --otel_exporter_otlp_traces_certificates
    Type 字符串
    Default Value

    当前暂不使用。用于将来开发。

  • otel_exporter_otlp_traces_client_key

    Command-Line Format --otel_exporter_otlp_traces_client_key
    Type 字符串
    Default Value

    当前暂不使用。用于将来开发。

  • otel_exporter_otlp_traces_client_certificates

    Command-Line Format --otel_exporter_otlp_traces_client_certificates
    Type 字符串
    Default Value

    当前暂不使用。用于将来开发。

  • otel_exporter_otlp_traces_headers

    Command-Line Format --otel_exporter_otlp_traces_headers
    Type 字符串
    Default Value

    请查看对应的OpenTelemetry变量 OTEL_EXPORTER_TRACES_HEADERS。

  • otel_exporter_otlp_traces_compression

    Command-Line Format --otel_exporter_otlp_traces_compression
    Type 字符串
    Default Value none
    Valid Values

    none

    gzip

    导出器使用的压缩方式

  • otel_exporter_otlp_traces_timeout

    Command-Line Format --otel_exporter_otlp_traces_timeout
    Type 整数
    Default Value 10000

    OLTP 导出器等待每批导出

  • otel_bsp_schedule_delay

    Command-Line Format --otel_bsp_schedule_delay
    Type 整数
    Default Value 5000

    延迟时间（毫秒）

  • otel_bsp_max_queue_size

    Command-Line Format --otel_bsp_max_queue_size
    Type 整数
    Default Value 2048

    队列最大大小

  • otel_bsp_max_export_batch_size

    Command-Line Format --otel_bsp_max_export_batch_size
    Type 整数
    Default Value 512

    批处理最大大小

以下是一个使用 Client Telemetry 插件的 my.cnf 配置文件的示例：

[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。


PREV   HOME   UP   NEXT
Related Documentation
MySQL 8.4 Release Notes
Download this Manual
PDF (US Ltr) - 39.8Mb
PDF (A4) - 39.9Mb
Man Pages (TGZ) - 257.9Kb
Man Pages (Zip) - 364.9Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb