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

Чтобы начать записывать пользовательские метрики через 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 -X POST \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer ${IAM_TOKEN}" \
       -d '@body.json' \
       'https://monitoring.api.cloud.yandex.net/monitoring/v2/data/write?folderId=aoe6vrq0g3svvs3uf62u&service=custom' > output.json
   

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

   output.json:

   {
       "metrics_written":"1"
   }