POST введённых точек данных: различия между версиями
| Строка 14: | Строка 14: | ||
Вы также можете передавать точки данных непосредственно с хоста, контролируемого ЕдиногоАгента, в модуль ЕдиногоАгента контроллера выполнения расширений (EEC) по защищенному каналу, используя локальную конечную точку <code><nowiki>http://localhost</nowiki>:<port>/metrics/ingest</code>, не требующую аутентификации с помощью токена. Порт по умолчанию — <code>14499</code>. При использовании этого метода зарезервированное измерение Ключ-АСТРОМ <code>dt.entity.host=<host-ID></code> добавляется к каждой метрике. | Вы также можете передавать точки данных непосредственно с хоста, контролируемого ЕдиногоАгента, в модуль ЕдиногоАгента контроллера выполнения расширений (EEC) по защищенному каналу, используя локальную конечную точку <code><nowiki>http://localhost</nowiki>:<port>/metrics/ingest</code>, не требующую аутентификации с помощью токена. Порт по умолчанию — <code>14499</code>. При использовании этого метода зарезервированное измерение Ключ-АСТРОМ <code>dt.entity.host=<host-ID></code> добавляется к каждой метрике. | ||
Измерение <code>dt.process.id=<PID></code> можно использовать для добавления идентификатора группы процессов. При указании идентификатора группы процессов измерение <code>dt.entity.process_group_instance</code> будет добавлено к заданной метрике. Функция работает только при получении метрик ЕдиныйАгент через API <code> | Измерение <code>dt.process.id=<PID></code> можно использовать для добавления идентификатора группы процессов. При указании идентификатора группы процессов измерение <code>dt.entity.process_group_instance</code> будет добавлено к заданной метрике. Функция работает только при получении метрик ЕдиныйАгент через API <code>astromkey_ingest</code>. | ||
{| class="wikitable" | {| class="wikitable" | ||
|Вы не можете загрузить метрики с ключевым префиксом <code>dt.</code>— они зарезервированы для использования Ключ-АСТРОМ. | |Вы не можете загрузить метрики с ключевым префиксом <code>dt.</code>— они зарезервированы для использования Ключ-АСТРОМ. | ||
| Строка 82: | Строка 82: | ||
С помощью этой <code>curl</code> команды вы примете метрику <code>cpu.temperature</code>, назначенную измерению <code>HOST-06F288EE2A930951</code>. | С помощью этой <code>curl</code> команды вы примете метрику <code>cpu.temperature</code>, назначенную измерению <code>HOST-06F288EE2A930951</code>. | ||
{| class="wikitable" | {| class="wikitable" | ||
|curl -L -X POST '<nowiki>https://mySampleEnv.live. | |curl -L -X POST '<nowiki>https://mySampleEnv.live.astromkey.com/api/v2/metrics/ingest'</nowiki> \ | ||
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ | -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ | ||
Текущая версия на 14:45, 15 января 2026
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 astromkey_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 | необходимый |
Запрос объекта тела
Объект RequestBody
Ответ
Коды ответов
| Код | Тип | Описание |
|---|---|---|
| 202 | Ответ на проверку | Предоставленные метрические данные принимаются и будут обрабатываться в фоновом режиме. |
| 400 | Ответ на проверку | Некоторые точки данных недействительны. Верные точки данных принимаются и будут обработаны в фоновом режиме. |
| 4ХХ | Конверт ошибки | Ошибка на стороне клиента. |
| 5XX | Конверт ошибки | Ошибка на стороне сервера. |
Пример
С помощью этой curl команды вы примете метрику cpu.temperature, назначенную измерению HOST-06F288EE2A930951.
| curl -L -X POST 'https://mySampleEnv.live.astromkey.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' |
