/docker-otel-lgtm

Primary LanguageDockerfileApache License 2.0Apache-2.0

docker-otel-lgtm

An OpenTelemetry backend in a Docker image.

Components included in the Docker image: OpenTelemetry collector, Prometheus, Tempo, Loki, Grafana

The grafana/otel-lgtm Docker image is an open source backend for OpenTelemetry that’s intended for development, demo, and testing environments. If you are looking for a production-ready, out-of-the box solution to monitor applications and minimize MTTR (mean time to resolution) with OpenTelemetry and Prometheus, you should try Grafana Cloud Application Observability.

Documentation

Get the Docker image

The Docker image is available on Docker hub: https://hub.docker.com/r/grafana/otel-lgtm

Run the Docker image

./run-lgtm.sh

Run lgtm in kubernetes

# create k8s resources
kubectl apply -f k8s/lgtm.yaml

# port forwarding
kubectl port-forward service/lgtm 3000:3000 4317:4317 4318:4318

Send OpenTelemetry Data

There's no need to configure anything: The Docker image works with OpenTelemetry's defaults.

# Not needed as these are the defaults in OpenTelemetry:
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

View Grafana

Log in to http://localhost:3000 with user admin and password admin.

Build the Docker image from scratch

cd docker/
docker build . -t grafana/otel-lgtm

Build and run the example app

Run the example REST service:

./run-example.sh

Generate traffic:

./generate-traffic.sh

Run example apps in different languages

The example apps are in the examples/ directory. Each example has a run.sh script to start the app.

Every example implements a rolldice service, which returns a random number between 1 and 6.

Each example uses a different application port (to be able to run all applications at the same time).

Example Service URL
Java curl http://localhost:8080/rolldice
Go curl http://localhost:8081/rolldice
Python curl http://localhost:8082/rolldice
dotnet curl http://localhost:8083/rolldice

Related Work