Edit

Trace Exporters

Tracing exporters are responsible for passing the recorded tracing data to a corresponding storage.

inspectIT Ocelot currently supports the following trace exporters:

• Logging (Traces) [Homepage]
• OTLP (Traces) [Homepage]
• Zipkin [Homepage]
• Jaeger (Removed, use OTLP instead) [Homepage]

Important note: Starting with version 2.0.0, inspectIT Ocelot moved from OpenCensus to OpenTelemetry. As a result, the OpenCensus Agent Exporter is no longer supported and has been removed.
Additionally, with OpenTelemetry, inspectIT Ocelot does not support the service-name property for individual exporter services anymore. Thus, we removed the service-name property from the tracing exporters. This property can now be set for all trace exporters in inspectit.exporters.tracing.service-name.

General Trace Exporter Settings

These settings apply to all trace exporters and can set below the inspectit.exporters.tracing property.

Property	Default	Description
.service-name	${inspectit.service-name}	The value of this property will be used to identify the service a trace came from. Please note that changes of this property only take effect after restarting the agent.

Logging Exporter (Traces)

The Logging exporter exports traces to the system log. By default, the Logging exporter is disabled. The following properties are nested properties below the inspectit.exporters.tracing.logging property:

Property	Default	Description
.enabled	DISABLED	If ENABLED or IF_CONFIGURED, the agent will try to start the Logging trace exporter.

To make inspectIT Ocelot write the spans to the system log, the following JVM property can be used:

-Dinspectit.exporters.tracing.logging.enabled=ENABLED

OTLP Exporter (Traces)

The OpenTelemetry Protocol (OTLP) exporters export the Traces in OTLP to the desired endpoint at a specified interval. By default, the OTLP exporters are enabled but the URL endpoint needed for the exporter to actually start is set to null.

The following properties are nested properties below the inspectit.exporters.tracing.otlp property:

Property	Default	Description
.enabled	IF_CONFIGURED	If ENABLED or IF_CONFIGURED, the inspectIT Ocelot agent will try to start the OTLP gRPC trace exporter.
.endpoint	null	Target to which the exporter is going to send traces, e.g. http://localhost:4317
.protocol	null	The transport protocol, see OTEL documentation. Supported protocols are grpc and http/protobuf.
.headers	null	Key-value pairs to be used as headers associated with gRPC or HTTP requests, see OTEL documentation.
.compression	NONE	The compression method, see OTEL documentation. Supported compression methods are gzip and none.
.timeout	10s	Maximum time the OTLP exporter will wait for each batch export, see OTEL documentation.

To make inspectIT Ocelot push the spans via OTLP to, e.g. an OpenTelemetry Collector running on the same machine as the agent, the following JVM property can be used:

-Dinspectit.exporters.tracing.otlp.endpoint=http://127.0.0.1:4317
-Dinspectit.exporters.tracing.otlp.protocol=grpc

Zipkin Exporter

The Zipkin exporter exports Traces in Zipkin v2 format to a Zipkin server or other compatible servers.

By default, the Zipkin exporter is enabled but the URL needed for the exporter to actually start is set to null.

The following properties are nested properties below the inspectit.exporters.tracing.zipkin property:

Property	Default	Description
.enabled	IF_CONFIGURED	If ENABLED or IF_CONFIGURED, the agent will try to start the Zipkin exporter. If the url is not set, it will log a warning if set to ENABLED but fail silently if set to IF_CONFIGURED.
.endpoint	null	v2 URL under which the ZipKin server can be accessed (e.g. http://127.0.0.1:9411/api/v2/spans).

To make inspectIT Ocelot push the spans to a Zipkin server running on the same machine as the agent, the following JVM property can be used:

-Dinspectit.exporters.tracing.zipkin.url=http://127.0.0.1:9411/api/v2/spans

Jaeger Exporter (Removed)

This exporter was removed. Please use the OTLP exporter instead.