Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.

Setting up a demo Java app and collecting telemetry

Written by
Updated at September 24, 2026
View in Markdown

Getting started

Sign up for Yandex Cloud and create a billing account:

  1. Navigate to the management console and log in to Yandex Cloud or create a new account.
  2. 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 run Spring PetClinic and set up sending telemetry data to Monium.
You will be able to collect logs, traces, and metrics for JVM (class loading, CPU utilization, garbage collection), database connection pools, and HTTP endpoints without modifying your application code.

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

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

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

  3. Clone and build Spring PetClinic:

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

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

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

  6. Optionally, enable delta temporality for metrics:

    export OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE="delta"

  7. Run the application with the Java agent:

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

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

Viewing telemetry in Monium

  1. On the Monium home page, hover over Explore on the left and select the correct data type section:

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

    2. 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>) or 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. For more on troubleshooting possible issues, see Data delivery troubleshooting.

    3. Click Execute query or Execute.

      The page will show data that matches the query.

    image

    More on metrics.

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

    2. 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>) or 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. For more on troubleshooting possible issues, see Data delivery troubleshooting.

    3. Click Execute query or Execute.

      The page will show data that matches the query.

    image

    More on logs.

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

    2. 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>) or 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. For more on troubleshooting possible issues, see Data delivery troubleshooting.

    3. Click Execute query or Execute.

      The page will show data that matches the query.

    image

    More on traces.

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

Previous
OpenTelemetry SDK
Next
Java demo application example with an agent