Запись метрик в сервис

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

Для работы с API личного кабинета Cloud.ru потребуются:

• авторизация в личном кабинете и авторизационный токен;

• эндпоинт для запросов — https://monitoring.api.cloud.ru.

Запись метрик с помощью curl-запроса

Выполните запрос:

curl -X POST --location "https://monitoring.api.cloud.ru/v2/project/{project_ID}/prometheus/api/v1/import" \
    -H "Authorization: Bearer $TOKEN "\
    -d '{"metric":{"__name__":"metricName","labelName1":"labelValue1","labelName2":"labelValue2","labelNameN":"labelValueN"},"timestamps":[timestamp1,timestampN],"values":[value1,valueN]}'

Где:

• {project_ID} — ID проекта, в который будут отправлены метрики. Вы можете скопировать его из URL личного кабинета.

• metricName — название метрики.

• labelValue — значение метки.

• labelName — название метки, например:

  • serviceName — название сервиса;

  • serviceVersion — версия сервиса;

  • instanceID — уникальный идентификатор экземпляра сервиса.

• timestamps — временная метка, указанная в Unix timestamp в миллисекундах.

• values — значения метрики в указанных точках.

Также клиентские метрики можно отправить в vmagent по протоколу remote write. В этом случае используйте для запроса URL: https://monitoring.api.cloud.ru/v2/project/{project_ID}/prometheus/api/v1/write.