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.
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. - Grafana 7.4.x
Uses tempo-query to allow for querying from Grafana 7.4 and before.
These examples show off configuration of different storage backends:
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 thegrafana/tempo:latest image that is used in all the examples:
make docker-images