https://doc.ruscomtech.ru/index.php?action=history&feed=atom&title=%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D0%BE%D0%B2_%D0%BC%D0%B5%D1%82%D1%80%D0%B8%D0%BAИнтеграция скриптов метрик - История изменений2026-04-13T13:59:41ZИстория изменений этой страницы в викиMediaWiki 1.36.1https://doc.ruscomtech.ru/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D0%BE%D0%B2_%D0%BC%D0%B5%D1%82%D1%80%D0%B8%D0%BA&diff=6093&oldid=prevIKuznetsov: Новая страница: «С помощью инструмента <code>astromkey_ingest</code> вы можете передавать локально полученные метрики...»2025-12-25T23:14:45Z<p>Новая страница: «С помощью инструмента <code>astromkey_ingest</code> вы можете передавать локально полученные метрики...»</p>
<p><b>Новая страница</b></p><div>С помощью инструмента <code>astromkey_ingest</code> вы можете передавать локально полученные метрики в Ключ-АСТРОМ по защищенному и аутентифицированному каналу. Инструмент доступен только локальным клиентам и недоступен с удаленных хостов.<br />
<br />
== Включение интеграции скриптов ==<br />
Интеграция со скриптами по умолчанию включена в ЕдиномАгенте версии 1.201 и выше. Вам нужно включить интеграцию со скриптами только на уровне среды или локального хоста. Обратите внимание, что конфигурация на уровне хоста переопределяет конфигурацию среды.<br />
<br />
=== Включить на уровне среды ===<br />
<br />
# Перейдите в '''Настройки''' и выберите '''Предпочтения''' > '''Контроллер выполнения расширений'''.<br />
# Включите параметр '''Контроллер выполнения расширений'''.<br />
# Включите '''локальный API для сбора HTTP-метрик, логов и событий'''.<br />
<br />
=== Включить для одного хоста ===<br />
<br />
# Перейдите в раздел '''Хосты'''.<br />
# Найдите и выберите свой хост, чтобы отобразить страницу обзора хоста.<br />
# В правом верхнем углу страницы обзора хоста выберите '''Дополнительно''' ( '''…''' ) > '''Настройки'''.<br />
# В настройках хоста выберите '''Контроллер выполнения расширений'''.<br />
# Включите параметр '''Контроллер выполнения расширений'''.<br />
<br />
=== Включить для группы хостов ===<br />
<br />
# Перейдите в раздел '''Статус развертывания''', а затем выберите ЕдиныйАгенты.<br />
# На странице развертывания ЕдиногоАгента отключите параметр '''Показывать новые развертывания ЕдиногоАгента'''.<br />
# Отфильтруйте таблицу <code>Host group</code> и выберите группу хостов, которую хотите настроить. <br /><u>Свойство '''Группа хостов''' не отображается, если выбранный хост не принадлежит ни к одной группе хостов.</u> Здесь отображается страница развертывания ЕдиногоАгента, отфильтрованная по выбранной группе хостов. Для каждого хоста в списке есть ссылка '''Группа хостов''': <code><group name></code>, где <code><group name></code>— это имя группы хостов, которую вы хотите настроить.<br />
# Выберите имя группы хостов в любой строке. <br />Поскольку вы отфильтровали данные по группе хостов, все отображаемые хосты будут отнесены к одной и той же группе.<br />
# В настройках группы хостов выберите '''Контроллер выполнения расширений'''.<br />
# Включите параметр '''Контроллер выполнения расширений'''.<br />
<br />
== Двоичное местоположение ==<br />
Расположение инструмента зависит от того, настраивали ли вы установку ЕдиногоАгента с помощью параметра <code><INSTALL_PATH></code>:<br />
<br />
* Linux : <code><INSTALL_PATH>/agent/tools</code> по умолчанию <code>/opt/astromkey/oneagent/agent/tools</code><br />
* Развертывание на основе Docker (<code><INSTALL_PATH>/agent/tools</code> по умолчанию). <code>/opt/astromkey/oneagent/agent/tools</code> <br />Обратите внимание, что этот путь будет отличаться для развертывания на основе томов.<br />
* Windows : <code><INSTALL_PATH>\agent\tools</code> по умолчанию <code>%PROGRAMFILES%\astromkey\oneagent\agent\tools</code><br />
<br />
== Информация о топологии ==<br />
Благодаря интеграции <code>astromkey_ingest</code> со скриптами, идентификатор хоста и контекст имени хоста автоматически добавляются к каждой метрике в качестве измерений. Узнайте, как [[Расширение данных|обогатить ваши метрики другими измерениями, специфичными для Ключ-АСТРОМ]], и применить детали причинно-следственной связи ИИ к вашим загруженным данным.<br />
<br />
== Формат метрики ==<br />
Предоставляемые данные должны соответствовать протоколу сбора метрик.<br />
<br />
== Использование ==<br />
Основное применение:<br />
{| class="wikitable"<br />
|astromkey_ingest [Options] [Metrics]<br />
|}<br />
Оба параметра <code>[Options]</code> и <code>[Metrics]</code> являются необязательными. Синтаксис метрик, передаваемых в качестве аргументов <code>[Metrics]</code>, должен соответствовать протоколу приема метрик.<br />
<br />
Существует два основных способа передачи метрик <code>astromkey_ingest</code>: (1) путем перенаправления выходных данных другого процесса в <code>astromkey_ingest</code>, или (2) с использованием аргументов вызова.<br />
<br />
=== Перенаправление вывода процесса ===<br />
Если метрики не указаны, <code>astromkey_ingest</code> предполагается, что они будут переданы через стандартный ввод. Каждая строка рассматривается как одна метрика. Это позволяет передавать метрики <code>astromkey_ingest</code> из выходных данных других процессов. Например:<br />
{| class="wikitable"<br />
|<nowiki>echo host.process_count `ps aux | wc -l` | astromkey_ingest</nowiki><br />
|}<br />
<br />
=== Вызов аргументов ===<br />
При использовании аргументов вызова вместо стандартного ввода для передачи метрик, передавайте каждую метрику в качестве отдельного аргумента. Например, чтобы передать две метрики с помощью одной команды:<br />
{| class="wikitable"<br />
|astromkey_ingest 'cpu.temperature,cpu=1 55' 'cpu.temperature,cpu=2 45'<br />
|}<br />
<br />
=== Параметры командной строки ===<br />
<code>-v [ --verbose ]</code> - выводит логи в стандартный поток вывода.<br />
<br />
<code>-p [ --port ] arg (=14499)</code> - задает пользовательский порт для связи с модулем OneAgent Extensions Execution Controller (EEC). Если вы измените порт EEC по умолчанию ( <code>14499</code>), необходимо указать <code>astromkey_ingest</code>использовать новый порт.<br />
<br />
<code>-h [ --help ]</code> - выводит справочное сообщение и завершает работу.<br />
<br />
== Порт коммуникаций ==<br />
{| class="wikitable"<br />
|Начиная с версии ЕдиногоАгента 1.267 и выше, системы AIX также поддерживают сбор метрик.<br />
|}<br />
Порт приема метрик по умолчанию — <code>14499</code>. При необходимости вы можете использовать команду [[ЕдиныйАгент настройка через интерфейс командной строки|oneagentctl]] для проверки или изменения порта. Изменение порта приема метрик требует перезапуска ЕдиногоАгента. Добавьте <code>--restart-service</code> к команде для автоматического перезапуска ЕдиногоАгента.<br />
<br />
=== Проверьте входное отверстие ===<br />
Параметр <code>--get-extensions-ingest-port</code> по умолчанию отображает текущий локальный порт приема данных <code>14499</code>.<br />
<br />
* Linux , AIX : <code>./oneagentctl --get-extensions-ingest-port</code><br />
* Windows : <code>.\oneagentctl.exe --get-extensions-ingest-port</code><br />
<br />
=== Укажите пользовательский порт для приема данных ===<br />
Используйте параметр <code>--set-extensions-ingest-port=<arg></code> для установки пользовательского локального порта приема данных.<br />
<br />
* Linux , AIX : <code>./oneagentctl --set-extensions-ingest-port=14499 --restart-service</code><br />
* Windows : <code>.\oneagentctl.exe --set-extensions-ingest-port=14499 --restart-service</code><br />
<br />
=== Настройка прокси ===<br />
Настройте прокси-сервер вашего хоста таким образом, чтобы по умолчанию разрешать трафик с локального хоста, направляемый на порт приема метрик <code>14499</code>.<br />
<br />
Обратите внимание, что изменение порта для интеграции скриптов также влияет на '''REST API ЕдиногоАгента''' и '''Telegraf'''.</div>IKuznetsov