open-telemetry/opentelemetry-demo

This repository contains the OpenTelemetry Astronomy Shop, a microservice-based distributed system intended to illustrate the implementation of OpenTelemetry in a near real-world environment.

TypeScript

3,397

2,303 commits

updated Oct 8, 2026

See the code

README

OTel logo OpenTelemetry Demo

Slack Version Commits Downloads License Telemetry Tests Artifact Hub FOSSA Status FOSSA Status OpenSSF Scorecard for opentelemetry-demo OpenSSF Best Practices

Welcome to the OpenTelemetry Astronomy Shop Demo

This repository contains the OpenTelemetry Astronomy Shop, a microservice-based distributed system intended to illustrate the implementation of OpenTelemetry in a near real-world environment.

Our goals are threefold:

  • Provide a realistic example of a distributed system that can be used to demonstrate OpenTelemetry instrumentation and observability.
  • Build a base for vendors, tooling authors, and others to extend and demonstrate their OpenTelemetry integrations.
  • Create a living example for OpenTelemetry contributors to use for testing new versions of the API, SDK, and other components or enhancements.

We've already made huge progress, and development is ongoing. We hope to represent the full feature set of OpenTelemetry across its languages in the future.

If you'd like to help (which we would love), check out our contributing guidance.

If you'd like to extend this demo or maintain a fork of it, read our fork guidance.

Quick start

You can be up and running with the demo in a few minutes. Check out the docs for your preferred deployment method:

Documentation

For detailed documentation, see Demo Documentation. If you're curious about a specific feature, the docs landing page can point you in the right direction.

Demos featuring the Astronomy Shop

We welcome any vendor to fork the project to demonstrate their services and adding a link below. The community is committed to maintaining the project and keeping it up to date for you.

Contributing

To get involved with the project see our CONTRIBUTING documentation. Our SIG Calls are every other Wednesday at 8:30 AM PST and anyone is welcome.

New to CNCF Slack? Create an account first, then join us in #otel-community-demo.

Maintainers

For more information about the maintainer role, see the community repository.

Approvers

For more information about the approver role, see the community repository.

Emeritus

For more information about the emeritus role, see the community repository.

Thanks to all the people who have contributed

contributors

demo
jaeger
opentelemetry
opentelemetry-collector
opentelemetry-dotnet
opentelemetry-erlang
opentelemetry-go
opentelemetry-java-agent
opentelemetry-javascript
opentelemetry-python
opentelemetry-rust
prometheus

open-telemetry/opentelemetry-demo

This repository contains the OpenTelemetry Astronomy Shop, a microservice-based distributed system intended to illustrate the implementation of OpenTelemetry in a near real-world environment.

TypeScript

3,397

2,303 commits

updated Oct 8, 2026

See the code

README

OTel logo OpenTelemetry Demo

Slack Version Commits Downloads License Telemetry Tests Artifact Hub FOSSA Status FOSSA Status OpenSSF Scorecard for opentelemetry-demo OpenSSF Best Practices

Welcome to the OpenTelemetry Astronomy Shop Demo

This repository contains the OpenTelemetry Astronomy Shop, a microservice-based distributed system intended to illustrate the implementation of OpenTelemetry in a near real-world environment.

Our goals are threefold:

  • Provide a realistic example of a distributed system that can be used to demonstrate OpenTelemetry instrumentation and observability.
  • Build a base for vendors, tooling authors, and others to extend and demonstrate their OpenTelemetry integrations.
  • Create a living example for OpenTelemetry contributors to use for testing new versions of the API, SDK, and other components or enhancements.

We've already made huge progress, and development is ongoing. We hope to represent the full feature set of OpenTelemetry across its languages in the future.

If you'd like to help (which we would love), check out our contributing guidance.

If you'd like to extend this demo or maintain a fork of it, read our fork guidance.

Quick start

You can be up and running with the demo in a few minutes. Check out the docs for your preferred deployment method:

Documentation

For detailed documentation, see Demo Documentation. If you're curious about a specific feature, the docs landing page can point you in the right direction.

Demos featuring the Astronomy Shop

We welcome any vendor to fork the project to demonstrate their services and adding a link below. The community is committed to maintaining the project and keeping it up to date for you.

Contributing

To get involved with the project see our CONTRIBUTING documentation. Our SIG Calls are every other Wednesday at 8:30 AM PST and anyone is welcome.

New to CNCF Slack? Create an account first, then join us in #otel-community-demo.

Maintainers

For more information about the maintainer role, see the community repository.

Approvers

For more information about the approver role, see the community repository.

Emeritus

For more information about the emeritus role, see the community repository.

Thanks to all the people who have contributed

contributors

demo
jaeger
opentelemetry
opentelemetry-collector
opentelemetry-dotnet
opentelemetry-erlang
opentelemetry-go
opentelemetry-java-agent
opentelemetry-javascript
opentelemetry-python
opentelemetry-rust
prometheus

Project health

Overall

8.2/10

Maintained

10/10

Code review

10/10

Contributors

10/10
OpenSSF Scorecard

Significant stargazers

(top 24 of 36)

Paul Balogh

118 followers · starred Feb 2023

Gregor Zeitlinger

40 followers · starred Feb 2024

Tim Deschryver

815 followers · starred Oct 2022

Paweł Krupa

247 followers · starred Jun 2022