So you found your way to the docker compose examples? This is a great place to get started with Tempo, learn some basic configuration and learn about various trace discovery flows.
See our getting-started docs for more detail.
If you are interested in more complex configuration we would recommend the tanka/jsonnet examples.
The easiest example to start with is Local Storage: this example will run Tempo as a single binary together with the synthetic-load-generator, to generate traces, and Grafana, to query Tempo. Data is stored locally on disk.
The following examples showcase specific features or integrations:
- Grafana Agent
Simple example using the Grafana Agent as a tracing pipeline. - OpenTelemetry Collector
Simple example using the OpenTelemetry Collector as a tracing pipeline. - OpenTelemetry Collector Multitenant
Uses the OpenTelemetry Collector in an advanced multitenant configuration.
This example uses the local backend, suitable for local testing and development:
This step is not necessary, but it can be nice for local testing. For any of the above examples rebuilding these images will cause docker compose to use your local code when running the examples.
Run the following from the project root folder to build the grafana/tempo:latest image that is used in all the examples:
make docker-images