21.14. Tracing

tracing-compression

OpenTelemetry 压缩方法用于压缩有效负载。

如果未设置，则禁用压缩。

CLI: --tracing-compression
Env: KC_TRACING_COMPRESSION

仅在启用 Tracing 时可用

gzip，none （默认）

启用了追踪的 wagon

启用 OpenTelemetry 追踪。

CLI: --tracing-enabled
Env: KC_TRACING_ENABLED

仅在启用 'opentelemetry' 功能时才可用

true,false （默认）

tracing-endpoint

要连接的 OpenTelemetry 端点。

CLI: --tracing-endpoint
Env: KC_TRACING_ENDPOINT

仅在启用 Tracing 时可用

http://localhost:4317 (default)

tracing-jdbc-enabled 🛠

启用 OpenTelemetry JDBC 追踪。

CLI: --tracing-jdbc-enabled
Env: KC_TRACING_JDBC_ENABLED

仅在启用 Tracing 时可用

true （默认），false

tracing-protocol

OpenTelemetry 协议用于遥测数据。

CLI: --tracing-protocol
Env: KC_TRACING_PROTOCOL

仅在启用 Tracing 时可用

grpc (default), http/protobuf

tracing-resource-attributes

OpenTelemetry 资源属性存在于导出的 trace 中，以特征遥测制作者。

格式为 key1=val1,key2=val2 的值。如需更多信息，请参阅跟踪指南。

CLI: --tracing-resource-attributes
Env: KC_TRACING_RESOURCE_ATTRIBUTES

仅在启用 Tracing 时可用

tracing-sampler-ratio

OpenTelemetry sampler 比率。

跨度的概率将被抽样。预期的双值（间隔为 [0,1]）。

CLI: --tracing-sampler-ratio
Env: KC_TRACING_SAMPLER_RATIO

仅在启用 Tracing 时可用

1.0 （默认）

tracing-sampler-type 🛠

OpenTelemetry sampler 用于追踪。

CLI: --tracing-sampler-type
Env: KC_TRACING_SAMPLER_TYPE

仅在启用 Tracing 时可用

always_on,always_off,traceidratio (default), parentbased_always_on,parentbased_always_off,parentbased_traceidratio

tracing-service-name

OpenTelemetry 服务名称。

优先于 tracing-resource-attributes 属性中定义的 service.name。

CLI: --tracing-service-name
Env: KC_TRACING_SERVICE_NAME

仅在启用 Tracing 时可用

Keycloak （默认）