红帽全球峰会Chapter 10. Enabling and configuring Data Grid OpenTelemetry tracing
Data Grid generates tracing spans compatible with the OpenTelemetry standard, allowing you to export, visualize, and analyze tracing data related to the most important cache operations.
10.1. Enabling Data Grid tracing
Configure OpenTelemetry tracing, to enable monitoring and tracing of cache operations.
Procedure
Pass the system properties to Data Grid Server at startup.
Use
-D<property-name>=<property-value>arguments like in the following example:bin/server.sh -Dinfinispan.tracing.enabled=true -Dotel.traces.exporter=otlp -Dotel.service.name=my-infinispan-server -Dotel.exporter.otlp.endpoint=http://otlp-collector-host:4318
bin/server.sh -Dinfinispan.tracing.enabled=true -Dotel.traces.exporter=otlp -Dotel.service.name=my-infinispan-server -Dotel.exporter.otlp.endpoint=http://otlp-collector-host:4318Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Next steps
To apply any configuration changes, stop the server and repeat the procedure.
Tracing configuration
Data Grid applies the tracing configuration globally to all caches.
tracing.properties
infinispan.tracing.enabled = true otel.traces.exporter = otlp otel.service.name = <my-infinispan-server> otel.exporter.otlp.endpoint = http://otlp-collector-host:4318
infinispan.tracing.enabled = true
otel.traces.exporter = otlp
otel.service.name = <my-infinispan-server>
otel.exporter.otlp.endpoint = http://otlp-collector-host:4318 - 1
- Enables tracing for all cache operations.
- 2
- Sets the exporter format. The OTLP (OpenTelemetry protocol) exporter is the recommended format to export tracing data.
- 3
- Specifies the service name associated with the generated tracing spans. The default name is
Infinispan Server. - 4
- Specifies the endpoint URL of the OpenTelemetry collector where the tracing data is sent.
4318is typically thehttp/protobufOTLP standard port.
Tracing data format
The Data Grid Server, by default, exports tracing data using the OTLP http/protobuf protocol.
tracing.properties
otel.exporter.otlp.protocol = http/protobuf
otel.exporter.otlp.protocol = http/protobuf
To use a different protocol, you must copy JAR files or dependencies to the $ISPN_HOME/server/lib directory of your Data Grid Server installation.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}