第 10 章 启用并配置 Data Grid OpenTelemetry 追踪
Data Grid 生成与 OpenTelemetry 标准兼容的追踪,允许您导出、视觉化和分析与最重要的缓存操作相关的追踪数据。
10.1. 配置数据网格追踪
配置 OpenTelemetry 追踪,以启用缓存操作的监控和追踪。
流程
- 打开 Data Grid 配置以进行编辑。
-
将
tracing
元素或对象添加到缓存容器。 -
使用
collector_endpoint
属性或字段定义 OpenTelemetry 收集器的端点 URL。启用追踪是必需的。4318
通常是http/protobuf
OTLP 标准端口。 -
使用
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
目录中。