Learn about the Wavefront Jaeger Integration.

Jaeger Integration

Jaeger is a popular open-source distributed tracing system. The Wavefront proxy supports the Jaeger Thrift trace data format.

Click the Setup tab for instructions on:

  • Enabling the Wavefront proxy to support the Jaeger Thrift data format.
  • Understanding configuration requirements for Jaeger agents that send trace data to the Wavefront proxy.

The documentation explains integration requirements, how to specify custom tags for RED metrics, custom application names and more.

Jaeger Integration Setup

Jaeger deployments consist of Collectors and Jaeger Agents. The agents can be configured to send trace data to the Wavefront proxy.

Install and Configure the Wavefront Proxy

  1. If you have not already done so, install a Wavefront proxy (version 4.33 or later).
  2. On the host that is running your Wavefront proxy, open the file /etc/wavefront/wavefront-proxy/wavefront.conf and add:
    traceJaegerListenerPorts=<enter-available-port>
    

    Note: See the documentation for the config file location for other platforms.

  3. Save and close wavefront.conf.
  4. Restart the proxy.

Configure the Jaeger Agent to Send Data to the Wavefront Proxy

Host based Jaeger Installation

On your hosts running the Jaeger agent, configure the agent with the following property:

--reporter.tchannel.host-port=<wf_proxy_hostname>:<wf_proxy_jaeger_port>

Replace <wf_proxy_hostname> with the hostname of the Wavefront proxy and <wf_proxy_jaeger_port> with the port you entered above for traceJaegerListenerPorts.

Docker based Jaeger Installation

When running Jaeger agents using docker, add the following to the docker run command:

-e REPORTER_TCHANNEL_HOST_PORT=<wf_proxy_hostname>:<wf_proxy_jaeger_port> -e REPORTER_TYPE=tchannel

Replace <wf_proxy_hostname> with the hostname of the Wavefront proxy and <wf_proxy_jaeger_port> with the port you entered above for traceJaegerListenerPorts.

Note: Replace <wf_proxy_hostname> with the IP address of the docker host if the proxy is running on the same host.

The Wavefront proxy will receive Jaeger trace data once the Jaeger agent has been started with the above property enabled.

Customize Jaeger Integration:

Custom Application Names for Jaeger

You can specify custom application names at the level you need, like this:

  1. Span-level tag: Add the application span tag to all spans.
  2. Process-level tag: Add the application tag as a Jaeger tracer tag, that is, a process tag.
  3. Proxy-level tag: Add traceJaegerApplicationName= in the proxy configuration at /etc/wavefront/wavefront-proxy/wavefront.conf. See [Proxy Configuration Paths](https://docs.wavefront.com/proxies_configuring.html#paths) for details on the config file location.

The order of precedence is span level > process level > proxy level.

The documentation explains integration requirements, how to specify custom tags for RED metrics and more.