Концепции расширений 2.0

Ознакомьтесь с основными концепциями Расширений 2.0, чтобы понять структуру и основы мониторинга на основе Расширений 2.0.

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

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

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

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

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

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

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

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

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

1. В настройках группы хостов выберите Контроллер расширений.
2. Включите функцию Включить контроллер выполнения расширений.

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

ЕдиныйАгент версии 1.243+

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

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

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

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

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

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

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

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

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

Тип источника данных

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

В настоящее время Ключ-АСТРОМ предоставляет вам интерфейс для сбора индивидуальных данных из:

• Prometheus
• SNMP
• SNMP traps
• WMI
• SQL
• JMX

Жизненный цикл Расширений 2.0

API Ключ-АСТРОМ позволяет вам управлять полным жизненным циклом вашей среды Расширения 2.0. Подробности и примеры см. в разделе Жизненный цикл расширений 2.0.

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

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

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

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

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

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

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

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

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

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

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

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

Расширения предоставляются в виде ZIP-пакета, содержащего только архив extension.zip и файл подписи extension.zip.sig. Пакеты расширений с другим содержимым не принимаются к загрузке. Максимальный размер пакета расширения составляет 25 МБ.

bundle.zip │   extension.zip │   extension.zip.sig

Расширение ZIP-архива

Архив содержит

• Расширение файла YAML, определяющее конфигурацию среды.
• Ресурсы

Например:

extension.zip │   extension.yaml │ └───alerts │   |   alert.json │ └───dashboards     │   dashboard.json

Цифровая подпись

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

Когда вы получаете продление от Ключ-АСТРОМ, оно уже автоматически подписано.

Astromkey CLI

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

Это позволяет вам:

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

Подробную информацию см. в разделе Расширения знаков и проект ka-cli на GitHub.

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

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

Ограничения

Расширения

Сущность	Ограничение	Подробности
Панели управления	10	Максимальное количество панелей мониторинга, которые можно определить для одного расширения.
Оповещения	Ключ-АСТРОМ версии 1.304+ 100 Ключ-АСТРОМ версии 1.303 и более ранних 10	Максимальное количество оповещений для одного расширения. Лимит оповещений для одного расширения обусловлен схемой определения и зависит от выбранного minAstromkeyVersion.
Метрики (общие для расширения)	500	Предел метрик, которые вы можете определить для всего расширения.
Метрики (по уровню)	100	Предел метрик, которые вы можете определить для каждого уровня (расширение, группа, подгруппа) декларативных расширений.
Размер ZIP-пакета	25 МБ	Лимит для одного расширенного ZIP-пакета.
Конфигурации, обрабатываемые АктивнымШлюзом или ЕдинымАгентом	100	Предел конфигураций, которые могут быть запущены одновременно на АктивномШлюзе или ЕдиномАгенте. Для удаленной активации одна конфигурация может быть разделена на сегменты, и каждый сегмент рассматривается как отдельная конфигурация.

Ограничения по типу источника данных

Более подробную информацию об источниках данных см. в разделе Тип источника данных (выше).

Сущность	SNMP	SNMP traps	WMI	Prometheus	SQL
Группы	10	10	10	10	20
Подгруппы 1	10	Н/Д	25	10	20
Размеры 2	20	5	25	25	25

¹ Количество подгрупп, которые может содержать каждая группа. Для некоторых источников данных добавление подгрупп недоступно.

² В файле расширения YAML можно определить количество измерений для каждого уровня (расширение, группа, подгруппа).

Среда

Сущность	Ограничение	Описание
Расширения	250	Ваша среда может управлять до 250 расширениями.
Версии расширения	10	Ваша среда может управлять 10 версиями одного расширения.

Конфигурация мониторинга устройства для каждого источника данных

Удаленная активация

Вы можете определить до 20 000 устройств для одной конфигурации мониторинга. Конфигурации делятся на сегменты, с размером по умолчанию 100 устройств на сегмент. Каждый сегмент устройств опрашивается независимо как отдельный процесс на одном из АктивныхШлюзов в группе. Эта функция автоматически включается для расширений WMI, Prometheus, SNMP и SQL, тогда как для других типов расширений ее активация зависит от конкретного расширения.

Сущность	SNMP	SNMP traps	WMI	Prometheus	SQL
Устройства	20 000	100	20 000	20 000	20 000

Пределы удаленного мониторинга WMI Хотя в одной конфигурации можно ввести до 20 000 устройств, удаленный мониторинг WMI ограничен количеством одновременных запросов WMI, которые могут быть выполнены во внутренней службе Windows, которая их обрабатывает. В настоящее время ограничение составляет 100 запросов. Например, если ваше расширение использует 5 запросов, настройка более 20 устройств может привести к проблемам с производительностью и пробелам в данных мониторинга.

Локальная активация

Сущность	WMI	Prometheus
Устройства	20 000	100

Метрический прием

Сущность	Ограничение	Описание
Длина метрического ключа, символов	250	Общая длина метрического ключа, включая префикс.
Длина ключа измерения, символов	100	Общая длина размерного ключа.
Длина значения размера, символов	250	Общая длина размерного значения.
Количество измерений в строке	50	Количество измерений в одной строке полезной нагрузки.
Общее количество возможных ключей метрик на среду	20 000	Максимальное количество ключей метрик, которые можно зарегистрировать в Ключ-АСТРОМ.
Количество кортежей в месяц на метрику	1 000 000	Максимальное количество кортежей (уникальных комбинаций метрики-ключа измерения-значения измерения-типа полезной нагрузки) для каждого ключа метрики за последние 30 дней.
Количество кортежей в месяц для всех пользовательских метрик	50 000 000	Максимальное количество кортежей (уникальных комбинаций метрики-ключа измерения-значения измерения-типа полезной нагрузки) для всех пользовательских метрик за последние 30 дней.
Длина строки, символов	50 000	Максимальная длина одной строки полезной нагрузки.

Также существует ограничение на количество показателей, которые может обработать Ключ-АСТРОМ.

Канал	Ограничение
API метрики ЕдиногоАгента	В минуту на экземпляр ЕдиногоАгента: ЕдиныйАгент версии 1.213 и более ранних 1000 ЕдиныйАгент версии 1.215+ 100,000
API метрик v2	Ограничений по количеству метрик нет, но применяется регулирование API .

Потребление ресурсов

В следующей таблице:

• Для каждой конфигурации отображается объем потребления для одного источника данных в ЕдиномАгенте и АктивномШлюзе.
• Для всех процессов источника данных относится к сумме ресурсов, потребляемых EEC и всеми процессами источника данных в ЕдиномАгенте и АктивномШлюзе. Каждый процесс источника данных представляет собой одну активацию расширения, назначенную данному хосту или группе АктивногоШлюза.

ЕдиныйАгент

Профиль производительности	CPU	RAM	CPU (soft limit)	RAM (soft limit)	CPU (hard limit)	RAM (hard limit)
По каждому экземпляру			Для всех процессов источника данных
По умолчанию	2%	100 МБ	Н/Д	Н/Д	5%	15%
Высокие лимиты	5%	200 МБ	Н/Д	Н/Д	15%	25%

АктивныйШлюз

Профиль производительности	CPU	RAM	CPU (soft limit)	RAM (soft limit)	CPU (hard limit)	RAM (hard limit)
По конфигурации			Для всех процессов источника данных
По умолчанию	5%	500 МБ	10%	20%	20%	30%
Высокие лимиты	15%	700 МБ	45%	30%	60%	40%
Преданный	30%	1500 МБ	70%	50%	85%	70%

Общие типы и отношения

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

Пределы количества значений	Значения по умолчанию	Soft limit	Hard limit
builtin:monitoredentities.generic.relation	100	500	500
builtin:monitoredentities.generic.type	100		500

Контроль доступа

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