Teletrace

<div align="center">

</div> <div align="center">

</div> <h3 align="center"> <a href="https://docs.teletrace.io/"><b>📝 Explore the docs</b></a> &bull; <a href="https://join.slack.com/t/teletrace/shared_invite/zt-1qv0kogcn-KlbBB2yS~gUCGszZoSpJfQ"><b>💬 Join Our Slack</b></a> &bull; <a href="https://github.com/teletrace/teletrace/issues/new?assignees=&labels=&template=bug_report.md&title="><b>🐛 Report Bug</b></a> &bull; <a href="https://github.com/teletrace/teletrace/issues/new?assignees=&labels=&template=feature_request.md&title="><b>✨ Request Feature</b></a> </h3>

⭐️ 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

<img src="./website/docs/assets/demo.gif" min-width="100%" min-height="100%"/>

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

📚 Table of contents

• Features
• Demo
• Getting Started
• Contribution
• Community
• Code of Conduct
• License

🚀 Getting started

Requirements

• Docker

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.

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.