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

2025-06-10T17:30:06Z

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

Новая страница

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

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

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

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

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

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

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

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

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

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

==== Профиль производительности ====
'''''ЕдиныйАгент версии 1.243+'''''

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

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

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

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

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

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

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

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

# Перейдите в раздел '''Установленные модули''' и выберите АктивныеШлюзы.
# Разверните сведения об АктивныхШлюзах, который вы хотите настроить, и выберите '''Настройки''' .
# На странице настроек перейдите в раздел '''Контроллер расширений'''.
# Установите для профиля производительности значение <code>По умолчанию</code>, <code>Высокие лимиты</code>, или <code>Выделенные лимиты</code>. Включение настройки <code>Выделенные лимиты</code> возможно только после настройки АктивногоШлюза, как описано в разделе [[Настройка специализированного профиля производительности]].

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

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

* Prometheus
* SNMP
* SNMP traps
* WMI
* SQL
* JMX

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

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

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

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

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

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

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

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

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

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

== Пакет расширения ==
Расширения предоставляются в виде '''ZIP-пакета''', содержащего только архив <code>extension.zip</code> и файл подписи <code>extension.zip.sig</code>. Пакеты расширений с другим содержимым не принимаются к загрузке. Максимальный размер пакета расширения составляет '''25 МБ'''.
{| class="wikitable"
|bundle.zip

│ extension.zip

│ extension.zip.sig
|}

=== Расширение ZIP-архива ===
Архив содержит

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

Например:
{| class="wikitable"
|extension.zip

│ extension.yaml

│

└───alerts

│ | alert.json

│

└───dashboards

│ dashboard.json
|}

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

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

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

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

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

Подробную информацию см. в разделе [[Расширения знаков]] и проект <code>ka-cli</code> на [https://github.com/dynatrace-oss/dt-cli GitHub].

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

== Ограничения ==

=== Расширения ===
{| class="wikitable"
!Сущность
!Ограничение
!Подробности
|-
|Панели управления
|10
|Максимальное количество панелей мониторинга, которые можно определить для одного расширения.
|-
|Оповещения
|<code>Ключ-АСТРОМ версии 1.304+</code> 100

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

=== Ограничения по типу источника данных ===
Более подробную информацию об источниках данных см. в разделе '''Тип источника данных''' (выше).
{| class="wikitable"
!Сущность
!SNMP
!SNMP traps
!WMI
!Prometheus
!SQL
|-
|Группы
|10
|10
|10
|10
|20
|-
|Подгруппы 1
|10
|Н/Д
|25
|10
|20
|-
|Размеры 2
|20
|5
|25
|25
|25
|}
1 Количество подгрупп, которые может содержать каждая группа. Для некоторых источников данных добавление подгрупп недоступно.

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

=== Среда ===
{| class="wikitable"
!Сущность
!Ограничение
!Описание
|-
|Расширения
|250
|Ваша среда может управлять до 250 расширениями.
|-
|Версии расширения
|10
|Ваша среда может управлять 10 версиями одного расширения.
|}

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

==== Удаленная активация ====
Вы можете определить до '''20 000''' устройств для одной конфигурации мониторинга. Конфигурации делятся на сегменты, с размером по умолчанию '''100''' устройств на сегмент. Каждый сегмент устройств опрашивается независимо как отдельный процесс на одном из АктивныхШлюзов в группе. Эта функция автоматически включается для расширений '''WMI''', '''Prometheus''', '''SNMP''' и '''SQL''', тогда как для других типов расширений ее активация зависит от конкретного расширения.
{| class="wikitable"
!Сущность
!SNMP
!SNMP traps
!WMI
!Prometheus
!SQL
|-
|Устройства
|20 000
|100
|20 000
|20 000
|20 000
|}
{| class="wikitable"
|'''Пределы удаленного мониторинга WMI'''

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

В настоящее время ограничение составляет 100 запросов. Например, если ваше расширение использует 5 запросов, настройка более 20 устройств может привести к проблемам с производительностью и пробелам в данных мониторинга.
|}

==== Локальная активация ====
{| class="wikitable"
!Сущность
!WMI
!Prometheus
|-
|Устройства
|20 000
|100
|}

=== Метрический прием ===
{| class="wikitable"
!Сущность
!Ограничение
!Описание
|-
|Длина метрического ключа, символов
|250
|Общая длина метрического ключа, включая префикс.
|-
|Длина ключа измерения, символов
|100
|Общая длина размерного ключа.
|-
|Длина значения размера, символов
|250
|Общая длина размерного значения.
|-
|Количество измерений в строке
|50
|Количество измерений в одной строке полезной нагрузки.
|-
|Общее количество возможных ключей метрик на среду
|20 000
|Максимальное количество ключей метрик, которые можно зарегистрировать в Ключ-АСТРОМ.
|-
|Количество кортежей в месяц на метрику
|1 000 000
|Максимальное количество кортежей (уникальных комбинаций метрики-ключа измерения-значения измерения-типа полезной нагрузки) для каждого ключа метрики за последние 30 дней.
|-
|Количество кортежей в месяц для всех пользовательских метрик
|50 000 000
|Максимальное количество кортежей (уникальных комбинаций метрики-ключа измерения-значения измерения-типа полезной нагрузки) для всех пользовательских метрик за последние 30 дней.
|-
|Длина строки, символов
|50 000
|Максимальная длина одной строки полезной нагрузки.
|}
Также существует ограничение на количество показателей, которые может обработать Ключ-АСТРОМ.
{| class="wikitable"
!Канал
!Ограничение
|-
|API метрики ЕдиногоАгента
|В минуту на экземпляр ЕдиногоАгента:

<code>ЕдиныйАгент версии 1.213 и более ранних</code> 1000

<code>ЕдиныйАгент версии 1.215+</code> 100,000
|-
|API метрик v2
|Ограничений по количеству метрик нет, но применяется регулирование API .
|}

=== Потребление ресурсов ===
В следующей таблице:

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

==== ЕдиныйАгент ====
{| class="wikitable"
!Профиль производительности
!CPU
!RAM
!CPU (soft limit)
!RAM (soft limit)
!CPU (hard limit)
!RAM (hard limit)
|-
| colspan="3" |По каждому экземпляру
| colspan="4" |Для всех процессов источника данных
|-
|По умолчанию
|2%
|100 МБ
|Н/Д
|Н/Д
|5%
|15%
|-
|Высокие лимиты
|5%
|200 МБ
|Н/Д
|Н/Д
|15%
|25%
|}

==== АктивныйШлюз ====
{| class="wikitable"
!Профиль производительности
!CPU
!RAM
!CPU (soft limit)
!RAM (soft limit)
!CPU (hard limit)
!RAM (hard limit)
|-
| colspan="3" |По конфигурации
| colspan="4" |Для всех процессов источника данных
|-
|По умолчанию
|5%
|500 МБ
|10%
|20%
|20%
|30%
|-
|Высокие лимиты
|15%
|700 МБ
|45%
|30%
|60%
|40%
|-
|Преданный
|30%
|1500 МБ
|70%
|50%
|85%
|70%
|}

=== Общие типы и отношения ===
Управление несколькими расширениями в Ключ-АСТРОМ может привести к столкновению с ограничениями, связанными с общими типами и настройками отношений. Чтобы предотвратить эти потенциальные проблемы, см. таблицу ниже.
{| class="wikitable"
!Пределы количества значений
!Значения по умолчанию
!Soft limit
!Hard limit
|-
|<code>builtin:monitoredentities.generic.relation</code>
|100
|500
|500
|-
|<code>builtin:monitoredentities.generic.type</code>
|100
|
|500
|}

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

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

Концепции расширений 2.0 - История изменений

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