Облачная платформаEvolution

Записать метрики через API

Эта статья полезна?

Примечание

API сервиса находится на стадии Preview. Чтобы получить доступ к записи метрик для вашей организации, обратитесь в техническую поддержку.

В инструкции описано, как записать метрики в сервис через API или в vmagent по протоколу remote write.

Чтобы записать метрики:

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

    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.