О расширениях

Материал из Документация Ключ-АСТРОМ

Концепции

Контроллер выполнения расширений (EEC)

Контроллер выполнения расширений (EEC) — это компонент Ключ-АСТРОМ, который управляет вашими расширениями. EEC запрашивает данные либо из локальных источников при запуске на ЕдиныйАгент, либо из удалённых источников при запуске из АктивногоШлюза. EEC автоматически устанавливается и управляется с каждой конфигурацией ЕдиногоАгента и АктивногоШлюза. EEC также преобразует все полученные данные для анализа причинно-следственных связей в Ключ-АСТРОМ ИИ. Подробнее см. в разделе Приём метрик.

Для запуска локальных расширений убедитесь, что EEC включен на уровне среды, хоста или группы хостов.

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

  1. Перейдите в раздел Настройки и выберите Предпочтения > Контроллер выполнения расширений.
  2. Включите опцию Включить контроллер выполнения расширений.
  3. Включите функцию Включить локальный API HTTP Metric, Log and Event Ingest.

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

  1. Перейдите в раздел Хосты.
  2. Найдите и выберите свой хост, чтобы отобразить страницу обзора хостов.
  3. В правом верхнем углу страницы обзора хоста выберите Дополнительно ( … ) > Настройки.
  4. В настройках хоста выберите Контроллер выполнения расширений.
  5. Включите опцию Включить контроллер выполнения расширений.

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

  1. Перейдите в раздел Состояние развертывания, а затем выберите ЕдиныеАгенты.
  2. На странице развертывания ЕдиногоАгента отключите опцию Показывать новые развертывания ЕдиногоАгента.
  3. Отфильтруйте таблицу по Host group и выберите группу хостов, которую вы хотите настроить.
    Свойство Группа хостов не отображается, если выбранный хост не принадлежит ни одной группе хостов. Отобразится страница развёртывания ЕдиногоАгента, отфильтрованная по выбранной группе хостов. Для каждого указанного хоста есть ссылка Группа хостов: <group name>, где <group name>— имя группы хостов, которую нужно настроить.
  4. Выберите название группы хостов в любой строке. Поскольку вы отфильтровали данные по группе хостов, все отображаемые хосты относятся к одной и той же группе.
  5. В настройках группы хостов выберите Контроллер выполнения расширений.
  6. Включите опцию Включить контроллер выполнения расширений.

Группа АктивныхШлюзов

Ключ-АСТРОМ использует группы АктивныхШлюзов для определения того, где должны запускаться расширения. Каждый ActiveGate, запускающий расширение, должен входить в группу. Если вы планируете использовать один АктивныйШлюз, назначьте его в отдельную группу. Подробнее см. в разделе Группа АктивныхШлюзов.

Вы можете запускать расширения, используя Среду АктивногоШлюза, установленную для маршрутизации трафика ЕдиногоАгента в Ключ-АСТРОМ, а также для мониторинга облачных сред и удаленных технологий с использованием расширений.

Кластерные АктивныеШлюзы и мультисредовые АктивныеШлюзы не поддерживаются для платформы Расширения.

Профиль производительности

ЕдиныйАгент версии 1.243+ Вы можете установить лимит потребления ресурсов в разделе Профиль производительности. По умолчанию один процесс источника данных занимает до 2% ресурсов ЦП и 100 МБ ОЗУ в ЕдиномАгенте и 5% ресурсов ЦП и 500 МБ ОЗУ в АктивномШлюзе.

Ограничения на ресурсы ЦП и ОЗУ применяются к сумме ресурсов, потребляемых EEC и всеми процессами источников данных. Процесс состоит из двух этапов:

  • Софт лимит — каждый входящий тест отклоняется, если потребление превышает лимит. Этот этап применим только к АктивномуШлюзу.
  • Хард лимит — последней начатая задача останавливается и отклоняется первой.
    • В ЕдиномАгенте задачи останавливаются и перезапускаются с задержкой. Время задержки увеличивается по мере перезапуска процесса.
    • В АкивномШлюзе задачи останавливаются и отклоняются до тех пор, пока потребление не станет ниже лимита.

Изменить профиль производительности на уровне среды

  1. Перейдите в Настройки > Предпочтения > Контроллер выполнения расширений.
  2. Установите для параметра Профиль производительности значение Default или High limits.

Изменить профиль производительности на уровне хоста

  1. Перейдите в раздел Хосты.
  2. Найдите и выберите свой хост, чтобы отобразить страницу обзора хостов.
  3. В правом верхнем углу страницы обзора хоста выберите Дополнительно ( … ) > Настройки.
  4. В настройках хоста выберите Контроллер выполнения расширений.
  5. Установите для параметра Профиль производительности значение Default или High limits.

Изменить профиль производительности АктивногоШлюза

  1. Перейдите в раздел Состояние развертывания и выберите АктивныеШлюзы.
  2. Разверните сведения об АктивномШлюзе, который вы хотите настроить, и выберите Настройки.
  3. На странице настроек перейдите в раздел Контроллер выполнения расширений.
  4. Установите Профиль производительности на Default, High limits, или Dedicated limits.
Вы можете включить функцию Dedicated limits только после настройки АктивногоШлюза, как описано в разделе Настройка выделенного профиля производительности.

Конфигурация среды

Конфигурация среды — это универсальный набор определений мониторинга, адаптированных к специфике вашего источника данных, например, SNMP. Конфигурация среды хранится в виде файла extension.yaml, загружаемого в Ключ-АСТРОМ в составе ZIP-архива расширения. Конфигурация среды определяет:

  • Объем собираемых данных: какие показатели учитываются и каким измерениям они должны быть присвоены.
  • Источник, из которого извлекаются измерения и значения размеров.
  • Категория данных по наборам признаков, которые можно выбрать при определении конфигурации мониторинга.
  • Как строятся метрики в контексте протокола приема метрик.
  • Как Ключ-АСТРОМ обрабатывает и представляет данные, собранные расширением.

Ваша среда может хранить до 10 конфигураций для каждого расширения. В любой момент времени может быть активна только одна конфигурация. Чтобы активировать определённую конфигурацию, переведите переключатель Включено.

Без конфигурации среды расширение невидимо для платформы Ключ-АСТРОМ.

Конфигурация мониторинга

Конфигурация мониторинга зависит от типа источника данных, который вы хотите отслеживать. Она определяет:

  • Место, где начинается расширение.
  • Для удаленных расширений — конечные точки, которые расширение вызывает для сбора данных, а также учетные данные для доступа к ним.
  • Свойства подключения, такие как время ожидания и количество повторных попыток в случае неудачного подключения.
  • Значения переменных, которые будут переданы в конфигурацию среды, когда необходимо настроить расширение под специфику вашего экземпляра источника данных.

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

Чтобы начать мониторинг с помощью расширения, необходимо использовать вызов API для добавления конфигурации мониторинга, которая сообщит Ключ-АСТРОМ, как собирать данные из вашего источника данных.

Без конфигурации мониторинга расширение отображается на платформе Ключ-АСТРОМ, но не собирает никаких данных.

Пакет расширений

Расширения предоставляются в виде ZIP-пакета, содержащего только:

Файл Описание
extension.zip Архив, содержащий фактическое определение расширения со всеми его активами.
extension.zip.sig Файл подписи: цифровая подпись для ZIP-архива. Он гарантирует целостность и подлинность содержимого ZIP-файла, проверяя, что оно не было изменено и подписано доверенным источником.

Подробную информацию см. в разделе Расширения подписей.

extension.zip.sig.tsr Файл временной метки подписи, используемый для обеспечения действительности подписи с течением времени (обрабатывается только для официальных расширений).

Пакеты расширений с другим содержимым не принимаются к загрузке. Максимальный размер пакета расширения — 25 МБ.

bundle.zip

│   extension.zip

│   extension.zip.sig

│   extension.zip.sig.tsr

Astromkey CLI

Astromkey CLI (dt-cli) — это утилита командной строки, которая помогает разрабатывать, подписывать и создавать расширения для платформы Расширения Ключ-АСТРОМ.

С Astromkey CLI вы можете:

  • Сборка и подписание расширений из исходного кода
  • Генерация сертификатов разработки для подписи расширений
  • Генерация сертификатов CA для разработки

Подробности смотрите в разделе Расширение знаков и проект dt-cli на GitHub.

Наборы функций

Набор функций — это группа ключей метрик, определяемых в конфигурации расширения. Вы можете активировать или деактивировать группы функций в пользовательском интерфейсе или в JSON-файле. При активации набора функций все метрики из этого набора включаются в отчёт. Если метрика не входит в набор функций, она всегда включается в отчёт.

Представьте себе расширение SNMP, которое отслеживает сетевые устройства и собирает метрики, связанные с состоянием сетевой карты, транспортным уровнем и SNMP-ловушками. Вы можете использовать наборы функций для настройки мониторинга, например, активируя только те, которые относятся к определённым устройствам или АктивнымШлюзам. Расширение по-прежнему будет отслеживать другие, не связанные с ним устройства, но не будет сообщать эти метрики.

Конфигурации и ограничения

Перед развертыванием расширений ознакомьтесь с текущими ограничениями, чтобы обеспечить эффективное достижение ваших целей мониторинга.

Контроль доступа и необходимые разрешения

Работа с расширениями требует специальных разрешений для управления жизненным циклом расширений, настройки мониторинга и защиты конфиденциальных данных.

  • Если вы используете Ключ-АСТРОМ, для изменения конфигурации мониторинга вам необходимо классическое разрешение Управление параметрами мониторинга в вашей группе.
  • Если вы аутентифицируете API с помощью токена арендатора, вашему токену потребуются соответствующие extensions.read и extensions.write разрешения.
Источник — https://doc.fit4u.kz/index.php?title=О_расширениях&oldid=5633