Размещение поглощаемой точки данных

Материал из Документация Ключ-АСТРОМ

Отправляет пользовательские точки данных в Ключ-ААСТРОМ.

Предоставленные точки данных должны соответствовать протоколу приема метрик. Вам не нужно сначала регистрировать метрику. После того, как Ключ-АСТРОМ приняла и обработала данные, вы можете использовать их так же, как и любые другие показатели в Ключ-АСТРОМ, например, в диаграммах или событиях показателей. Вы также можете предоставить метаданные для введенной метрики через API настроек.

Предпочитаете использовать метрики прямо на хосте?

Для просмотра точек данных введенной метрики можно использовать:

  • Обозреватель данных
  • ПОЛУЧИТЬ запрос точек данных метрики из API Metric v2.

Запрос потребляет text/plainполезную нагрузку. Полезная нагрузка ограничена 1,000строками.

POST Managed https://{your-domain}/e/{your-environment-id}/api/v2/metrics/ingest
SaaS https://{your-environment-id}.live.ruscomtech.ru/api/v2/metrics/ingest
Окружающая среда АктивногоШлюза https://{your-activegate-domain}/e/{your-environment-id}/api/v2/metrics/ingest

Аутентификация

Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Ingest metrics (metrics.ingest). Чтобы узнать, как получить и использовать его, см. раздел Токены и аутентификация.

Параметры

Параметр Тип Описание In Необходимость
body string Точки данных, указанные в линейном протоколе. Каждая строка представляет одну точку данных. body требуется

Запрос объектов тела

Объект RequestBody

Объект не предоставляет никаких параметров.

Ответ

Коды ответов

Код Описание
202 Предоставленные точки данных метрики принимаются и будут обрабатываться в фоновом режиме.
400 Некоторые точки данных являются недопустимыми. Допустимые точки данных принимаются и будут обрабатываться в фоновом режиме.

Пример

curlС помощью этой команды вы будете использовать метрику, назначенную измерению.cpu.temperatureHOST-06F288EE2A930951

curl -L -X POST 'https://mySampleEnv.live.ruscomtech.ru.com/api/v2/metrics/ingest' \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
-H 'Content-Type: text/plain' \
--data-raw 'cpu.temperature,dt.entity.host=HOST-06F288EE2A930951,cpu=1 55'