35.3.1 Configuring Trace Telemetry

35.3.1 Trace Telemetry 구성

이 섹션은 서버와 클라이언트의 구성을 설명합니다.

• Server Configuration
• Client Configuration
• Client Configuration Example

Server Configuration

다음은 서버 trace telemetry 구성 변수들입니다:

• telemetry.trace_enabled

Property	Value
System Variable	telemetry.trace_enabled
Scope	Global
Dynamic	Yes
SET_VAR Hint Applies	No
Type	Boolean
Default Value	OFF

telemetry trace를 수집할지 여부를 제어합니다.

• telemetry.query_text_enabled

Property	Value
System Variable	telemetry.query_text_enabled
Scope	Global
Dynamic	Yes
SET_VAR Hint Applies	No
Type	Boolean
Default Value	ON

SQL 쿼리 텍스트를 trace에 포함할지 여부를 제어합니다.

• telemetry.otel_log_level

Property	Value
System Variable	telemetry.otel_log_level
Scope	Global
Dynamic	Yes
SET_VAR Hint Applies	No
Type	Enumeration
Default Value	ERROR
Valid Values	SILENT<br>INFO<br>ERROR<br>WARNING<br>DEBUG

어떤 OpenTelemetry 로그를 서버 로그에 출력할지 제어합니다.

• telemetry.otel_resource_attributes

Property	Value
System Variable	telemetry.otel_resource_attributes
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	String
Default Value	empty

해당 OpenTelemetry 변수 OTEL_RESOURCE_ATTRIBUTES를 참조하십시오.

• telemetry.otel_exporter_otlp_traces_protocol

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_protocol
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	Enumeration
Default Value	http/protobuf
Valid Values	http/protobuf<br>http/json

OTLP 전송 프로토콜입니다.

• telemetry.otel_exporter_otlp_traces_endpoint

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_endpoint
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	String
Default Value	``

exporter가 trace를 전송하는 대상 URL입니다.

• telemetry.otel_exporter_otlp_traces_network_namespace

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_network_namespace
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	String
Default Value	[none]

(Linux 전용) trace endpoint로 데이터를 전송할 때 사용할 네트워크 네임스페이스입니다.

• telemetry.otel_exporter_otlp_traces_certificates

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_certificates
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	String
Default Value	``

서버의 TLS 크리덴셜을 검증할 때 사용할 신뢰할 수 있는 인증서입니다.

• telemetry.otel_exporter_otlp_traces_client_key

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_client_key
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	String
Default Value	``

클라이언트의 개인 키(PEM 포맷)입니다.

• telemetry.otel_exporter_otlp_traces_client_certificates

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_client_certificates
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	String
Default Value	``

클라이언트 개인 키에 대한 클라이언트 인증서/체인 트러스트(PEM 포맷)입니다.

• telemetry.otel_exporter_otlp_traces_headers

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_headers
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	String
Default Value	empty

해당 OpenTelemetry 변수 OTEL_EXPORTER_TRACES_HEADERS를 참조하십시오.

• telemetry.otel_exporter_otlp_traces_secret_headers

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_secret_headers
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	String
Default Value	[none]

trace 헤더에 대한 민감한 데이터를 포함하는 시크릿의 이름입니다. 데이터 내용과 포맷은 시스템 변수 telemetry.secret_provider와 함께 제공되는 시크릿 프로바이더 구현에 따라 달라집니다.

• telemetry.otel_exporter_otlp_traces_compression

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_compression
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	String
Default Value	none (no compression)
Valid Values	none (no compression)<br>gzip

exporter가 사용하는 압축입니다.

• telemetry.otel_exporter_otlp_traces_timeout

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_timeout
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	Integer
Default Value	10000
Unit	milliseconds

OLTP exporter가 각 배치 export를 위해 대기하는 시간(밀리초)입니다.

• telemetry.otel_bsp_schedule_delay

Property	Value
System Variable	telemetry.otel_bsp_schedule_delay
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	Integer
Default Value	5000
Unit	milliseconds

두 번의 연속된 export 사이의 지연 간격(밀리초)입니다.

• telemetry.otel_bsp_max_queue_size

Property	Value
System Variable	telemetry.otel_bsp_max_queue_size
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	Integer
Default Value	2048

최대 큐 크기입니다.

• telemetry.otel_bsp_max_export_batch_size

Property	Value
System Variable	telemetry.otel_bsp_max_export_batch_size
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	Integer
Default Value	512

최대 배치 크기입니다.

• telemetry.otel_exporter_otlp_traces_min_tls

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_min_tls
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	Enumeration
Default Value	[none]
Valid Values	[none]<br>1.2<br>1.3

• telemetry.otel_exporter_otlp_traces_max_tls

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_max_tls
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	Enumeration
Default Value	[none]
Valid Values	[none]<br>1.2<br>1.3

• telemetry.otel_exporter_otlp_traces_cipher

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_cipher
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	String
Default Value	[none]

trace에 사용할 TLS 1.2 cipher의 현재 목록입니다. 현재 기본값은 다음과 같습니다:

1ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:
2ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:
3ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-CCM:ECDHE-ECDSA-AES128-CCM:
4DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-CCM:
5DHE-RSA-AES128-CCM:DHE-RSA-CHACHA20-POLY1305

• telemetry.otel_exporter_otlp_traces_cipher_suite

Property	Value
System Variable	telemetry.otel_exporter_otlp_traces_cipher_suite
Scope	Global
Dynamic	No
SET_VAR Hint Applies	No
Type	String
Default Value	[none]

trace에 사용할 TLS 1.3 cipher의 현재 목록입니다. 현재 기본값은 다음과 같습니다:

1TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_CCM_SHA256

Client Configuration

MySQL 클라이언트는 구성 파일의 [telemetry_client] 섹션에서 telemetry 구성을 읽습니다. telemetry_client 옵션에 대한 정보는 Installing Client Plugin을 참조하십시오. 사용 가능한 구성 옵션은 다음과 같습니다:

Table 35.2 mysql client Telemetry Option Summary

Option Name	Description
--telemetry_client	telemetry 클라이언트를 활성화합니다.
--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 export 엔드포인트
--otel_exporter_otlp_traces_headers	HTTP 요청과 연관된 헤더로 사용할 key-value 쌍
--otel_exporter_otlp_traces_protocol	OTLP 전송 프로토콜
--otel_exporter_otlp_traces_timeout	OLTP exporter가 각 배치 export를 위해 대기하는 시간
--otel-help	활성화되면 telemetry_client 옵션에 대한 help를 출력합니다.
--otel_log_level	어떤 OpenTelemetry 로그를 서버 로그에 출력할지 제어합니다.
--otel_resource_attributes	해당 OpenTelemetry 변수 OTEL_RESOURCE_ATTRIBUTES를 참조하십시오.
--otel-trace	이 시스템 변수는 telemetry trace를 수집할지 여부를 제어합니다.

Option Name	Description

• trace

Property	Value
Command-Line Format	--otel-trace
Type	Boolean
Default Value	ON

telemetry trace를 수집할지 여부를 제어합니다.

• help

Property	Value
Command-Line Format	--otel-help
Type	Boolean
Default Value	OFF

활성화되면 telemetry_client 옵션에 대한 help를 출력합니다.

• otel_log_level

Property	Value
Command-Line Format	--otel_log_level
Type	Enumeration
Default Value	ERROR
Valid Values	ERROR<br>SILENT<br>WARNING<br>INFO<br>DEBUG

어떤 OpenTelemetry 로그를 서버 로그에 출력할지 제어합니다.

• otel_resource_attributes

Property	Value
Command-Line Format	--otel_resource_attributes
Type	String
Default Value	``

해당 OpenTelemetry 변수 OTEL_RESOURCE_ATTRIBUTES를 참조하십시오.

• otel_exporter_otlp_traces_protocol

Property	Value
Command-Line Format	--otel_exporter_otlp_traces_protocol
Type	Enumeration
Default Value	http/protobuf
Valid Values	http/protobuf<br>http/json

OTLP 전송 프로토콜입니다.

• otel_exporter_otlp_traces_endpoint

Property	Value
Command-Line Format	--otel_exporter_otlp_traces_endpoint
Type	String
Default Value	http://localhost:4318/v1/traces

exporter가 trace를 전송하는 대상 URL입니다.

• otel_exporter_otlp_traces_certificates

Property	Value
Command-Line Format	--otel_exporter_otlp_traces_certificates
Type	String
Default Value	``

서버의 TLS 크리덴셜을 검증할 때 사용할 신뢰할 수 있는 인증서입니다.

• otel_exporter_otlp_traces_client_key

Property	Value
Command-Line Format	--otel_exporter_otlp_traces_client_key
Type	String
Default Value	``

클라이언트의 개인 키(PEM 포맷)입니다.

• otel_exporter_otlp_traces_client_certificates

Property	Value
Command-Line Format	--otel_exporter_otlp_traces_client_certificates
Type	String
Default Value	``

클라이언트 개인 키에 대한 클라이언트 인증서/체인 트러스트(PEM 포맷)입니다.

• otel_exporter_otlp_traces_headers

Property	Value
Command-Line Format	--otel_exporter_otlp_traces_headers
Type	String
Default Value	``

해당 OpenTelemetry 변수 OTEL_EXPORTER_TRACES_HEADERS를 참조하십시오.

• otel_exporter_otlp_traces_compression

Property	Value
Command-Line Format	--otel_exporter_otlp_traces_compression
Type	String
Default Value	none
Valid Values	none<br>gzip

exporter가 사용하는 압축입니다.

• otel_exporter_otlp_traces_timeout

Property	Value
Command-Line Format	--otel_exporter_otlp_traces_timeout
Type	Integer
Default Value	10000

OLTP exporter가 각 배치 export를 위해 대기하는 시간입니다.

• otel_bsp_schedule_delay

Property	Value
Command-Line Format	--otel_bsp_schedule_delay
Type	Integer
Default Value	5000

두 번의 연속된 export 사이의 지연 간격(밀리초)입니다.

• otel_bsp_max_queue_size

Property	Value
Command-Line Format	--otel_bsp_max_queue_size
Type	Integer
Default Value	2048

최대 큐 크기입니다.

• otel_bsp_max_export_batch_size

Property	Value
Command-Line Format	--otel_bsp_max_export_batch_size
Type	Integer
Default Value	512

최대 배치 크기입니다.

Client Configuration Example

다음은 Client Telemetry 플러그인 구성을 포함하는 my.cnf 구성 파일의 예입니다:

1[mysql]
2
3telemetry-client = ON
4
5[telemetry_client]
6help = ON
7trace = OFF
8otel-resource-attributes = "RK1=RV1, RK2=RV2, RK3=RV3"
9otel-log-level = "error"
10otel-exporter-otlp-traces-headers = "K1=V1, K2=V2"
11otel-exporter-otlp-traces-protocol = "http/json"

구성 파일에 telemetry-client = ON이 설정되어 있으면 클라이언트를 시작할 때 --telemetry-client를 지정할 필요가 없습니다.