第 10 章 启用并配置 Data Grid OpenTelemetry 追踪
Data Grid 生成与 OpenTelemetry 标准兼容的追踪,允许您导出、视觉化和分析与最重要的缓存操作相关的追踪数据。
10.1. 配置数据网格追踪 复制链接链接已复制到粘贴板!
配置 OpenTelemetry 追踪,以启用缓存操作的监控和追踪。
流程
- 打开 Data Grid 配置以进行编辑。
-
将
tracing元素或对象添加到缓存容器。 -
使用
collector_endpoint属性或字段定义 OpenTelemetry 收集器的端点 URL。启用追踪是必需的。4318通常是http/protobufOTLP 标准端口。 -
使用
enable属性或字段全局启用或禁用追踪。 -
使用
security属性或字段启用或禁用安全事件追踪。 -
(可选)更改追踪导出器协议更改
exporter_protocol属性或字段。默认情况下,它是otlp(OpenTelemetry 协议)。 -
(可选)更改与生成的追踪范围关联的追踪服务名称,更改
service_name属性或字段。默认情况下,它是infinispan-server。 - 保存并关闭您的客户端配置。
后续步骤
要应用任何全局追踪配置更改,请停止服务器并重复这个过程。
追踪配置
Data Grid 在全局范围内对所有缓存应用追踪配置。
XML
<infinispan>
<cache-container statistics="true">
<tracing collector-endpoint="http://localhost:4318"
enabled="true"
exporter-protocol="OTLP"
service-name="infinispan-server"
security="false" />
</cache-container>
</infinispan>
JSON
{
"infinispan" : {
"cache-container" : {
"statistics" : true,
"tracing" : {
"collector-endpoint" : "http://localhost:4318",
"enabled" : true,
"exporter-protocol" : "OTLP",
"service-name" : "infinispan-server",
"security" : false
}
}
}
}
YAML
infinispan:
cacheContainer:
statistics: true
tracing:
collector-endpoint: "http://localhost:4318"
enabled: true
exporter-protocol: "OTLP"
service-name: "infinispan-server"
security: false
10.1.1. 进一步跟踪选项 复制链接链接已复制到粘贴板!
要配置进一步追踪选项,可以在启动时将系统属性或设置环境变量传递给 Data Grid 服务器,以直接配置 OpenTelemetry SDK Autoconfigure,供 Data Grid 服务器用来配置 OpenTelemetry 追踪。
流程
在启动时将系统属性传递给 Data Grid 服务器。
use
-D<property-name>=<property-value> 参数,如下例所示:bin/server.sh -Dotel.exporter.otlp.timeout=10000
追踪数据格式
默认情况下,Data Grid 服务器使用 OTLP http/protobuf 协议导出追踪数据。
tracing.properties
otel.exporter.otlp.protocol = http/protobuf
要使用不同的协议,您必须将 JAR 文件或依赖项复制到 Data Grid Server 安装的 $ISPN_HOME/server/lib 目录中。