GitHub

What is the project about?

The project, docker-otel-lgtm, provides a pre-configured OpenTelemetry backend packaged as a Docker image. It's designed for development, demonstration, and testing purposes.

What problem does it solve?

It simplifies setting up an observability backend for OpenTelemetry, allowing developers to quickly get started with collecting and visualizing telemetry data (logs, metrics, and traces) without complex configuration. It also allows easy data forwarding to external vendors.

What are the features of the project?

  • Includes pre-configured components: OpenTelemetry Collector, Prometheus, Tempo, Loki, and Grafana.
  • Easy to run with provided scripts (run-lgtm.sh, run-lgtm).
  • Optional logging for troubleshooting individual components.
  • Ability to forward data to external vendors (like Grafana Cloud) using OTEL_EXPORTER_OTLP_ENDPOINT and OTEL_EXPORTER_OTLP_HEADERS.
  • Option to persist data across container restarts by mounting a volume to /data.
  • Kubernetes deployment support.
  • Works out-of-the-box with OpenTelemetry's default settings.
  • Includes example applications in various languages (Java, Go, Python, .NET) to demonstrate telemetry data generation.

What are the technologies used in the project?

  • Docker
  • OpenTelemetry
  • Prometheus
  • Tempo
  • Loki
  • Grafana
  • Kubernetes (optional)
  • Example apps: Java, Go, Python, .NET

What are the benefits of the project?

  • Simplified setup for OpenTelemetry backend.
  • Faster development and testing of OpenTelemetry-instrumented applications.
  • Easy visualization of telemetry data with Grafana.
  • Flexibility to forward data to different backends.
  • Provides a self-contained environment for demos and workshops.

What are the use cases of the project?

  • Local development and testing of applications instrumented with OpenTelemetry.
  • Demonstrating OpenTelemetry concepts and capabilities.
  • Evaluating different observability backends.
  • Workshops and training sessions on OpenTelemetry.
  • Quickly setting up a temporary observability stack for troubleshooting.
docker-otel-lgtm screenshot