Getting started with Monium

In this example, you will install the Spring PetClinic demo app and configure it to send telemetry to Monium.

To install the demo application, you can temporarily create a Yandex Compute Cloud VM. Learn more about creating a suitable VM here.

Below are examples of commands for installing the demo application on Linux Ubuntu.

1. Install Git and Java suitable for your OS. For example:

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

2. Download and install an OTel Collector agent suitable for your OS. For example:

   wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.144.0/otelcol_0.144.0_linux_amd64.tar.gz
   tar xvf otelcol_0.144.0_linux_amd64.tar.gz
   

3. Set environment variables containing data for agent authentication in Monium:

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

   Where:

   • <folder_ID>: ID of the folder to house your Monium project.

   • <api_key>: Service account API key.

     This service account must have the monium.telemetry.writer role or more granular roles to writing metrics, logs, or traces. The API key must have the yc.monium.telemetry.write scope or narrower scopes for writing metrics, logs, or traces.

4. Create a file named otel-collector.yaml and paste the following contents 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
   

5. Run the OTel Collector agent:

   ./otelcol --config otel-collector.yaml
   

   Once active, the agent will start listening on ports 4317 (gRPC) and 4318 (HTTP).

6. Open a new terminal window, then download and build the Spring PetClinic application:

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

   Result:

   ...
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time:  53.308 s
   [INFO] Finished at: 2026-05-05T18:56:22Z
   [INFO] ------------------------------------------------------------------------
   

7. 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
   

8. Run the demo application using the Java agent to send telemetry to OTel Collector:

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

   Result:

   ...
   2026-05-05T19:00:31.981Z  INFO 3657 --- [           main] 
   o.s.s.petclinic.PetClinicApplication     : Started PetClinicApplication in 9.287 seconds (process running for 12.883)
   

9. Open the running Spring PetClinic demo app in your browser:

   • If the application is installed on your local computer, its address is http://localhost:8080.
   • If you used a VM to install the application, its address is http://<VM_public_IP_address>:8080.

10. Interact with the demo application UI as a user: open a menu, click a button, enter new owner details, schedule an appointment, etc.