Collecting telemetry

Data transfer parametersData transfer parameters

To transmit telemetry to Monium:

1. Set up telemetry collection from your application in OpenTelemetry format.

   You can send telemetry directly from the application or via an agent.

2. Create a service account.

3. Create an API key for the service account with the required scopes:

   • yc.monitoring.manage: Writing data.
   • yc.monium.telemetry.write: Writing all telemetry types.
   • yc.monium.metrics.write: Writing metrics.
   • yc.monium.logs.write: Writing logs.
   • yc.monium.traces.write: Writing traces.

4. Specify data transfer settings:

   • Endpoint: ingest.monium.yandex.cloud:443.
   • Protocol: gRPC or HTTP.

5. In Monium, telemetry follows this hierarchy: project → cluster → service. Data is stored in shards in service-cluster pairs.

   To distribute data, specify:

   • Project: Provided as the x-monium-project header parameter. This may be a folder__<folder_ID> or a cloud__<cloud_ID>.
   • Cluster: Provided in OTEL_RESOURCE_ATTRIBUTES with the cluster or deployment.name key name. This is optional. If a cluster is not specified, data will go to the default cluster.
   • Service: Provided in OTEL_RESOURCE_ATTRIBUTES with the service or service.name key name.

   Monium stores data in shards with the project, cluster, and service keys. The shard key is selected based on a priority table, with priority decreasing from left to right.

   header	resource attribute	resource attribute	constant
   x-monium-project	—	—	—
   x-monium-cluster	cluster	deployment.name	default
   x-monium-service	service	service.name	default

Data transfer agentsData transfer agents

With Monium, you can manage telemetry from Yandex Cloud resources, other clouds, or applications in your infrastructure.

Transfer of Yandex Cloud data is set up when you create or update a resource.

To set up data transfer from applications, do one or both of the following:

• Connect the OpenTelemetry SDK and set up OTLP export.
• Use automation tools, i.e., agents or libraries that automatically collect telemetry from popular frameworks and libraries without modifying the code.

You can transfer data to Monium directly from the OpenTelemetry SDK or use an OTLP-compatible agent.

The agent is installed next to the application on a server, VM, or in a container and set up to receive telemetry and send it to Monium. If the application is configured to send data in a format other than OTLP, you will need an intermediate agent for OTLP conversion.

Learn more about setting up agents:

• Unified Agent: Agent by Yandex.
• OTel Collector: OpenTelemetry ecosystem agent.
• Fluent Bit: Agent to use for logs.