POST введённых точек данных: различия между версиями
ENetrebin (обсуждение | вклад) (Новая страница: «Отправляет пользовательские точки данных в Ключ-АСТРОМ. Предоставленные точки данных д...») |
ENetrebin (обсуждение | вклад) |
||
Строка 1: | Строка 1: | ||
'''''[[API Ключ-АСТРОМ]] / [[API Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B|Эндпойнты среды]] / [[API Ключ-АСТРОМ#.D0.A0.D0.B0.D0.B7.D0.B2.D1.91.D1.80.D1.82.D1.8B.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5|Развёртывание]] / Метрики v2 / POST введённых точек данных''''' | |||
Отправляет пользовательские точки данных в Ключ-АСТРОМ. | Отправляет пользовательские точки данных в Ключ-АСТРОМ. | ||
Текущая версия на 16:35, 1 ноября 2024
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'