Setting up a demo Java app and collecting telemetry

Written by

Yandex Cloud

Updated at March 24, 2026

Getting started
Setting up a demo app and telemetry delivery
Viewing telemetry in Monium

Getting started

Navigate to the management console and log in to Yandex Cloud or create a new account.
On the Yandex Cloud Billing page, make sure you have a billing account linked and it has the ACTIVE or TRIAL_ACTIVE status. If you do not have a billing account, create one and link a cloud to it.

If you have an active billing account, you can create or select a folder for your infrastructure on the cloud page.

Learn more about clouds and folders here.

Setting up a demo app and telemetry delivery

In this example, you will install Spring PetClinic and set up sending telemetry data to Monium.

Your infrastructure

Install Git and Java suitable for your OS. Here is an example:
```
sudo apt update
sudo apt install -y git openjdk-17-jdk
```

Download and install OTel Collector suitable for your OS. Here is an example:

wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v144.0/otelcol-linux_amd64.tar.gz
tar xvf otelcol-linux_amd64.tar.gz

Set these environment variables:

export MONIUM_PROJECT=folder__<folder_ID>
export MONIUM_API_KEY=<API_key>

Create a file named stream_put_record.py and paste the following code to it:

receivers:
  otlp:
    protocols:
      grpc:
      http:

exporters:
  otlp_grpc/monium:
    compression: zstd
    endpoint: ingest.monium.yandex.cloud:443
    headers:
      Authorization: "Api-Key ${env:MONIUM_API_KEY}"
      x-monium-project: "${env:MONIUM_PROJECT}"
    sending_queue:
      batch:

service:
  pipelines:
    metrics:
      receivers: [ otlp ]
      exporters: [ otlp_grpc/monium ]
    traces:
      receivers: [ otlp ]
      exporters: [ otlp_grpc/monium ]
    logs:
      receivers: [ otlp ]
      exporters: [ otlp_grpc/monium ]
  telemetry:
    metrics:
      level: normal
      readers:
        - periodic:
            exporter:
              otlp:
                protocol: http/protobuf
                endpoint: http://localhost:4318
            interval: 30000
            timeout: 5000

Run OTel Collector:
```
./otelcol-linux_amd64 --config otel-collector.yaml
```
It will start listening on ports 4317 (gRPC) and 4318 (HTTP).

Download 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

Run the application with the Java agent to send telemetry to OTel Collector:

OTEL_SERVICE_NAME=spring-petclinic \
OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE="delta" \
java -javaagent:./opentelemetry-javaagent.jar -jar target/*.jar

Open the Spring PetClinic website at http://localhost:8080 and simulate user actions.

Viewing telemetry in Monium

Monium UI

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.

Setting up a demo Java app and collecting telemetry

Getting startedGetting started

Setting up a demo app and telemetry deliverySetting up a demo app and telemetry delivery

Viewing telemetry in MoniumViewing telemetry in Monium

Was the article helpful?

Getting started

Setting up a demo app and telemetry delivery

Viewing telemetry in Monium