Размещение поглощаемой точки данных: различия между версиями

Текущая версия от 20:55, 25 декабря 2024

Отправляет пользовательские точки данных в АппОптима.

Предоставленные точки данных должны соответствовать протоколу приема метрик. Вам не нужно сначала регистрировать метрику. После того, как АппОптима приняла и обработала данные, вы можете использовать их так же, как и любые другие показатели в АппОптима, например, в диаграммах или событиях показателей. Вы также можете предоставить метаданные для введенной метрики через 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	АппОптима	`https://{your-domain}/e/{your-environment-id}/api/v2/metrics/ingest`
POST	Среда АктивногоШлюза	`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'

@@ Строка 1: / Строка 1: @@
-Отправляет пользовательские точки данных в Ключ-ААСТРОМ.
+Отправляет пользовательские точки данных в АппОптима.
-Предоставленные точки данных должны соответствовать протоколу приема метрик. Вам не нужно сначала регистрировать метрику. После того, как Ключ-АСТРОМ приняла и обработала данные, вы можете использовать их так же, как и любые другие показатели в Ключ-АСТРОМ, например, в диаграммах или событиях показателей. Вы также можете предоставить метаданные для введенной метрики через API настроек.
+Предоставленные точки данных должны соответствовать протоколу приема метрик. Вам не нужно сначала регистрировать метрику. После того, как АппОптима приняла и обработала данные, вы можете использовать их так же, как и любые другие показатели в АппОптима, например, в диаграммах или событиях показателей. Вы также можете предоставить метаданные для введенной метрики через API настроек.
 Предпочитаете использовать метрики прямо на хосте?
+Вы также можете передавать точки данных напрямую с узла, контролируемого ЕдиногоАгента, в модуль ЕдиныйАгент Extensions Execution Controller (EEC) по защищенному каналу с использованием локальной <code><nowiki>http://localhost</nowiki>:<port>/metrics/ingest</code>конечной точки, которая не требует проверки подлинности токена. Порт по умолчанию <code>14499</code>. При использовании этого метода <code>dt.entity.host=<host-ID></code>к каждой метрике добавляется зарезервированное измерение АппОптима. Дополнительные сведения см. в разделе API метрик ЕдиногоАгента .
 Для просмотра точек данных введенной метрики можно использовать:
 * Обозреватель данных
-* ПОЛУЧИТЬ запрос точек данных метрики из API Metric v2.
+* GET запрос точек данных метрики из API Metric v2.
-Запрос потребляет <code>text/plain</code>полезную нагрузку. Полезная нагрузка ограничена <code>1,000</code>строками.
+Запрос использует в качестве полезной нагрузки формат text/plain. Полезная нагрузка ограничена <code>1,000</code>строками.
 {| class="wikitable"
-| rowspan="3" |POST
+| rowspan="2" |POST
-|Managed
+|АппОптима
 |<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/metrics/ingest</nowiki></code>
 |-
-|SaaS
+|Среда АктивногоШлюза
-|<code><nowiki>https://{your-environment-id}.live.ruscomtech.ru/api/v2/metrics/ingest</nowiki></code>
-|-
-|Окружающая среда АктивногоШлюза
 |<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/metrics/ingest</nowiki></code>
 |}
@@ Строка 62: / Строка 61: @@
 == Пример ==
 <code>curl</code>С помощью этой команды вы будете использовать метрику, назначенную измерению.<code>cpu.temperatureHOST-06F288EE2A930951</code>
-  <code>curl -L -X POST '<nowiki>https://mySampleEnv.live.ruscomtech.ru.com/api/v2/metrics/ingest'</nowiki> \
+  <curl -L -X POST '<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/metrics/ingest'</nowiki> \
   -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
   -H 'Content-Type: text/plain' \
   --data-raw 'cpu.temperature,dt.entity.host=HOST-06F288EE2A930951,cpu=1 55'</code>