Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/grafana/tempo

Grafana Tempo is a high volume, minimal dependency distributed tracing backend.
https://github.com/grafana/tempo

distributed-tracing grafana

Last synced: about 1 month ago
JSON representation

Grafana Tempo is a high volume, minimal dependency distributed tracing backend.

Lists

README 

        
Tempo Logo




  Latest Release

  License

  

  Slack

  Community Forum

  Go Report Card




Grafana Tempo is an open source, easy-to-use and high-scale distributed tracing backend. Tempo is cost-efficient, requiring only object storage to operate, and is deeply integrated with Grafana, Prometheus, and Loki.



Tempo is Jaeger, Zipkin, Kafka, OpenCensus and OpenTelemetry compatible.  It ingests batches in any of the mentioned formats, buffers them and then writes them to Azure, GCS, S3 or local disk.  As such it is robust, cheap and easy to operate!



Tempo implements [TraceQL](https://grafana.com/docs/tempo/latest/traceql/), a traces-first query language inspired by LogQL and PromQL. This query language allows users to very precisely and easily select spans and jump directly to the spans fulfilling the specified conditions:



Tempo Screenshot



## Getting Started



- [Get started documentation](https://grafana.com/docs/tempo/latest/getting-started/)

- [Deployment Examples](./example)

  - [Docker Compose](./example/docker-compose)

  - [Helm](./example/helm)

  - [Jsonnet](./example/tk)



## Further Reading



To learn more about Tempo, consult the following documents & talks:



- [New in Grafana Tempo 2.0: Apache Parquet as the default storage format, support for TraceQL][tempo_20_announce]

- [Get to know TraceQL: A powerful new query language for distributed tracing][traceql-post]



[tempo_20_announce]: https://grafana.com/blog/2023/02/01/new-in-grafana-tempo-2.0-apache-parquet-as-the-default-storage-format-support-for-traceql/

[traceql-post]: https://grafana.com/blog/2023/02/07/get-to-know-traceql-a-powerful-new-query-language-for-distributed-tracing/



## Getting Help



If you have any questions or feedback regarding Tempo:



- Grafana Labs hosts a [forum](https://community.grafana.com/c/grafana-tempo/40) for Tempo. This is a great place to post questions and search for answers.

- Ask a question on the [Tempo Slack channel](https://grafana.slack.com/archives/C01D981PEE5).

- [File an issue](https://github.com/grafana/tempo/issues/new/choose) for bugs, issues and feature suggestions.

- UI issues should be filed with [Grafana](https://github.com/grafana/grafana/issues/new/choose).



## OpenTelemetry



Tempo's receiver layer, wire format and storage format are all based directly on [standards](https://github.com/open-telemetry/opentelemetry-proto) and [code](https://github.com/open-telemetry/opentelemetry-collector) established by [OpenTelemetry](https://opentelemetry.io/).  We support open standards at Grafana!



Check out the [Integration Guides](https://grafana.com/docs/tempo/latest/guides/instrumentation/) to see examples of OpenTelemetry instrumentation with Tempo.



## Other Components



### tempo-vulture

[tempo-vulture](https://github.com/grafana/tempo/tree/main/cmd/tempo-vulture) is Tempo's bird themed consistency checking tool.  It writes traces to Tempo and then queries them back in a variety of ways.



### tempo-cli

[tempo-cli](https://github.com/grafana/tempo/tree/main/cmd/tempo-cli) is the place to put any utility functionality related to Tempo. See [Documentation](https://grafana.com/docs/tempo/latest/operations/tempo_cli/) for more info.



## License



Grafana Tempo is distributed under [AGPL-3.0-only](LICENSE). For Apache-2.0 exceptions, see [LICENSING.md](LICENSING.md).