Add Jaeger to docker compose. (#56)

Make it easier to view the Otel trace when developing Terrarium.
terrariumcloud · Nov 30, 2023 · 8a8deb8 · 8a8deb8
1 parent dcc19b4
commit 8a8deb8
Show file tree

Hide file tree

Showing 2 changed files with 27 additions and 8 deletions.
diff --git a/docker-compose.yaml b/docker-compose.yaml
@@ -8,7 +8,7 @@ services:
      - AWS_ACCESS_KEY_ID
      - AWS_SECRET_ACCESS_KEY
      - AWS_DEFAULT_REGION
-     - OTEL_EXPORTER_OTLP_ENDPOINT
+     - OTEL_EXPORTER_OTLP_ENDPOINT=jaeger:4317
     ports:
       - 50001:3001
     networks:
@@ -29,7 +29,7 @@ services:
      - AWS_ACCESS_KEY_ID
      - AWS_SECRET_ACCESS_KEY
      - AWS_DEFAULT_REGION
-     - OTEL_EXPORTER_OTLP_ENDPOINT
+     - OTEL_EXPORTER_OTLP_ENDPOINT=jaeger:4317
     ports:
       - 50002:3001
     networks:
@@ -50,7 +50,7 @@ services:
      - AWS_ACCESS_KEY_ID
      - AWS_SECRET_ACCESS_KEY
      - AWS_DEFAULT_REGION
-     - OTEL_EXPORTER_OTLP_ENDPOINT
+     - OTEL_EXPORTER_OTLP_ENDPOINT=jaeger:4317
     ports:
       - 50006:3001
     networks:
@@ -73,7 +73,7 @@ services:
      - AWS_ACCESS_KEY_ID
      - AWS_SECRET_ACCESS_KEY
      - AWS_DEFAULT_REGION
-     - OTEL_EXPORTER_OTLP_ENDPOINT
+     - OTEL_EXPORTER_OTLP_ENDPOINT=jaeger:4317
     ports:
       - 50008:3001
     networks:
@@ -94,7 +94,7 @@ services:
      - AWS_ACCESS_KEY_ID
      - AWS_SECRET_ACCESS_KEY
      - AWS_DEFAULT_REGION
-     - OTEL_EXPORTER_OTLP_ENDPOINT
+     - OTEL_EXPORTER_OTLP_ENDPOINT=jaeger:4317
     ports:
       - 50003:3001
     networks:
@@ -115,7 +115,7 @@ services:
      - AWS_ACCESS_KEY_ID
      - AWS_SECRET_ACCESS_KEY
      - AWS_DEFAULT_REGION
-     - OTEL_EXPORTER_OTLP_ENDPOINT
+     - OTEL_EXPORTER_OTLP_ENDPOINT=jaeger:4317
     ports:
       - 50004:3001
     networks:
@@ -136,7 +136,7 @@ services:
      - AWS_ACCESS_KEY_ID
      - AWS_SECRET_ACCESS_KEY
      - AWS_DEFAULT_REGION
-     - OTEL_EXPORTER_OTLP_ENDPOINT
+     - OTEL_EXPORTER_OTLP_ENDPOINT=jaeger:4317
     ports:
       - 50005:3001
     networks:
@@ -157,7 +157,7 @@ services:
     - AWS_ACCESS_KEY_ID
     - AWS_SECRET_ACCESS_KEY
     - AWS_DEFAULT_REGION
-    - OTEL_EXPORTER_OTLP_ENDPOINT
+    - OTEL_EXPORTER_OTLP_ENDPOINT=jaeger:4317
     ports:
       - 50007:3001
     networks:
@@ -170,6 +170,16 @@ services:
       - "$AWS_SECRET_ACCESS_KEY"
       - "--aws-region"
       - "$AWS_DEFAULT_REGION"
+  jaeger:
+    image: jaegertracing/all-in-one:1
+    container_name: jaeger
+    ports:
+      - 16686:16686
+      - 4317:4317
+      - 4318:4318
+    networks:
+      - terrarium
+
 networks:
   terrarium:
     name: terrarium
diff --git a/docs/opentelemetry.md b/docs/opentelemetry.md
@@ -0,0 +1,9 @@
+# OpenTelemetry
+Terrarium is instrumented with OpenTelemetry to allow monitoring of the operations for diagnosing problems and collecting information on usage.
+For more information on OpenTelemetry see [here](https://opentelemetry.io/).
+
+The docker compose file includes, for development a [Jaeger](https://www.jaegertracing.io/) all-in-one container to allow you to monitor traces. 
+To access the Jaeger UI goto http://localhost:16686
+
+The jaeger container also exposes port 4317 (OTLP grpc) and 4318 (OTLP http) to the host to make it easy to push traces 
+into Jaeger when you're developing/debugging outside the docker network.