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 the relevant data type section on the left:

• Metrics.
• Logs.
• Traces.

At the top, set the data search period on the timeline.

In the search bar, enter a query to search for telemetry data:

• project = <project_ID>: Select the project specified in x-monium-project of the application's telemetry transmission configuration.

  This may be a cloud (cloud__<cloud_ID>) project, folder (folder__<folder_ID>) project, or another project.

• cluster = <cluster_name>: Select the name of the installation that runs your application. If no cluster is specified, cluster = default is used.

• service = <service_name>: Name of your application or service. You can use the OTEL_SERVICE_NAME environment variable to provide it.

  If you do not see the required labels in the suggestions, you can enter them manually. However, the system most likely has not received data with these labels. See Data delivery troubleshooting for possible solutions.

Click Execute query or Execute.

The page will show data that matches the query.

More on metrics.

More on logs.

More on traces.

To view information about the data shard, select Shards on the left and then select the shard with your service name.