https://github.com/jmix-framework/jmix-observability-tracing-sample
https://github.com/jmix-framework/jmix-observability-tracing-sample
Last synced: 6 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/jmix-framework/jmix-observability-tracing-sample
- Owner: jmix-framework
- Created: 2025-09-07T14:25:24.000Z (7 months ago)
- Default Branch: release_2_6
- Last Pushed: 2025-09-07T14:31:57.000Z (7 months ago)
- Last Synced: 2025-09-07T16:26:08.181Z (7 months ago)
- Language: Java
- Size: 7.17 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Jmix Observability Tracing Sample
This project is part of the **Jmix Observability Guide Series** and demonstrates how to implement distributed tracing across multiple Jmix applications.
The goal of the guide series is to showcase how Jmix applications can be monitored, traced, and analyzed using modern, open-source observability tooling. This includes the use of OpenTelemetry as the standard telemetry transport protocol and the Grafana stack (Grafana, Tempo) as the target platform.
In this example, we use two Jmix applications – the Petclinic backend and the Petclinic Portal frontend – which interact with each other and generate distributed traces. The trace data is centrally collected using OpenTelemetry and visualized in Grafana for end-to-end request tracking across services.
Learn more in the full guide: [Observability: Distributed Tracing](https://docs.jmix.io/jmix/observability-tracing-guide).
---
## Build the JAR Files
Before starting the applications using Docker Compose, you need to build the JAR files.
### Build petclinic (backend)
```bash
./gradlew -Pvaadin.productionMode=true --include-build jmix-petclinic-2 :jmix-petclinic-2:clean :jmix-petclinic-2:bootJar -x test --no-build-cache
```
### Build petclinic-portal (frontend)
```bash
./gradlew -Pvaadin.productionMode=true --include-build jmix-petclinic-portal :jmix-petclinic-portal:clean :jmix-petclinic-portal:bootJar -x test --no-build-cache
```
Once the JARs are built, Docker Compose will pick them up and copy them into the containers using the provided Dockerfiles.
## Start the Applications
To run both applications along with the observability stack (PostgreSQL, Loki, Grafana, etc.), use the provided Docker Compose configuration:
```bash
docker compose -f docker/docker-compose.yaml up --build -d
```
To stop all applications use the following command:
```bash
docker compose -f docker/docker-compose.yaml down
```