Writing custom metrics via the API
Written by
Updated at October 31, 2024
To start writing custom metrics via the API, use the write method.
Getting started
To try the examples in this section:
-
Make sure you have installed the cURL
utility that is used in the examples. -
Get the ID of the folder for which you have the
monitoring.editor
role or higher. -
Get an IAM token:
- Guide for users with a Yandex account.
- How to get a token for a service account.
- How to get a token for a federated account.
Sample request
-
Create a file with the request body, e.g.,
body.json
. In themetrics
property, specify the list of metrics to write. Send the required labels in the query parameters and additional labels in the request body.body.json:
{ "metrics": [ { "name": "temperature", "labels": { "building": "office", "room": "openspace" }, "value": 18.6 } ] }
-
Send the request and save the response to a file, e.g.,
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
Response example:
output.json:
{ "metrics_written":"1" }