21.6. 相关选项

log-console-include-trace

在控制台日志中包括追踪信息。

如果指定了 log-console-format 选项，这个选项无效。

CLI: --log-console-include-trace
Env: KC_LOG_CONSOLE_INCLUDE_TRACE

仅在激活 Console 日志处理程序和 Tracing 时可用

true （默认），false

log-file-include-trace

在文件日志中包含追踪信息。

如果指定了 log-file-format 选项，这个选项无效。

CLI: --log-file-include-trace
Env: KC_LOG_FILE_INCLUDE_TRACE

仅在激活文件日志处理程序和跟踪时才可用

true （默认），false

log-syslog-include-trace

在 Syslog 中包含追踪信息。

如果指定了 log-syslog-format 选项，这个选项无效。

CLI: --log-syslog-include-trace
Env: KC_LOG_SYSLOG_INCLUDE_TRACE

仅在激活 Syslog 处理程序和 Tracing 时可用

true （默认），false

tracing-compression

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

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

CLI: --tracing-compression
Env: KC_TRACING_COMPRESSION

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

gzip，none （默认）

启用了追踪的 wagon

Preview ：启用 OpenTelemetry 追踪。

CLI: --tracing-enabled
Env: KC_TRACING_ENABLED

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

true,false （默认）

tracing-endpoint

Preview ：要连接到的 OpenTelemetry 端点。

CLI: --tracing-endpoint
Env: KC_TRACING_ENDPOINT

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

http://localhost:4317 (default)

tracing-jdbc-enabled wagon

Preview ：启用 OpenTelemetry JDBC 追踪。

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

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

true （默认），false

tracing-protocol

预览：用于遥测数据的 OpenTelemetry 协议。

CLI: --tracing-protocol
Env: KC_TRACING_PROTOCOL

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

gRPC （默认），http/protobuf

tracing-resource-attributes

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

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

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

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

tracing-sampler-ratio

Preview: OpenTelemetry sampler 比率。

跨度的概率将被抽样。预期为 <0,1）的双值。

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

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

1.0 （默认）

tracing-sampler-type wagon

Preview ：用于追踪的 OpenTelemetry sampler。

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

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

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

tracing-service-name

Preview: OpenTelemetry 服务名称。

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

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

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

Keycloak （默认）