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

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

Yandex.Cloud

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

Перед началом

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

Убедитесь, что у вас установлена утилита cURL, используемая в примерах.
Получите идентификатор каталога, на который у вас есть роль monitoring.editor или выше.
Получите IAM-токен:
- Инструкция для аккаунта на Яндексе.
- Инструкция для сервисного аккаунта.

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

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

body.json:
```
{
    "metrics": [
        {
            "name": "temperature",
            "labels": {
                "building": "office",
                "room": "openspace"
            },
            "value": 18.6
        }
    ]
}
```

Отправьте запрос и сохраните ответ в файл, например 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"
}