Подключиться
Yandex Monitoring

Поставка метрик с хостов вне Yandex.Cloud

Статья создана

Для поставки в Yandex Monitoring метрик с хостов, расположенных за пределами Yandex.Cloud, используются авторизованные ключи сервисных аккаунтов. Описанная методика может также применяться для отправки метрик с виртуальных машин Yandex.Cloud без привязанного сервисного аккаунта.

Поставка метрик с использованием авторизованного ключа

Чтобы настроить Yandex Unified Agent для поставки метрик с использованием авторизованного ключа, выполните следующие шаги:

  1. Настройте сервисный аккаунт, от имени которого будут записываться метрики в Yandex Monitoring и создайте авторизованный ключ.

    1. Создайте сервисный аккаунт в каталоге, куда будут записываться метрики и назначьте ему роль monitoring.editor.

    2. Создайте авторизованный ключ для созданного сервисного аккаунта при помощи утилиты YC CLI, заменив строку <SA_ID> на идентификатор сервисного аккаунта:

      yc iam key create --service-account-id <SA_ID> --output jwt_params.json

      Другие способы создания авторизованных ключей описаны в разделе Создание авторизованных ключей.

    3. Доставьте файл jwt_params.json с параметрами авторизованного ключа на хост, где установлен Unified Agent.

      Пример файла jwt_params.json:

      {
    "id": "ajt...",
    "service_account_id": "aje...",
    "created_at": "2021-01-14T13:18:51.070026Z",
    "key_algorithm": "RSA_2048",
    "public_key": "-----BEGIN PUBLIC KEY-----\nMD...",
    "private_key": "-----BEGIN PRIVATE KEY-----\nMI..."
}

  2. Установите и настройте Yandex Unified Agent.

    1. Установите Unified Agent на свою виртуальную машину, выполнив в домашнем каталоге следующую команду:

      docker run \
-p 16241:16241 -it --detach --uts=host \
--name=ua \
-v /proc:/ua_proc \
-v config.yml:/etc/yandex/unified_agent/conf.d/config.yml \
-e PROC_DIRECTORY=/ua_proc \
-e FOLDER_ID=a1bs... \
cr.yandex/yc/unified-agent

      Другие способы установки агента описаны в разделе Установка и запуск Yandex Unified Agent.

    2. Создайте в домашнем каталоге файл config.yml. В файле замените строку $FOLDER_ID на идентификатор каталога, в который будут записываться метрики. Укажите имя файла с параметрами JWT в секции iam.jwt.file.

      config.yml:

       status:
   port: "16241"

 storages:
   - name: main
     plugin: fs
     config:
       directory: /var/lib/yandex/unified_agent/main
       max_partition_size: 100mb
       max_segment_size: 10mb

 channels:
   - name: cloud_monitoring
     channel:
       pipe:
         - storage_ref:
             name: main
       output:
         plugin: yc_metrics
         config:
           folder_id: "$FOLDER_ID"
           iam:
             jwt:
               file: "jwt_params.json"

 routes:
   - input:
       plugin: linux_metrics
       config:
         namespace: sys
     channel:
       channel_ref:
         name: cloud_monitoring

   - input:
       plugin: agent_metrics
       config:
         namespace: ua
     channel:
       pipe:
         - filter:
             plugin: filter_metrics
             config:
               match: "{scope=health}"
       channel_ref:
         name: cloud_monitoring

 import:
   - /etc/yandex/unified_agent/conf.d/*.yml

  3. Убедитесь, что метрики поступают в Yandex Monitoring.

    1. На главной странице сервиса Yandex Monitoring перейдите в раздел Обзор метрик.

    2. В строке запроса выберите:

    • каталог, в который собираются метрики;
    • значение метки service=custom;
    • имя метрики, начинающееся с префикса sys.

Что дальше