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

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

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

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

• Визуализация данных
• Запрос GET метрических точек данных API Metric v2.

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

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

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

Измерение dt.process.id=<PID> можно использовать для добавления идентификатора группы процессов. При указании идентификатора группы процессов измерение dt.entity.process_group_instance будет добавлено к заданной метрике. Функция работает только при получении метрик ЕдиныйАгент через API dynatrace_ingest.

Вы не можете загрузить метрики с ключевым префиксом dt.— они зарезервированы для использования Ключ-АСТРОМ.

Запрос text/plain использует полезную нагрузку. Размер полезной нагрузки ограничен 1 МБ.

Количество показателей не ограничено.

POST	Managed	https://{your-domain}/e/{your-environment-id}/api/v2/metrics/ingest
	Среда и кластер АктивногоШлюза (порт по умолчанию 9999)	https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/metrics/ingest

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

Для выполнения этого запроса вам понадобится токен доступа с областью действия metrics.ingest.

Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация.

Параметры

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

Ответ

Коды ответов

Код	Тип	Описание
202	Ответ на проверку	Предоставленные метрические данные принимаются и будут обрабатываться в фоновом режиме.
400	Ответ на проверку	Некоторые точки данных недействительны. Верные точки данных принимаются и будут обработаны в фоновом режиме.
4ХХ	Конверт ошибки	Ошибка на стороне клиента.
5XX	Конверт ошибки	Ошибка на стороне сервера.

Пример

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

curl -L -X POST 'https://mySampleEnv.live.dynatrace.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'