williewheeler/otel-demo

OpenTelemetry demo involving multiple microservices and Jaeger tracing

otel-demo

OpenTelemetry auto-instrumentation demo. It features a microservices-based travel app and Jaeger running inside a Docker Compose environment.

Blog post: Auto-instrumentation with OpenTelemetry

Windows setup

Do the following from an elevated command shell:

1. Install the Chocolatey package manager.
2. Install OpenJDK: choco install openjdk.
3. Install Make: choco install make.
4. Install Docker Desktop for Windows: choco install docker-desktop. There's some setup, too:
   • You'll need to decide whether you want to use WSL 2 (Linux) or else Hyper-V as a Docker backend. I recommend WSL 2, as it has better performance. Either way, you'll need to restart your computer.
   • If you chose Hyper-V, go to Docker Desktop > Settings > Resources, and give yourself 8 GB of memory.
5. Optional: If you want to play around with the app itself, install Visual Studio Code: choco install vscode. Include Java support, and install the Docker and Lombok extensions too. The Docker extension will make it easier to view container logs and shell into containers.

Build

From the top of the project directory, build the app and the Docker images using a single command:

$ make

Run

To start up all the containers, it's just:

$ docker-compose up

Endpoints

• Sample app:
  • UI: http://localhost:8080
  • API: http://localhost:8081
  • Provider 1:
    • API: http://localhost:8082
    • DB: mysql://localhost:3306
  • Provider 2:
    • API: http://localhost:8083
    • DB: mysql://localhost:3307
• Jaeger UI: http://localhost:16686

To try it out, just hit the sample app UI a few times, and then look at the traces in Jaeger.