Setting up a demo Java app and collecting telemetry

Install Git and Java suitable for your OS. Here is an example:

sudo apt update
sudo apt install -y git openjdk-25-jdk

Set the environment variables for the Monium connection:

export MONIUM_API_KEY=<API_key>
export MONIUM_PROJECT=<project_ID>
export MONIUM_CLUSTER=<cluster_name> # optional

Clone and build Spring PetClinic:

git clone https://github.com/spring-projects/spring-petclinic
cd spring-petclinic
./mvnw -DskipTests package

Download the OpenTelemetry Java agent:

curl -L -o opentelemetry-javaagent.jar \
https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jar

Configure telemetry export settings:

export OTEL_EXPORTER_OTLP_PROTOCOL="grpc"
export OTEL_EXPORTER_OTLP_ENDPOINT="https://ingest.monium.yandex.cloud:443"
export OTEL_EXPORTER_OTLP_HEADERS="x-monium-project=${MONIUM_PROJECT},x-monium-cluster=${MONIUM_CLUSTER},authorization=Api-Key ${MONIUM_API_KEY}"
export OTEL_SERVICE_NAME=spring-petclinic

Optionally, enable delta temporality for metrics:

export OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE="delta"

Run the application with the Java agent:

java -javaagent:./opentelemetry-javaagent.jar -jar target/*.jar

Open Spring PetClinic at http://localhost:8080 and simulate user actions. Metrics are created the first time the relevant functions are called.

On the Monium home page, select Shards on the left.

In the list, select the shard with your service name.

The shard name follows the <project_name>_<cluster_name>_<service_name> format, e.g., folder__b1g86q4m5vej********_default_spring-petclinic.

To view a specific data type, on the left, select:

• Metrics.

  In the query string, select project, cluster, and service one by one and click Execute query.

  Example of a chart with metrics

  

  Learn more about using metrics.

• Logs.

  In the query string, select project, cluster, and service one by one and click Execute query.

  Example of a page with logs

  

  Learn more on how to use logs.

• Traces.

  In the query string, select project and service one by one and click Execute.

  Example of a page with traces

  

  Learn more on how to use traces.