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

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

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

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

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

Вы также можете передавать точки данных напрямую с узла, контролируемого ЕдиногоАгента, в модуль ЕдиныйАгент Extensions Execution Controller (EEC) по защищенному каналу с использованием локальной http://localhost:<port>/metrics/ingestконечной точки, которая не требует проверки подлинности токена. Порт по умолчанию 14499. При использовании этого метода dt.entity.host=<host-ID>к каждой метрике добавляется зарезервированное измерение Ключ-АСТРОМ. Дополнительные сведения см. в разделе API метрик ЕдиногоАгента .

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

  • Обозреватель данных
  • GET запрос точек данных метрики из API Metric v2.

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

POST Managed https://{your-domain}/e/{your-environment-id}/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/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'