Skip to content

teletrace/teletrace

Logo

Slack Version Commits Merge Queue Docs Go Report Contributors License

⭐️ Why Teletrace?

Teletrace is an open-source distributed tracing system that helps developers monitor and troubleshoot complex distributed systems by providing end-to-end transaction monitoring and tracing across various microservices. Teletrace is built from the ground up for modern applications. It relies on open standards like OpenTelemetry. It is an easy-to-deploy scalable solution, that supports multiple storage options.

✨ Features

  • Advanced search to pinpoint slow and failing requests.
  • Visualize requests to understand their context in your application.
  • Track user requests and data across your application.

πŸ–Ό Demo

To learn more, please visit our demo GitHub project and try open telemetry demo on your own machine.

πŸ“š Table of contents

πŸš€ Getting started

Requirements

Using Docker

Using docker-compose:

curl https://raw.githubusercontent.com/teletrace/teletrace/main/deploy/docker-compose/teletrace-otel-collector.yaml > teletrace-otel-collector.yaml && \
curl https://raw.githubusercontent.com/teletrace/teletrace/main/deploy/docker-compose/docker-compose.yml > docker-compose.yml && \
docker-compose up

Alternatively, using docker CLI:

curl https://raw.githubusercontent.com/teletrace/teletrace/main/teletrace-otelcol/config/all-in-one-config.yaml > all-in-one-config.yaml && \
docker run \
    -v $(pwd)/all-in-one-config.yaml:/etc/config.yaml \
    -p 8080:8080 \
    -p 4317:4317 \
    -p 4318:4318 \
    teletrace/teletrace:latest \
    --config /etc/config.yaml

Using Helm Chart

To install the Helm chart, follow the steps outlined in this guide to ensure a smooth installation process.

Alternatively, visit our helm chart repo.

πŸ’¬ Community

Join our Slack for questions, support and fun.

Start with our Documentation for quick tutorials and examples.

If you need direct support you can contact us at teletrace@cisco.com.

πŸ‘¨β€πŸ’» Contribution

Contributions are welcome!

Start by reviewing the contribution guidelines. After that, take a look at a good first issue.

Contributors

Thank you to all the people who already contributed to Teletrace ❀️

❗ Code of conduct

We take our community seriously and we are dedicated to providing a safe and welcoming environment for everyone. Please take a few minutes to review our Code of Conduct.

πŸͺͺ License

Copyright (c) Cisco Systems, Inc. Apache 2.0 License.