[Документация Yandex Cloud](../../index.md) > [Monium](../index.md) > Поставка данных > Обзор

# Поставка телеметрии

В Monium автоматически поступают данные телеметрии от ресурсов Yandex Cloud. Также вы можете передавать в Monium данные телеметрии в формате [OpenTelemetry](https://opentelemetry.io/) из любых источников: других облаков, собственной инфраструктуры или приложений.

В этом разделе описано, как настроить передачу метрик, логов и трейсов в Monium. Вы можете отправлять данные напрямую из приложения с помощью OpenTelemetry SDK или использовать агент-коллектор для централизованного сбора и маршрутизации телеметрии.

## Настройка подключения {#connection-parameters}

Чтобы передавать телеметрию в Monium:

1. Настройте сбор телеметрии из вашего приложения в формате [OpenTelemetry](https://opentelemetry.io/).

   Телеметрию можно передавать напрямую из приложения или через [агент](#collectors).
     
1. [Создайте сервисный аккаунт](../../iam/operations/sa/create.md).
1. [Создайте API-ключ](../../iam/operations/authentication/manage-api-keys.md) для сервисного аккаунта. Выберите область действия в зависимости от типа передаваемых данных:

   * `yc.monium.telemetry.write` — запись всех видов телеметрии;
   * `yc.monium.metrics.write` — запись метрик;
   * `yc.monium.logs.write` — запись логов;
   * `yc.monium.traces.write` — запись трейсов.

1. Укажите параметры подключения:

    * Эндпоинт — `ingest.monium.yacloudkz.tech:443`.
    * Протокол — `gRPC`, `HTTP`.

1. Настройте распределение данных по шардам.

   Телеметрия в Monium организована по иерархии «проект → кластер → сервис». Данные хранятся в шардах по парам «сервис-кластер».

   Укажите следующие параметры:

   * **Проект** — передается в заголовке `x-monium-project`. 
   
      По умолчанию при создании облака и каталога создаются два проекта: `cloud__<идентификатор_облака>` и `folder__<идентификатор_каталога>`. Также вы можете создать свои проекты для сбора телеметрии.
   
   * **Кластер** (опционально) — передается в атрибутах ресурса `OTEL_RESOURCE_ATTRIBUTES` с ключом `cluster` или `deployment.name`. По умолчанию — `default`.
   * **Сервис** — передается в атрибутах ресурса `OTEL_RESOURCE_ATTRIBUTES` с ключом `service` или `service.name`.

   Все метрики, логи, трейсы в Monium имеют обязательные метки `project`, `cluster` и `service`. Эти метки формируют ключ шарда.
   
   При поставке телеметрии в формате OpenTelemetry значения ключевых атрибутов назначаются по следующим приоритетам:
   
   * Самый высокий приоритет у значений, заданных через HTTP- или gRPC-заголовки.
   * Затем у значений, заданных в ресурсных атрибутах тела запроса с ключами `cluster`, `service`.
   * Затем у значений, заданных в ресурсных атрибутах, рекомендуемых семантической конвенцией OpenTelemetry.
   * Если перечисленных значений не задано, проставляется значение по умолчанию.
   
   Имя проекта проставляется только из заголовка. Алгоритм определения ключа шарда представлен в таблице ниже.
   
   #|
   || заголовок | собственный атрибут ресурса | стандартный атрибут ресурса | значение по умолчанию ||
   || `x-monium-project` | — | — | — ||
   || `x-monium-cluster` | `cluster` | `deployment.name` | `default` ||
   || `x-monium-service` | `service` | `service.name`, `k8s.deployment.name`, `k8s.namespace.name` | `default` ||
   |#

## Агенты {#collectors}

Monium принимает телеметрию из ресурсов Yandex Cloud, других облаков и приложений в вашей инфраструктуре.

Для ресурсов Yandex Cloud передача данных настраивается при создании или изменении ресурса.

Для приложений доступны два способа сбора телеметрии:

* **OpenTelemetry SDK** — подключите SDK к приложению и настройте OTLP-экспорт.
* **Автоинструментация** — используйте агент или библиотеки, которые автоматически собирают телеметрию из популярных фреймворков без изменения кода.

Данные можно отправлять напрямую из SDK или через агент, который поддерживает OTLP.

Агент устанавливается рядом с приложением — на сервере, виртуальной машине или в контейнере. Он принимает телеметрию и передает ее в Monium. Если приложение отправляет данные не в формате OTLP, агент выполняет преобразование.

Подробнее о настройке:

* [Unified Agent](../concepts/data-collection/unified-agent/index.md) — агент от Яндекса (пока работает только с метриками).
* [OTel Collector](opentelemetry.md) — агент экосистемы OpenTelemetry.
* [Fluent Bit](fluentbit.md) — легковесный агент для обработки логов и отправки других видов телеметрии.