Getting started with Monium

Log in to the management console or sign up. If not signed up yet, navigate to the management console and follow the instructions.

On the Yandex Cloud Billing page, make sure you have a linked billing account with the ACTIVE or TRIAL_ACTIVE status. If you do not have a billing account yet, create one.

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

Learn more about clouds and folders here.

Set these environment variables:

• MONIUM_PROJECT: Monium project name in folder__<folder_ID> format, e.g., folder__b1g86q4m5vej********.
• MONIUM_API_KEY: API key.

Set up telemetry from your application in OTLP format:

• Install the auto-instrumentation agent to automatically collect some telemetry data and send it to OTLP.
• Add the OpenTelemetry SDK to your app.

Install OTel Collector.

You can send data to Monium directly from the OpenTelemetry SDK, without using the agent.

In the otel-collector.yaml configuration file, configure data transfer to Monium.

Example of a minimal otel-collector.yaml configuration:

receivers:       
  otlp:          # Target type: OTLP
    protocols:   # Protocols that OTel Collector listens to
      grpc:      # gRPC, default port 4317
      http:      # HTTP, default port 4318

processors:
  cumulativetodelta:
  batch:

exporters:       # Connecting to Monium
  otlp/monium:
    compression: zstd
    endpoint: ingest.monium.yandex.cloud:443
    headers:
      Authorization: "Api-Key ${env:MONIUM_API_KEY}"
      x-monium-project: "${env:MONIUM_PROJECT}"

service:         
  pipelines:
    metrics:                 # Transferring metrics
      receivers: [ otlp ]
      processors: [ batch, cumulativetodelta ]
      exporters: [ otlp/monium ]
    traces:                  # Transferring traces
      receivers: [ otlp ]
      processors: [ batch ]
      exporters: [ otlp/monium ]
    logs:                    # Transferring logs
      receivers: [ otlp ]
      processors: [ batch ]
      exporters: [ otlp/monium ]

Set the environment variables to distribute data across shards in Monium:

• OTEL_SERVICE_NAME: Name of your application or service.
• OTEL_RESOURCE_ATTRIBUTES="cluster=my-cluster": Name of the installation the application operates in, e.g., production or test environment. This is an optional setting. The default value is cluster=default.

Run your app and start sending telemetry.

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 in succession and click Execute query.
  Learn more about using metrics.

• Logs.

  In the query string, select project, cluster, and service in succession and click Execute query.
  Learn more about using logs.

• Traces.

  In the query string, select project and service in succession and click Execute.
  Learn more about using traces.

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 for your OS.

We recommend to install OTel Collector version 0.144.0.

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:      

processors:
  cumulativetodelta:
  batch:

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

service:         
  pipelines:
    metrics:                 
      receivers: [ otlp ]
      processors: [ batch, cumulativetodelta ]
      exporters: [ otlp/monium ]
    traces:                 
      receivers: [ otlp ]
      processors: [ batch ]
      exporters: [ otlp/monium ]
    logs:                   
      receivers: [ otlp ]
      processors: [ batch ]
      exporters: [ otlp/monium ]

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

Set this environment variable:

export OTEL_SERVICE_NAME=spring-petclinic

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

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

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

Look up the telemetry data in Monium.