Skip to main content

Go 配置说明

使用下表中的环境变量来配置。

全局设置（Global settings）

环境变量	描述	默认值
`OTEL_GO_AUTO_TARGET_EXE`	设置要检测的 Go 应用程序的二进制文件。此变量是必需的。	Unset
`OTEL_GO_AUTO_GLOBAL`	记录来自 OpenTelemetry 默认全局实现的遥测数据。作为使用环境变量的替代方法，您可以使用 `-global-impl` CLI 标志。	`false`
`OTEL_LOG_LEVEL`	设置日志级别。支持的值: `none`, `error`, `warn`, `info`, `debug`。作为使用环境变量的替代方法, 您可以使用-logLevel CLI 标志。	`info`

资源（Resources）

环境变量	描述	默认值
`OTEL_SERVICE_NAME`	设置 `service.name` 资源属性的值。如果 OTEL_RESOURCE_ATTRIBUTES 中提供了 `service.name` ，则 OTEL_SERVICE_NAME 的值优先。
`OTEL_RESOURCE_ATTRIBUTES`	用作资源属性的键值对。

Instrumentation options

环境变量	描述	默认值
`OTEL_GO_AUTO_INCLUDE_DB_STATEMENT`	设置是否在跟踪数据中包含 SQL 查询。
`OTEL_GO_AUTO_PARSE_DB_STATEMENT`	设置是否解析 SQL 语句以获取跟踪数据，设置 `db.operation.name`。仅在以下情况下有效`OTEL_GO_AUTO_INCLUDE_DB_STATEMENT` 也被设定.

Traces exporter

环境变量	描述	默认值
`OTEL_TRACES_EXPORTER`	支持的导出器类型: `otlp`, `console`, `logging`, `none`, 详细信息请参阅OpenTelemetry 规范。	`otlp`
`OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`	允许的最大属性值大小。	No limit
`OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT`	允许的最大跨度属性计数。	`128`
`OTEL_SPAN_LINK_COUNT_LIMIT`	允许的最大跨度链接计数。	`128`
`OTEL_LINK_ATTRIBUTE_COUNT_LIMIT`	每个跨度链接计数允许的最大属性。	`128`

OTLP exporter

环境变量	描述	默认值
`OTEL_EXPORTER_OTLP_PROTOCOL`	定义 OTLP 导出器的传输协议。支持的值：`grpc`、`http/protobuf`。	`http/protobuf`
`OTEL_EXPORTER_OTLP_TRACES_PROTOCOL`	定义 OTLP 导出器的追踪信号传输协议。支持的值：`grpc`、`http/protobuf`。此环境变量的值优先于 `OTEL_EXPORTER_OTLP_PROTOCOL`。	`http/protobuf`
`OTEL_EXPORTER_OTLP_ENDPOINT`	导出器发送遥测数据的端点。该值必须包含主机，还可以包含端口、协议和路径。您可以使用 `http` 或 `https`。该值不能包含查询字符串或片段。	http/protobuf: `https://localhost:54318`, grpc: `http://localhost:54317`
`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`	导出器发送遥测数据的端点。该值必须包含主机，还可以包含端口、协议和路径。您可以使用 `http` 或 `https`。该值不能包含查询字符串或片段。此环境变量的值优先于 `OTEL_EXPORTER_OTLP_ENDPOINT`。	http/protobuf: `https://localhost:54318/v1/traces`, grpc: `http://localhost:54317`
`OTEL_EXPORTER_OTLP_INSECURE`	禁用导出器 gRPC 连接的客户端传输安全。仅当提供的端点不包含 `http` 或 `https` 协议时才可使用。	`false`
`OTEL_EXPORTER_OTLP_TRACES_INSECURE`	禁用导出器 gRPC 连接的客户端传输安全。仅当提供的端点不包含 `http` 或 `https` 协议时才可使用。此变量的值优先于 `OTEL_EXPORTER_OTLP_INSECURE`。	`false`
`OTEL_EXPORTER_OTLP_HEADERS`	用作 gRPC 请求关联的 gRPC 元数据的键值对。该值必须采用与 W3C Baggage HTTP 标头内容格式匹配的格式，但不支持额外的分号分隔元数据。示例值：`"key1=value1,key2=value2"`。	Unset
`OTEL_EXPORTER_OTLP_TRACES_HEADERS`	用作 gRPC 请求关联的 gRPC 元数据的键值对。该值必须采用与 W3C Baggage HTTP 标头内容格式匹配的格式，但不支持额外的分号分隔元数据。示例值：`"key1=value1,key2=value2"`。此变量的值优先于 `OTEL_EXPORTER_OTLP_HEADERS`。	Unset
`OTEL_EXPORTER_OTLP_TIMEOUT`	OTLP 导出器等待每批导出的最长时间（毫秒）。	`10000`
`OTEL_EXPORTER_OTLP_TRACES_TIMEOUT`	OTLP 导出器等待每批导出的最长时间（毫秒）。此变量的值优先于 `OTEL_EXPORTER_OTLP_TIMEOUT`。	`10000`
`OTEL_EXPORTER_OTLP_COMPRESSION`	导出器使用的 gRPC 压缩器。支持的值：`gzip`、`none`。	Unset
`OTEL_EXPORTER_OTLP_TRACES_COMPRESSION`	导出器使用的 gRPC 压缩器。支持的值：`gzip`、`none`。此变量的值优先于 `OTEL_EXPORTER_OTLP_COMPRESSION`。	Unset
`OTEL_EXPORTER_OTLP_CERTIFICATE`	用于验证服务器 TLS 凭据的受信任证书的文件路径。	Unset
`OTEL_EXPORTER_OTLP_TRACES_CERTIFICATE`	用于验证服务器 TLS 凭据的受信任证书的文件路径。此变量的值优先于 `OTEL_EXPORTER_OTLP_CERTIFICATE`。	Unset
`OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`	用于 mTLS 通信的客户端证书或客户端私钥信任链的文件路径（PEM 格式）。	Unset
`OTEL_EXPORTER_OTLP_TRACES_CLIENT_CERTIFICATE`	用于 mTLS 通信的客户端证书或客户端私钥信任链的文件路径（PEM 格式）。此变量的值优先于 `OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE`。	Unset
`OTEL_EXPORTER_OTLP_CLIENT_KEY`	用于 mTLS 通信的客户端私钥文件路径（PEM 格式）。	Unset
`OTEL_EXPORTER_OTLP_TRACES_CLIENT_KEY`	用于 mTLS 通信的客户端私钥文件路径（PEM 格式）。此变量的值优先于 `OTEL_EXPORTER_OTLP_CLIENT_KEY`。	Unset

全局设置（Global settings）
资源（Resources）
Instrumentation options
Traces exporter
OTLP exporter