https://doc.ruscomtech.ru/index.php?action=history&feed=atom&title=%D0%9E_%D1%80%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F%D1%85О расширениях - История изменений2026-09-16T14:34:11ZИстория изменений этой страницы в викиMediaWiki 1.43.9https://doc.ruscomtech.ru/index.php?title=%D0%9E_%D1%80%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F%D1%85&diff=5633&oldid=prevIKuznetsov: Новая страница: «== Концепции == === Контроллер выполнения расширений (EEC) === Контроллер выполнения расширен...»2025-09-03T22:35:00Z<p>Новая страница: «== Концепции == === Контроллер выполнения расширений (EEC) === Контроллер выполнения расширен...»</p>
<p><b>Новая страница</b></p><div>== Концепции ==<br />
<br />
=== Контроллер выполнения расширений (EEC) ===<br />
Контроллер выполнения расширений ('''EEC''') — это компонент Ключ-АСТРОМ, который управляет вашими расширениями. '''EEC''' запрашивает данные либо из локальных источников при запуске на ЕдиныйАгент, либо из удалённых источников при запуске из АктивногоШлюза. '''EEC''' автоматически устанавливается и управляется с каждой конфигурацией ЕдиногоАгента и АктивногоШлюза. '''EEC''' также преобразует все полученные данные для анализа причинно-следственных связей в Ключ-АСТРОМ ИИ. Подробнее см. в разделе [[Расширение наблюдаемости метрик|Приём метрик]].<br />
<br />
Для запуска локальных расширений убедитесь, что '''EEC''' включен на уровне среды, хоста или группы хостов.<br />
<br />
==== Включить на уровне среды ====<br />
<br />
# Перейдите в раздел '''Настройки''' и выберите '''Предпочтения''' '''> Контроллер выполнения расширений'''.<br />
# Включите опцию '''Включить контроллер выполнения расширений'''.<br />
# Включите функцию Включить локальный '''API HTTP Metric, Log and Event Ingest'''.<br />
<br />
==== Включить для одного хоста ====<br />
<br />
# Перейдите в раздел '''Хосты'''.<br />
# Найдите и выберите свой хост, чтобы отобразить страницу обзора хостов.<br />
# В правом верхнем углу страницы обзора хоста выберите '''Дополнительно ( … ) > Настройки'''.<br />
# В настройках хоста выберите '''Контроллер выполнения расширений'''.<br />
# Включите опцию '''Включить контроллер выполнения расширений'''.<br />
<br />
==== Включить для группы хостов ====<br />
<br />
# Перейдите в раздел '''Состояние развертывания''', а затем выберите '''ЕдиныеАгенты'''.<br />
# На странице развертывания ЕдиногоАгента отключите опцию '''Показывать новые развертывания ЕдиногоАгента.'''<br />
# Отфильтруйте таблицу по <code>Host group</code> и выберите группу хостов, которую вы хотите настроить. <br />Свойство '''Группа хостов''' не отображается, если выбранный хост не принадлежит ни одной группе хостов. Отобразится страница развёртывания ЕдиногоАгента, отфильтрованная по выбранной группе хостов. Для каждого указанного хоста есть ссылка '''Группа хостов:''' <code><group name></code>, где <code><group name></code>— имя группы хостов, которую нужно настроить.<br />
# Выберите название группы хостов в любой строке. Поскольку вы отфильтровали данные по группе хостов, все отображаемые хосты относятся к одной и той же группе.<br />
# В настройках группы хостов выберите '''Контроллер выполнения расширений'''.<br />
# Включите опцию '''Включить контроллер выполнения расширений'''.<br />
<br />
=== Группа АктивныхШлюзов ===<br />
Ключ-АСТРОМ использует группы АктивныхШлюзов для определения того, где должны запускаться расширения. Каждый ActiveGate, запускающий расширение, должен входить в группу. Если вы планируете использовать один АктивныйШлюз, назначьте его в отдельную группу. Подробнее см. в разделе [[Группы АктивныхШлюзов|Группа АктивныхШлюзов]].<br />
<br />
Вы можете запускать расширения, используя Среду АктивногоШлюза, установленную для [[Направление трафика ЕдиногоАгента|маршрутизации трафика ЕдиногоАгента в Ключ-АСТРОМ, а также для мониторинга облачных сред и удаленных технологий с использованием расширений.]]<br />
{| class="wikitable"<br />
|Кластерные АктивныеШлюзы и мультисредовые АктивныеШлюзы не поддерживаются для платформы Расширения.<br />
|}<br />
<br />
=== Профиль производительности ===<br />
<code>ЕдиныйАгент версии 1.243+</code> Вы можете установить лимит потребления ресурсов в разделе '''Профиль производительности'''. По умолчанию один процесс источника данных занимает до 2% ресурсов ЦП и 100 МБ ОЗУ в ЕдиномАгенте и 5% ресурсов ЦП и 500 МБ ОЗУ в АктивномШлюзе.<br />
<br />
Ограничения на ресурсы ЦП и ОЗУ применяются к сумме ресурсов, потребляемых EEC и всеми процессами источников данных. Процесс состоит из двух этапов:<br />
<br />
* '''Софт лимит''' — каждый входящий тест отклоняется, если потребление превышает лимит. Этот этап применим только к АктивномуШлюзу.<br />
* '''Хард лимит''' — последней начатая задача останавливается и отклоняется первой.<br />
** В ЕдиномАгенте задачи останавливаются и перезапускаются с задержкой. Время задержки увеличивается по мере перезапуска процесса.<br />
** В АкивномШлюзе задачи останавливаются и отклоняются до тех пор, пока потребление не станет ниже лимита.<br />
<br />
==== Изменить профиль производительности на уровне среды ====<br />
<br />
# Перейдите в '''Настройки > Предпочтения > Контроллер выполнения расширений'''.<br />
# Установите для параметра '''Профиль производительности''' значение <code>Default</code> или <code>High limits</code>.<br />
<br />
==== Изменить профиль производительности на уровне хоста ====<br />
<br />
# Перейдите в раздел '''Хосты'''.<br />
# Найдите и выберите свой хост, чтобы отобразить страницу обзора хостов.<br />
# В правом верхнем углу страницы обзора хоста выберите '''Дополнительно ( … ) > Настройки'''.<br />
# В настройках хоста выберите '''Контроллер выполнения расширений'''.<br />
# Установите для параметра '''Профиль производительности''' значение <code>Default</code> или <code>High limits</code>.<br />
<br />
==== Изменить профиль производительности АктивногоШлюза ====<br />
<br />
# Перейдите в раздел '''Состояние развертывания''' и выберите АктивныеШлюзы.<br />
# Разверните сведения об АктивномШлюзе, который вы хотите настроить, и выберите '''Настройки'''.<br />
# На странице настроек перейдите в раздел '''Контроллер выполнения расширений'''.<br />
# Установите '''Профиль производительности''' на <code>Default</code>, <code>High limits</code>, или <code>Dedicated limits</code>.<br />
<br />
{| class="wikitable"<br />
|Вы можете включить функцию <code>Dedicated limits</code> только после настройки АктивногоШлюза, как описано в разделе [[Специальная конфигурация профиля производительности|Настройка выделенного профиля производительности]].<br />
|}<br />
<br />
=== Конфигурация среды ===<br />
'''Конфигурация среды''' — это универсальный набор определений мониторинга, адаптированных к специфике вашего источника данных, например, '''SNMP'''. Конфигурация среды хранится в виде файла <code>extension.yaml</code>, загружаемого в Ключ-АСТРОМ в составе '''ZIP-архива''' расширения. Конфигурация среды определяет:<br />
<br />
* '''Объем собираемых данных''': какие показатели учитываются и каким измерениям они должны быть присвоены.<br />
* '''Источник''', из которого извлекаются измерения и значения размеров.<br />
* '''Категория данных''' по наборам признаков, которые можно выбрать при определении конфигурации мониторинга.<br />
* '''Как строятся метрики''' в контексте протокола приема метрик.<br />
* '''Как Ключ-АСТРОМ обрабатывает и представляет данные''', собранные расширением.<br />
<br />
Ваша среда может хранить до '''10''' конфигураций для каждого расширения. В любой момент времени может быть активна только одна конфигурация. Чтобы активировать определённую конфигурацию, переведите переключатель '''Включено'''.<br />
<br />
Без конфигурации среды расширение невидимо для платформы Ключ-АСТРОМ.<br />
<br />
=== Конфигурация мониторинга ===<br />
Конфигурация мониторинга зависит от типа источника данных, который вы хотите отслеживать. Она определяет:<br />
<br />
* '''Место''', где начинается расширение.<br />
* Для удаленных расширений — '''конечные точки''', которые расширение вызывает для сбора данных, а также учетные данные для доступа к ним.<br />
* '''Свойства подключения''', такие как время ожидания и количество повторных попыток в случае неудачного подключения.<br />
* '''Значения переменных''', которые будут переданы в конфигурацию среды, когда необходимо настроить расширение под специфику вашего экземпляра источника данных.<br />
<br />
Вы можете создать до '''100''' конфигураций мониторинга на основе одной конфигурации среды, и каждая из них будет работать параллельно.<br />
<br />
Чтобы начать мониторинг с помощью расширения, необходимо использовать вызов '''API''' для добавления конфигурации мониторинга, которая сообщит Ключ-АСТРОМ, как собирать данные из вашего источника данных.<br />
<br />
Без конфигурации мониторинга расширение отображается на платформе Ключ-АСТРОМ, но не собирает никаких данных.<br />
<br />
* Информацию о создании конфигурации мониторинга, специфичной для Oracle Database, см . в разделе [[Конфигурация Oracle Database|Конфигурация мониторинга Oracle Database]].<br />
* Информацию о создании конфигурации мониторинга, специфичной для базы данных Microsoft, см. в разделе [[Конфигурация Microsoft SQL|Конфигурация мониторинга Microsoft SQL Server]].<br />
* Информацию о создании конфигурации мониторинга, специфичной для базы данных IBM, см. в разделе [[Конфигурация IBM DB2|Конфигурация мониторинга базы данных IBM]].<br />
* Информацию о создании конфигурации мониторинга для конкретной базы данных MySQL, см. в разделе [[Конфигурация MySQL|Конфигурация мониторинга MySQL]].<br />
* Информацию о создании конфигурации мониторинга, специфичной для базы данных PostgreSQL, см. в разделе [[Конфигурация PostgreSQL|Конфигурация мониторинга PostgreSQL]].<br />
* Информацию о создании конфигурации мониторинга, специфичной для базы данных SAP Hana, см. в разделе [[Конфигурация SAP Hana Database|Конфигурация мониторинга базы данных SAP Hana]].<br />
* Информацию о создании конфигурации мониторинга, специфичной для базы данных Snowflake, см. в разделе [[Конфигурация Snowflake Database|Конфигурация мониторинга базы данных Snowflake]].<br />
* Информацию о создании конфигурации мониторинга, специфичной для базы данных JDBC, см. в разделе [[Конфигурация JDBC|Конфигурация мониторинга JDBC]].<br />
<br />
=== Пакет расширений ===<br />
Расширения предоставляются в виде ZIP-пакета, содержащего только:<br />
{| class="wikitable"<br />
!Файл<br />
!Описание<br />
|-<br />
|<code>extension.zip</code><br />
|Архив, содержащий фактическое определение расширения со всеми его активами.<br />
|-<br />
|<code>extension.zip.sig</code><br />
|Файл подписи: цифровая подпись для ZIP-архива. Он гарантирует целостность и подлинность содержимого ZIP-файла, проверяя, что оно не было изменено и подписано доверенным источником.<br />
<br />
Подробную информацию см. в разделе [[Расширения знаков|Расширения подписей]].<br />
|-<br />
|<code>extension.zip.sig.tsr</code><br />
|Файл временной метки подписи, используемый для обеспечения действительности подписи с течением времени (обрабатывается только для официальных расширений).<br />
|}<br />
Пакеты расширений с другим содержимым не принимаются к загрузке. Максимальный размер пакета расширения — 25 МБ.<br />
{| class="wikitable"<br />
|bundle.zip<br />
<br />
│ extension.zip<br />
<br />
│ extension.zip.sig<br />
<br />
│ extension.zip.sig.tsr<br />
|}<br />
<br />
=== Astromkey CLI ===<br />
'''Astromkey CLI''' (<code>dt-cli</code>) — это утилита командной строки, которая помогает разрабатывать, подписывать и создавать расширения для платформы '''Расширения''' '''Ключ-АСТРОМ'''.<br />
<br />
С '''Astromkey CLI''' вы можете:<br />
<br />
* Сборка и подписание расширений из исходного кода<br />
* Генерация сертификатов разработки для подписи расширений<br />
* Генерация сертификатов CA для разработки<br />
<br />
Подробности смотрите в разделе [[Расширения знаков|Расширение знаков]] и проект [https://github.com/dynatrace-oss/dt-cli dt-cli] на GitHub.<br />
<br />
=== Наборы функций ===<br />
'''Набор функций''' — это группа ключей метрик, определяемых в конфигурации расширения. Вы можете активировать или деактивировать группы функций в пользовательском интерфейсе или в '''JSON'''-файле. При активации набора функций все метрики из этого набора включаются в отчёт. Если метрика не входит в набор функций, она всегда включается в отчёт. <br />
<br />
Представьте себе расширение '''SNMP''', которое отслеживает сетевые устройства и собирает метрики, связанные с состоянием сетевой карты, транспортным уровнем и '''SNMP'''-ловушками. Вы можете использовать наборы функций для настройки мониторинга, например, активируя только те, которые относятся к определённым устройствам или АктивнымШлюзам. Расширение по-прежнему будет отслеживать другие, не связанные с ним устройства, но не будет сообщать эти метрики.<br />
<br />
=== Конфигурации и ограничения ===<br />
Перед развертыванием расширений ознакомьтесь с текущими [[Ограничения расширений|ограничениями]], чтобы обеспечить эффективное достижение ваших целей мониторинга.<br />
<br />
=== Контроль доступа и необходимые разрешения ===<br />
Работа с расширениями требует специальных разрешений для управления жизненным циклом расширений, настройки мониторинга и защиты конфиденциальных данных.<br />
<br />
* Если вы используете Ключ-АСТРОМ, для изменения конфигурации мониторинга вам необходимо классическое разрешение '''Управление параметрами мониторинга''' в вашей группе.<br />
* Если вы аутентифицируете '''API''' с помощью токена арендатора, вашему токену потребуются соответствующие <code>extensions.read</code> и <code>extensions.write</code> разрешения.</div>IKuznetsov