Skip to main content

Jaeger

Jaeger is an open-source, end-to-end distributed tracing tool that originated from Uber. It helps monitor and troubleshoot microservices-based applications.

Databend has the ability to export tracing data to Jaeger by integrating with the OpenTelemetry SDK. The following tutorial shows you how to deploy and use Jaeger to trace Databend.

Tutorial: Trace Databend with Jaeger​

Step 1. Deploy Jaeger​

This tutorial uses the All In One image to deploy Jaeger in Docker. If you already have a running Jaeger instance, you can skip this step.

docker run -d -p6831:6831/udp -p6832:6832/udp -p16686:16686 jaegertracing/all-in-one:latest

Step 2. Set Environment Variables​

Set the following environment variables according to your actual tracing level requirements and Jaeger endpoint.

- `RUST_LOG`: Sets the log level.
- `DATABEND_JAEGER_AGENT_ENDPOINT`: Sets the endpoint the Jaeger agent is listening on.
export RUST_LOG=DEBUG
export DATABEND_JAEGER_AGENT_ENDPOINT=localhost:6831

Step 3. Deploy Databend​

  1. Follow the Deployment Guide to deploy Databend.

  2. Run the following SQL statements:

CREATE TABLE t1(a INT);
INSERT INTO t1 VALUES(1);
INSERT INTO t1 SELECT * FROM t1;

Step 4. Check Tracing Information on Jaegar​

  1. Go to http://127.0.0.1:16686/ and select the Search tab.

  2. Select a service in the Service drop-down list. For example, select the databend-query service.

  3. Click Find Traces to show the traces.