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 July 7, 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 install Spring PetClinic and set up sending telemetry data to Monium via Fluent Bit.

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

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

  2. Install Fluent Bit 4.0 or higher.

  3. Set these environment variables:

    export MONIUM_PROJECT=<project_ID>
export MONIUM_API_KEY=<API_key>

  4. Create a configuration file, e.g., fluent-bit.yaml. Use the Fluent Bit settings section configuration. Example for gRPC:

    pipeline:
  inputs:
    - name: opentelemetry
      listen: 127.0.0.1
      port: 4318

  outputs:
    - name: opentelemetry
      match: "*"
      host: ingest.monium.yandex.cloud
      port: 443
      tls: on
      compress: zstd
      grpc: on
      header:
        - Authorization Api-Key ${MONIUM_API_KEY}
        - x-monium-project ${MONIUM_PROJECT}

  5. Run Fluent Bit:

    fluent-bit -c fluent-bit.yaml

    Fluent Bit will start receiving telemetry over OTLP at 127.0.0.1:4318 (HTTP).

  6. Download and build Spring PetClinic:

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

  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 application with the Java agent. The telemetry will go to Fluent Bit port 4318. Do not specify OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE="delta": when transferred via Fluent Bit, delta metrics cannot be processed correctly.

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

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

Viewing telemetry in Monium

  1. On the Monium home page, select a data type section on the left:

    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
Configuring Fluent Bit
Next
Processing logs