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-17-jdk

Install Fluent Bit 4.0 or higher.

Set these environment variables:

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

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}

Run Fluent Bit:

fluent-bit -c fluent-bit.yaml

Fluent Bit will start receiving telemetry over OTLP at 127.0.0.1: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. 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

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

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.