IKuznetsov: Новая страница: «Вы можете использовать локальную конечную точку '''API''' `http://localhost:/metrics/ingest<...»`


2025-09-03T23:58:52Z
Новая страница: «Вы можете использовать локальную конечную точку '''API''' <code><nowiki>http://localhost</nowiki>:<port>/metrics/ingest<...»
Новая страница
Вы можете использовать локальную конечную точку '''API''' <code><nowiki>http://localhost</nowiki>:<port>/metrics/ingest</code> для передачи локально полученных метрик в Ключ-АСТРОМ по безопасному и аутентифицированному каналу. Эта конечная точка доступна только локальным клиентам и недоступна с удалённых хостов.



Если вы не можете отправлять метрики с помощью локальной конечной точки '''API''', вы также можете использовать публичную конечную точку '''API метрик v2''' (см. ниже).



== Включить API метрик ЕдиногоАгента ==

'''<u>АктивныйШлюз версии 1.243+</u>'''



'''<u>ЕдиныйАгент версии 1.243+</u>'''



'''API метрик''' ЕдиногоАгента по умолчанию входит в состав ЕдиногоАгента '''версии 1.201'''. Вам нужно включить '''API метрик''' ЕдиногоАгента только на уровне среды или хоста. Обратите внимание, что конфигурация на уровне хоста переопределяет конфигурацию среды.



Если вы хотите изменить лимиты потребления ресурсов '''EEC''', см. [[О расширениях|Профиль производительности]].



=== Включить на уровне среды ===



# Перейдите в раздел '''Настройки''' и выберите '''Предпочтения''' '''> Контроллер выполнения расширений'''.

# Включите опцию '''Включить контроллер выполнения расширений'''.

# Включите функцию Включить локальный '''API HTTP Metric, Log and Event Ingest'''.



=== Включить для одного хоста ===



# Перейдите в раздел '''Хосты'''.

# Найдите и выберите свой хост, чтобы отобразить страницу обзора хостов.

# В правом верхнем углу страницы обзора хоста выберите '''Дополнительно ( … ) > Настройки'''.

# В настройках хоста выберите '''Контроллер выполнения расширений'''.

# Включите опцию '''Включить контроллер выполнения расширений'''.



=== Включить для группы хостов ===



# Перейдите в раздел '''Состояние развертывания''', а затем выберите '''ЕдиныеАгенты'''.

# На странице развертывания ЕдиногоАгента отключите опцию '''Показывать новые развертывания ЕдиногоАгента.'''

# Отфильтруйте таблицу по <code>Host group</code> и выберите группу хостов, которую вы хотите настроить. Свойство '''Группа хостов''' не отображается, если выбранный хост не принадлежит ни одной группе хостов. Отобразится страница развёртывания ЕдиногоАгента, отфильтрованная по выбранной группе хостов. Для каждого указанного хоста есть ссылка '''Группа хостов:''' <code><group name></code>, где <code><group name></code>— имя группы хостов, которую нужно настроить.

# Выберите название группы хостов в любой строке. Поскольку вы отфильтровали данные по группе хостов, все отображаемые хосты относятся к одной и той же группе.

# В настройках группы хостов выберите '''Контроллер выполнения расширений'''.

# Включите опцию '''Включить контроллер выполнения расширений'''.



== Топология ==

Используя локальную конечную точку '''API''', идентификатор хоста и контекст имени хоста автоматически добавляются к каждой метрике в качестве измерений. Узнайте, как [[Расширение данных|дополнить свои метрики другими специфичными для Ключ-АСТРОМ измерениями]] и применить информацию о причинно-следственных связях Ключ-АСТРОМ ИИ к полученным данным.



== Метрический формат ==

Предоставленные точки данных должны соответствовать [[Протокол приема метрических данных|протоколу приема метрик]] .



Запрос <code>text/plain</code> использует полезную нагрузку с указанным набором символов <code>charset=utf-8</code>. Полезная нагрузка ограничена <code>1,000</code> строками.



== Пример ==

С помощью этой <code>curl</code> команды вы получите метрику <code>cpu.temperature</code>, назначенную измерению <code>cpu=1</code>. Метрика будет автоматически назначена соответствующему идентификатору и имени хоста.

{| class="wikitable"

|curl --data "cpu.temperature,cpu=1 55" <nowiki>http://localhost:14499/metrics/ingest</nowiki> \



     -H "Content-Type: text/plain; charset=utf-8"

|}

Успешный ответ:

{| class="wikitable"

|{



"error": null,



"linesValid": 1,



"linesInvalid": 0



}

|}



== Коммуникационный порт ==

{| class="wikitable"

|Начиная с версии ЕдиногоАгента 1.267+, системы AIX также поддерживают прием метрик.

|}

Порт для сбора метрик по умолчанию — <code>14499</code>. При необходимости вы можете проверить или изменить порт с помощью команды [[ЕдиныйАгент настройка через интерфейс командной строки|oneagentctl]] <code>[[ЕдиныйАгент настройка через интерфейс командной строки|--restart-service]]</code>. Изменение порта для сбора метрик требует перезапуска ЕдиногоАгента. Добавьте к команде для автоматического перезапуска ЕдиногоАгента.



=== Проверьте порт приема ===

Используйте параметр <code>--get-extensions-ingest-port</code>, чтобы показать текущий локальный порт приема по умолчанию <code>14499</code>.



* '''Linux, AIX :''' <code>./oneagentctl --get-extensions-ingest-port</code>

* '''Windows :''' <code>.\oneagentctl.exe --get-extensions-ingest-port</code>



=== Установите пользовательский порт приема ===

Используйте параметр <code>--set-extensions-ingest-port=<arg></code> для установки локального порта приема.



* '''Linux, AIX :''' <code>./oneagentctl --set-extensions-ingest-port=14499 --restart-service</code>

* '''Windows :''' <code>.\oneagentctl.exe --set-extensions-ingest-port=14499 --restart-service</code>



=== Настроить прокси ===

Настройте прокси-сервер своего хоста так, чтобы разрешить трафику '''localhost''' проходить через порт сбора метрик по умолчанию <code>14499</code>.



Обратите внимание, что изменение порта для '''API''' метрик ЕдиногоАгента также влияет на интеграцию скриптов и '''Telegraf'''.



== API метрик v2 ==

В отличие от локального интерфейса загрузки, который автоматически добавляет топологический контекст (каждая метрика назначается соответствующему хосту), метрики, передаваемые через общедоступный '''Metrics API v2''', по умолчанию являются плоскими. Это особенно полезно для бизнес-метрик, которые не имеют никакого отношения к топологическим сущностям вашей среды.



Однако, чтобы события генерировались для выбранного хоста и Ключ-АСТРОМ ИИ выполнял причинно-следственный анализ на основе ваших метрик, вы можете настроить приложение для добавления измерения <code>dt.entity.host</code>. Чтобы автоматически дополнить идентификатор группы процессов метрикой, укажите измерение <code>dt.process.pid</code>. Подробнее см. в разделе [[API метрик - POST прием точек данных|API метрик - POST прием точек данных.]]
API метрик ЕдиногоАгента - История изменений

IKuznetsov: Новая страница: «Вы можете использовать локальную конечную точку '''API''' http://localhost:/metrics/ingest<...»

IKuznetsov: Новая страница: «Вы можете использовать локальную конечную точку '''API''' `http://localhost:/metrics/ingest<...»`
