Миграция с Cloud Logging на Monium

Сравнение Cloud Logging и MoniumСравнение Cloud Logging и Monium

Тестирование Monium без миграцииТестирование Monium без миграции

Логи из Cloud Logging уже доступны в Monium. Откройте их в консоли управления одним из способов:

• В сервисе Cloud Logging при просмотре логов нажмите кнопку Открыть в Monium.

• Откройте ссылку:

  https://kz.monium.yandex.cloud/projects/folder__<идентификатор_каталога>/logs
  

Для каждого каталога создан проект с идентификатором вида folder__<идентификатор_каталога>, логи каждой лог-группы доступны по ее имени.

Для поиска логов укажите запрос:

{project="folder__<идентификатор_каталога>", cluster="default", service="<имя_лог_группы>"}

Порядок миграцииПорядок миграции

1. Убедитесь, что данные доступны в Monium в проекте folder__<идентификатор_каталога>.

2. Обновите агент поставки данных (Unified Agent, Fluent Bit 4.0) или используйте OTel Collector и настройте поставку в OTel-формате.

3. Укажите новый эндпоинт: ingest.monium.yacloudkz.tech:443. Иначе логи продолжат поступать через Cloud Logging и тарифицироваться по его ценам.

4. Убедитесь, что логи поступают напрямую в Monium, а не через Cloud Logging.

   Для проверки посмотрите детализацию использования сервисов по продуктам в Yandex Cloud Billing. После миграции должно появиться потребление для логов в Monium. Потребление в сервисе Cloud Logging должно снизиться или прекратиться.

   После миграции логи начнут тарифицироваться по ценам Monium и станут доступны все возможности платформы.

5. (Опционально) Переименуйте проекты, кластеры и сервисы. Можно оставить текущую структуру: folder__<идентификатор_каталога> → default → имя лог-группы или задать собственные имена. Подробнее в разделе Виды телеметрии и общие понятия.

Настройка агента для поставки в OTelНастройка агента для поставки в OTel

Unified AgentUnified Agent

1. Замените секцию output в конфигурационном файле.

   Было:

   channel:
     output:
       plugin: yc_logs
       config:
         url: "ingester.logging.yandexcloud.kz:443"
         log_group_id: "<идентификатор_лог_группы>"
         folder_id: "<идентификатор_каталога>"
         iam:
           cloud_meta:
   

   Стало:

   channel:
     output:
       plugin: otel_logs
       config:
         url: "ingest.monium.yacloudkz.tech:443"
         project: folder__<идентификатор_каталога>
         service: <имя_сервиса>
         iam:
           cloud_meta:
   

   Параметр project задайте произвольно — в Monium можно создавать собственные проекты. В параметре service укажите имя лог-группы, чтобы сохранить структуру данных.

2. Чтобы указать кластер, добавьте параметр cluster: <имя_кластера>. По умолчанию используется значение default.

Fluent BitFluent Bit

Вы можете продолжить использование Fluent Bit или настроить поставку через OTel Collector.

1. Проверьте, что установленная версия Fluent Bit 4.0 или выше:

   apt show fluent-bit
   

2. Убедитесь, что конфигурационный файл в формате YAML. Поддержка классического INI-формата заканчивается в конце 2026 года.

3. Замените секцию outputs.

   Было (плагин yc-logging):

   pipeline:
     outputs:
       - name: yc-logging
         ...
   

   Стало (плагин opentelemetry):

   pipeline:
     outputs:
       - name: opentelemetry
         host: ingest.monium.yacloudkz.tech
         port: 443
         logs_uri: /otlp/v1/logs
         tls: on
         tls.verify: off
         header:
           - Authorization Api-Key ${API_KEY}
           - x-monium-project folder__<идентификатор_каталога>
   

   Вместо API-ключа можно передавать IAM-токен: Authorization Bearer ${IAM_TOKEN}.

4. Если входной плагин не использует OpenTelemetry или в сообщениях не задан параметр service, добавьте процессор opentelemetry_envelope с атрибутами ресурса:

   pipeline:
     inputs:
       - name: <входной_плагин>
         processors:
           logs:
             - name: opentelemetry_envelope
             - name: content_modifier
               context: otel_resource_attributes
               action: upsert
               key: service.name
               value: <имя_лог_группы>
             - name: content_modifier
               context: otel_resource_attributes
               action: upsert
               key: cluster
               value: default
   

   В параметре service.name укажите имя лог-группы, чтобы сохранить структуру данных. Параметр cluster необязателен, значение по умолчанию — default.

Чтение логов по APIЧтение логов по API

Чтение через API Cloud Logging будет поддерживаться до 1 марта 2027 года, если сохранена структура folder__<идентификатор_каталога> → default → имя лог-группы. Данные доступны в пределах срока хранения — 31 день.

Чтение данных через API Monium и документация к нему станут доступны в июле 2026 года. Переведите запросы на чтение на новый API до окончания поддержки старого API.