Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Monitoring
  • Начало работы
    • Все инструкции
      • Обзор метрик
      • Поставка системных метрик Linux
      • Поставка метрик пользовательских приложений
      • Поставка метрик HAProxy и других сторонних приложений
      • Поставка метрик с хостов вне Yandex Cloud
      • Запись пользовательских метрик через API
      • Получение списка метрик
      • Выгрузка метрик
      • Экспорт метрик в формате Prometheus
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
  • История изменений
  • Обучающие курсы
  1. Пошаговые инструкции
  2. Работа с метриками
  3. Запись пользовательских метрик через API

Запись пользовательских метрик через API

Статья создана
Yandex Cloud
Обновлена 19 февраля 2025 г.

Чтобы начать записывать пользовательские метрики через API, воспользуйтесь методом write.

Перед началом работыПеред началом работы

Чтобы воспользоваться примерами в этом разделе:

  1. Убедитесь, что у вас установлена утилита cURL, используемая в примерах.

  2. Получите идентификатор каталога, на который у вас есть роль monitoring.editor или выше.

  3. Получите IAM-токен:

    • Инструкция для пользователя с аккаунтом на Яндексе.
    • Инструкция для сервисного аккаунта.
    • Инструкция для федеративного аккаунта.

Пример запросаПример запроса

  1. Создайте файл с телом запроса, например body.json. В свойстве metrics перечислите список метрик для записи. Обязательные метки передаются в query-параметрах запроса, а дополнительные — в теле запроса.

    body.json:

    {
        "metrics": [
            {
                "name": "temperature",
                "labels": {
                    "building": "office",
                    "room": "openspace"
                },
                "value": 18.6
            }
        ]
    }
    
  2. Отправьте запрос и сохраните ответ в файл, например output.json:

    export IAM_TOKEN=CggaATEVAgA...
    curl \
      --request POST \
      --header "Content-Type: application/json" \
      --header "Authorization: Bearer ${IAM_TOKEN}" \
      --data '@body.json' \
      'https://monitoring.api.cloud.yandex.net/monitoring/v2/data/write?folderId=aoe6vrq0g3sv********&service=custom' > output.json
    

    Пример ответа на запрос:

    output.json:

    {
        "metrics_written":"1"
    }
    

Была ли статья полезна?

Предыдущая
Поставка метрик с хостов вне Yandex Cloud
Следующая
Получение списка метрик
Проект Яндекса
© 2025 ООО «Яндекс.Облако»