POST введённых точек данных

API Ключ-АСТРОМ / Эндпойнты среды / Развёртывание / Метрики v2 / POST введённых точек данных

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

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