The Jaeger exporter converts OpenTelemetry traces into the Jaeger model following the OpenTelemetry specification.
The exporter communicates to a Jaeger Agent through the thrift protocol on the Compact Thrift API port, and as such only supports Thrift over UDP.
This package supports all the officially supported versions of .NET Core.
For .NET Framework, versions 4.6.1 and above are supported.
dotnet add package OpenTelemetry.Exporter.Jaeger
You can configure the JaegerExporter
through JaegerExporterOptions
and environment variables. The JaegerExporterOptions
setters
take precedence over the environment variables.
The JaegerExporter
can be configured using the JaegerExporterOptions
properties:
AgentHost
: The Jaeger Agent host (defaultlocalhost
).AgentPort
: The compact thrift protocol UDP port of the Jaeger Agent (default6831
).MaxPayloadSizeInBytes
: The maximum size of each UDP packet that gets sent to the agent (default4096
).ExportProcessorType
: Whether the exporter should use Batch or Simple exporting processor (defaultExportProcessorType.Batch
).BatchExportProcessorOptions
: Configuration options for the batch exporter. Only used if ExportProcessorType is set to Batch.
See the
TestJaegerExporter.cs
for an example of how to use the exporter.
The following environment variables can be used to override the default
values of the JaegerExporterOptions
.
Environment variable | JaegerExporterOptions property |
---|---|
OTEL_EXPORTER_JAEGER_AGENT_HOST |
AgentHost |
OTEL_EXPORTER_JAEGER_AGENT_PORT |
AgentPort |
FormatException
is thrown in case of an invalid value for any of the
supported environment variables.