<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="ru">
	<id>https://doc.ruscomtech.ru/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Azubarev</id>
	<title>Документация Ключ-АСТРОМ - Вклад [ru]</title>
	<link rel="self" type="application/atom+xml" href="https://doc.ruscomtech.ru/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Azubarev"/>
	<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php/%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:%D0%92%D0%BA%D0%BB%D0%B0%D0%B4/Azubarev"/>
	<updated>2026-10-06T14:50:17Z</updated>
	<subtitle>Вклад</subtitle>
	<generator>MediaWiki 1.43.9</generator>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6978</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6978"/>
		<updated>2026-10-02T03:07:36Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak|Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ|Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory|Microsoft Active Directory]]&lt;br /&gt;
* [[Microsoft Exchange Server]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Расширение IBM MQ|IBM MQ]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V|Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix|IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
*[[OpenTelemetry Collector]]&lt;br /&gt;
*[[OpenTelemetry Span Metrics Gateway]]&lt;br /&gt;
*[[RabbitMQ]]&lt;br /&gt;
*[[Prometheus Redis]]&lt;br /&gt;
*[[SOWA Monitor]]&lt;br /&gt;
*[[SOWA]]&lt;br /&gt;
*[[Tomcat JMX]]&lt;br /&gt;
*[[Управление расширениями базы данных SAP Hana|SAP Hana]]&lt;br /&gt;
*[[Расширение HAProxy|HAProxy]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D0%B5_IBM_MQ&amp;diff=6977</id>
		<title>Расширение IBM MQ</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D0%B5_IBM_MQ&amp;diff=6977"/>
		<updated>2026-10-02T03:04:15Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Контролируйте производительность объектов менеджера очередей &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
== Обзор ==&lt;br /&gt;
Благодаря выпуску &#039;&#039;&#039;Extensions Framework 2.0&#039;&#039;&#039; расширения &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; собирайте показатели производительности от ваших менеджеров очередей, работающих локально на вашем хосте ЕдиногоАгента или удаленно с ваших АктивныхШлюзов.&lt;br /&gt;
&lt;br /&gt;
В эту версию включены новые метаданные и метрики.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;u&amp;gt;Получите обзор вашей среды мониторинга &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; с помощью входящей в комплект обзорного дашборда.&amp;lt;/u&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Файл:(8994D60F-DC0B-46AF-8B61-1B53E9FF0DC5).png|граница]]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;u&amp;gt;Для объектов диспетчера очередей предусмотрен экран унифицированного анализа, содержащий всю необходимую информацию о диспетчере очередей — в одном месте.&amp;lt;/u&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Файл:(FAE49B46-3330-4FBC-9F42-A811D3B2EBA7).png|граница]]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;u&amp;gt;На экране UA диспетчера очередей перечислены все очереди и каналы, принадлежащие диспетчеру очередей.&amp;lt;/u&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Файл:(2E5E398A-471C-4AC9-B6D2-6558D28F16EF).png|граница]]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;u&amp;gt;Экран UA диспетчера очередей также содержит информацию о теме и размере логов.&amp;lt;/u&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Файл:(2C2B141B-D76B-4AF9-999C-079D17135B85).png|граница]]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;u&amp;gt;Логи и события, связанные с сущностью диспетчера очередей, также отображаются на экране UA диспетчера очередей, обеспечивая полное представление всех событий, связанных с диспетчером очередей.&amp;lt;/u&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Файл:(96DFA14C-E3AA-4956-A177-19D2C35B7A15).png|граница]]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;u&amp;gt;При использовании локального развертывания (ЕдиныйАгент) на экране унифицированного анализа очереди отображается связь с существующими обнаруженными сущностями.&amp;lt;/u&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Файл:(BF6C8BF9-2DE6-4B96-A5B4-BD3358439803).png|граница]]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;u&amp;gt;Экран унифицированного анализа для объекта &#039;&#039;&#039;Очередь&#039;&#039;&#039; будет отображать другую информацию, если расширение развернуто удаленно.&amp;lt;/u&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Файл:(245E5B80-8E63-4125-A094-D3F5BB2E2F75).png|граница]]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;u&amp;gt;Для сущностей канала предусмотрен экран UA, на котором отображается важная метрическая информация для выбранного канала.&amp;lt;/u&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Файл:(84350D13-30D4-4976-83A5-EE34165B784D).png|граница]]&lt;br /&gt;
&lt;br /&gt;
== Начало работы ==&lt;br /&gt;
&lt;br /&gt;
=== Требования: ===&lt;br /&gt;
&lt;br /&gt;
=== Развертывание ЕдиногоАгента: ===&lt;br /&gt;
&lt;br /&gt;
* ЕдиныйАгент только для &#039;&#039;&#039;Windows&#039;&#039;&#039; или &#039;&#039;&#039;Linux&#039;&#039;&#039;.&lt;br /&gt;
* ЕдиныйАгент должен быть запущен и отслеживать процессы менеджера очередей.&lt;br /&gt;
* Ключ-АСТРОМ версии &amp;lt;code&amp;gt;1.314.0&amp;lt;/code&amp;gt; или новее;&lt;br /&gt;
* &#039;&#039;&#039;IBM MQ 9.1+&#039;&#039;&#039;. &#039;&#039;&#039;IBM&#039;&#039;&#039; прекратила поддержку версии &#039;&#039;&#039;9.0.x&#039;&#039;&#039; с &#039;&#039;&#039;2021 году.&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;Сервер IBM MQ Command&#039;&#039;&#039; должен быть запущен на менеджерах очередей.&lt;br /&gt;
* &#039;&#039;&#039;Библиотеки MQ&#039;&#039;&#039; должны быть указаны в переменной &#039;&#039;&#039;PATH&#039;&#039;&#039; в &#039;&#039;&#039;Windows&#039;&#039;&#039; или в переменной &#039;&#039;&#039;LD_LIBRARY_PATH&#039;&#039;&#039; в &#039;&#039;&#039;Linux&#039;&#039;&#039;. Пользователь, запускающий расширение, должен иметь возможность найти эти библиотеки.&lt;br /&gt;
&lt;br /&gt;
==== Дополнительные требования для систем Linux: ====&lt;br /&gt;
&lt;br /&gt;
* Пользователь, работающий с ЕдинымАгентом (по умолчанию &#039;&#039;&#039;dtuser&#039;&#039;&#039;), также должен иметь права на чтение директорий менеджера очередей &amp;lt;code&amp;gt;/var/mqm/qmgrs/&amp;lt;queue_manager&amp;gt;&amp;lt;/code&amp;gt; и на чтение/запись директорий логов &amp;lt;code&amp;gt;/var/mqm/log&amp;lt;/code&amp;gt;, чтобы можно было выполнить привязку должным образом.&lt;br /&gt;
* Убедитесь, что &#039;&#039;&#039;библиотеки MQ&#039;&#039;&#039; доступны пользователю &amp;lt;code&amp;gt;dtuser&amp;lt;/code&amp;gt;, от имени которого запущена ваша служба ЕдиныйАгент. Расположение этих библиотек по умолчанию: &amp;lt;code&amp;gt;/opt/mqm/lib64&amp;lt;/code&amp;gt;&lt;br /&gt;
* По умолчанию &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; устанавливает файл &#039;&#039;&#039;ldconfig&#039;&#039;&#039; с именем &amp;lt;code&amp;gt;/etc/ld.so.conf.d/mqm.conf&amp;lt;/code&amp;gt;, который добавляет &amp;lt;code&amp;gt;/usr/lib64&amp;lt;/code&amp;gt; в переменную &#039;&#039;&#039;LD_LIBRARY_PATH&#039;&#039;&#039;. Убедитесь, что в этом пути есть символические ссылки библиотек &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; на &amp;lt;code&amp;gt;/opt/mqm/lib64&amp;lt;/code&amp;gt;. Если в каталоге &amp;lt;code&amp;gt;/usr/lib64&amp;lt;/code&amp;gt; нет ссылок на библиотеки &amp;lt;code&amp;gt;/opt/mqm/lib64&amp;lt;/code&amp;gt;, возможно, вам придётся создать собственный файл &#039;&#039;&#039;.conf&#039;&#039;&#039; и поместить его в директорию &amp;lt;code&amp;gt;/etc/ld.so.conf.d/&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Использование &#039;&#039;&#039;ldconfig&#039;&#039;&#039; позволит загружать библиотеки &#039;&#039;&#039;MQ&#039;&#039;&#039; по умолчанию. Для этого выполните следующие действия:&lt;br /&gt;
** Создайте файл &#039;&#039;&#039;.conf&#039;&#039;&#039; в директории &amp;lt;code&amp;gt;/etc/ld.so.conf.d/&amp;lt;/code&amp;gt; с любым именем. Пример: &amp;lt;code&amp;gt;ibmmq_ext.conf&amp;lt;/code&amp;gt;&lt;br /&gt;
** Внутри этого файла введите местоположение библиотек &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;: &amp;lt;code&amp;gt;/opt/mqm/lib64&amp;lt;/code&amp;gt;&lt;br /&gt;
** Сохраните файл&lt;br /&gt;
** Перезагрузите &#039;&#039;&#039;ldconfig&#039;&#039;&#039;, выполнив команду: &amp;lt;code&amp;gt;ldconfig&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Развертывание АктивногоШлюза: ===&lt;br /&gt;
&lt;br /&gt;
* АктивныйШлюз на &#039;&#039;&#039;Windows&#039;&#039;&#039; или &#039;&#039;&#039;Linux&#039;&#039;&#039;&lt;br /&gt;
* Ключ-АСТРОМ версии &#039;&#039;&#039;1.269+&#039;&#039;&#039;&lt;br /&gt;
* &#039;&#039;&#039;IBM MQ 9.1+&#039;&#039;&#039;. &#039;&#039;&#039;IBM&#039;&#039;&#039; прекратила поддержку версии &#039;&#039;&#039;9.0.x&#039;&#039;&#039; с &#039;&#039;&#039;2021 года&#039;&#039;&#039;.&lt;br /&gt;
* &#039;&#039;&#039;Сервер IBM MQ Command&#039;&#039;&#039; должен быть запущен на менеджерах очередей.&lt;br /&gt;
* Поддерживаются &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; на платформах &#039;&#039;&#039;AIX&#039;&#039;&#039;, &#039;&#039;&#039;z/OS&#039;&#039;&#039;, &#039;&#039;&#039;Linux&#039;&#039;&#039;, &#039;&#039;&#039;Windows&#039;&#039;&#039;, &#039;&#039;&#039;zLinux&#039;&#039;&#039; и &#039;&#039;&#039;MQ Appliance&#039;&#039;&#039;. Возможно, он будет работать и на других &#039;&#039;&#039;ОС&#039;&#039;&#039;, но официально они могут не поддерживаться.&lt;br /&gt;
* Канал связи с сервером для связи с каждым менеджером очередей. Он необходим для любого клиентского подключения к &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;.&lt;br /&gt;
* Межсетевой экран от АктивныхШлюзов к менеджерам очередей должен быть открыт. Менеджер очередей может работать на любом порту, поэтому убедитесь, что эти порты открыты для ваших АктивныхШлюзов. Обратитесь к администратору &#039;&#039;&#039;MQ&#039;&#039;&#039;, чтобы узнать эти порты.&lt;br /&gt;
&lt;br /&gt;
== Подробности ==&lt;br /&gt;
&lt;br /&gt;
=== Аутентификация: ===&lt;br /&gt;
В &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; предусмотрено несколько способов аутентификации клиентских и локальных подключений. Выбор способа определяется администратором вашей среды &#039;&#039;&#039;MQ&#039;&#039;&#039; в соответствии с его политиками безопасности.&lt;br /&gt;
&lt;br /&gt;
Аутентификация пользователя зависит от конфигурации аутентификации канала (&amp;lt;code&amp;gt;CHLAUTH&amp;lt;/code&amp;gt;). Если эта функция отключена или отключена &amp;lt;code&amp;gt;ADOPTCTX&amp;lt;/code&amp;gt;, &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; попытается аутентифицировать пользователя, запускающего процесс расширения, а не пользователя, указанного в конфигурации конечной точки.&lt;br /&gt;
&lt;br /&gt;
Если включено &amp;lt;code&amp;gt;ADOPTCTX&amp;lt;/code&amp;gt; и включено &amp;lt;code&amp;gt;CHLAUTH&amp;lt;/code&amp;gt;, комбинация имени пользователя и пароля, введенная в конечной точке, передается в блок &#039;&#039;&#039;MQCSP&#039;&#039;&#039;, который &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; попытается аутентифицировать.&lt;br /&gt;
&lt;br /&gt;
* Пожалуйста, примите это во внимание при аутентификации пользователей или в случае возникновения ошибок.&lt;br /&gt;
&lt;br /&gt;
=== Разрешения пользователей к объектам MQ (распределенные) ===&lt;br /&gt;
[[Файл:(B1EB5EC6-3BE6-4E6F-A09B-568DD459A612).png|граница]]&lt;br /&gt;
&lt;br /&gt;
* Разрешение &#039;&#039;&#039;CHG&#039;&#039;&#039; требуется только для сбора метрик постановки/вывода из очереди . Метрики постановки/вывода из очереди можно получить только после выполнения команды &#039;&#039;&#039;RESET_Q_STATISTICS&#039;&#039;&#039;, поэтому требуются разрешения &#039;&#039;&#039;CHG&#039;&#039;&#039;. Если вы не можете предоставить это разрешение, убедитесь, что вы сняли выбор этих метрик на странице &#039;&#039;&#039;Наборы функций&#039;&#039;&#039; в конфигурации мониторинга.&lt;br /&gt;
&lt;br /&gt;
=== Разрешения пользователей к объектам MQ (z/OS) ===&lt;br /&gt;
[[Файл:Image4046.png|граница]]&lt;br /&gt;
&lt;br /&gt;
Примечание : разрешение &#039;&#039;&#039;CONTROL&#039;&#039;&#039; требуется только при сборе показателей постановки в очередь/вывода из очереди.&lt;br /&gt;
&lt;br /&gt;
=== Сбор показателей постановки/вывода из очереди: ===&lt;br /&gt;
&amp;lt;blockquote&amp;gt;Для получения следующих метрик статистика по очередям сбрасывается. Для этого необходимо предоставить очередям разрешение &#039;&#039;&#039;CHG&#039;&#039;&#039;.&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;&#039;Количество сообщений в очереди&#039;&#039;&#039;: количество сообщений, помещённых в очередь. Это количество включает сообщения, которые были помещены в очередь, но ещё не были зафиксированы.&lt;br /&gt;
* &#039;&#039;&#039;Количество сообщений, извлеченных из очереди&#039;&#039;&#039;: количество сообщений, извлеченных из очереди. Это количество включает сообщения, которые были успешно извлечены из очереди (с помощью &#039;&#039;&#039;MQGET&#039;&#039;&#039;-запроса без просмотра), даже если &#039;&#039;&#039;MQGET&#039;&#039;&#039;-запрос ещё не был зафиксирован.&lt;br /&gt;
* &#039;&#039;&#039;Скорость постановки в очередь&#039;&#039;&#039;: количество сообщений, помещаемых в очередь в секунду.&lt;br /&gt;
* &#039;&#039;&#039;Скорость извлечения из очереди&#039;&#039;&#039;: количество сообщений, извлекаемых из очереди в секунду.&lt;br /&gt;
&lt;br /&gt;
=== Сбор показателей состояния очереди: ===&lt;br /&gt;
&amp;lt;blockquote&amp;gt;Для получения следующих показателей необходимо включить мониторинг очередей. Любое решение мониторинга начнёт сбор этой статистики.&amp;lt;/blockquote&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;&#039;Самое старое сообщение&#039;&#039;&#039;: возраст в секундах самого старого сообщения в очереди.&lt;br /&gt;
* &#039;&#039;&#039;Последний&#039;&#039;&#039; &#039;&#039;&#039;GET&#039;&#039;&#039;: время, когда последнее сообщение было успешно прочитано из очереди.&lt;br /&gt;
* &#039;&#039;&#039;Last PUT&#039;&#039;&#039;: Время, когда последнее сообщение было успешно помещено в очередь.&lt;br /&gt;
* &#039;&#039;&#039;Индикатор короткого времени&#039;&#039;&#039;: количество времени, которое сообщение провело в очереди за короткий период.&lt;br /&gt;
* &#039;&#039;&#039;Индикатор длительного времени&#039;&#039;&#039;: количество времени, в течение которого сообщение находилось в очереди в течение длительного периода.&lt;br /&gt;
&lt;br /&gt;
=== Конфигурация Ключ-АСТРОМ ===&lt;br /&gt;
В &amp;lt;code&amp;gt;Расширения&amp;lt;/code&amp;gt; левом меню выберите &amp;lt;code&amp;gt;IBM MQ&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
* Добавьте конфигурацию мониторинга. Развертывание ЕдиногоАгента, также называемое &#039;&#039;&#039;локальным&#039;&#039;&#039;, может выполняться на определённом хосте, группах хостов, хостах в менеджмент зонах или на отмеченных хостах. Развертывание АктивногоШлюза, также называемое &#039;&#039;&#039;удалённым&#039;&#039;&#039;, выполняется на группах АктивногоШлюза. Для повышения надёжности группы могут включать один или несколько АктивныхШлюзов.&lt;br /&gt;
&lt;br /&gt;
=== Для локального развертывания (ЕдиныйАгент): ===&lt;br /&gt;
&lt;br /&gt;
* Выберите, на каких хостах будет запущено это расширение&lt;br /&gt;
** &#039;&#039;&#039;Уровень логов&#039;&#039;&#039;: включайте &#039;&#039;&#039;DEBUG&#039;&#039;&#039; только в том случае, если специалисты по устранению неполадок или служба поддержки дают такую ​​рекомендацию.&lt;br /&gt;
** &#039;&#039;&#039;Добавить менеджер очередей&#039;&#039;&#039;: все менеджеры очередей, соответствующие фильтру, будут использовать эту конфигурацию. Вы можете создать отдельную конфигурацию для каждого менеджера очередей на хосте или одну конфигурацию для всех менеджеров очередей на этом хосте.&lt;br /&gt;
** &#039;&#039;&#039;Фильтр менеджера очередей&#039;&#039;&#039;: имя, соответствующее этому фильтру, будет сопоставляться с запущенными процессами на этом хосте. Если имя соответствует этому фильтру, к нему будут применены все настройки этой конечной точки конфигурации.&lt;br /&gt;
** &#039;&#039;&#039;Использовать хранилище учётных данных&#039;&#039;&#039;: это позволит вам выбрать имя пользователя и пароль, хранящиеся в хранилище учётных данных Ключ-АСТРОМ. При использовании этой функции любые имя пользователя и пароль, введённые вручную, будут игнорироваться, и будут использоваться только учётные данные, хранящиеся в хранилище.&lt;br /&gt;
** &#039;&#039;&#039;Пользователь&#039;&#039;&#039;: необязательно, но рекомендуется добавить пользователя. В противном случае, если оставить поле пустым, &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; попытается аутентифицировать пользователя &amp;lt;code&amp;gt;dtuser&amp;lt;/code&amp;gt;, запускающего процесс, по умолчанию.&lt;br /&gt;
** &#039;&#039;&#039;Пароль&#039;&#039;&#039;: Пароль указанного выше пользователя.&lt;br /&gt;
** &#039;&#039;&#039;Объекты для мониторинга&#039;&#039;&#039;: два способа добавления объектов.&lt;br /&gt;
*** Используя новый режим, просто нажимайте кнопки для ввода правил. Если есть объект, который вы совершенно не хотите отслеживать, удалите это правило.&lt;br /&gt;
*** В расширенном режиме добавьте фильтры, разделяя их запятыми, под каждой вкладкой. Наведите указатель мыши на значок &amp;lt;code&amp;gt;(&#039;&#039;&#039;i&#039;&#039;&#039;)&amp;lt;/code&amp;gt; рядом с каждым типом объекта, чтобы увидеть правила и примеры.&lt;br /&gt;
*** &#039;&#039;&#039;Примечание&#039;&#039;&#039;: Правила оцениваются последовательно. Таким образом, вы можете включать или исключать объекты из результата предыдущего правила. Например: &amp;lt;code&amp;gt;*, -SYSTEM.*, SYSTEM.CLUSTER*&amp;lt;/code&amp;gt; включит все очереди, а затем удалит те, которые начинаются с &#039;&#039;&#039;SYSTEM&#039;&#039;&#039;, а затем включит те, которые начинаются с &#039;&#039;&#039;SYSTEM.CLUSTER&#039;&#039;&#039;. Обратите особое внимание на порядок ввода правил, независимо от того, используете ли вы обычный или расширенный режим .&lt;br /&gt;
** &#039;&#039;&#039;Отправлять событие логов для очереди недоставленных сообщений&#039;&#039;&#039;: включите этот параметр, чтобы любое событие &#039;&#039;&#039;DLQ&#039;&#039;&#039; в любом менеджере очередей, соответствующем этой конфигурации, запускало событие логов, указывающее на то, что количество сообщений в очереди &#039;&#039;&#039;DLQ&#039;&#039;&#039; превысило пороговое значение. Вы можете создать оповещение на основе этого события логов.﻿&lt;br /&gt;
** &#039;&#039;&#039;Отправлять событие логов при высокой глубине очереди из менеджера очередей&#039;&#039;&#039;: включите этот параметр, чтобы любая соответствующая очередь в любом менеджере очередей в этой конфигурации запускала событие логов при превышении заданного порогового значения глубины. Этот порог настраивается в &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;.&lt;br /&gt;
** &#039;&#039;&#039;Отправлять событие логов при малой глубине очереди из менеджера очередей&#039;&#039;&#039;: включите этот параметр, чтобы любая соответствующая очередь в любом менеджере очередей в этой конфигурации запускала событие логов, если её заданная глубина ниже порогового значения. Это пороговое значение настраивается в &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;.&lt;br /&gt;
** &#039;&#039;&#039;Извлечь топологию для улучшенной трассировки транзакций&#039;&#039;&#039;: включение этого параметра позволит собирать сопоставления для псевдонимов очередей, удалённых очередей и очередей кластера. Эти сопоставления затем отправляются в Ключ-АСТРОМ для дополнения информации о сопоставлениях для улучшенной трассировки транзакций. Сбор этой информации может потребоваться только один раз, если сопоставления в &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; не меняются часто. Если этот параметр включён, введите токен Ключ-АСТРОМ для взаимодействия с &#039;&#039;&#039;API&#039;&#039;&#039; со следующими разрешениями: &amp;lt;code&amp;gt;Read settings&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Write settings&amp;lt;/code&amp;gt;.&lt;br /&gt;
** &#039;&#039;&#039;Переименовать менеджеров очередей&#039;&#039;&#039;: включение этого параметра позволит вам добавлять псевдонимы к менеджерам очередей, соответствующим вашему фильтру (см. выше). Настоящее имя менеджера очередей будет по-прежнему включено в название. Это необходимо только для того, чтобы различать менеджеры очередей с похожими или одинаковыми именами в Ключ-АСТРОМ. Это не приведёт к переименованию менеджеров очередей в &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;.&lt;br /&gt;
** &#039;&#039;&#039;Массовый запрос метрик&#039;&#039;&#039;: включение этого параметра сократит количество запросов к &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; и позволит собирать метрики для очередей и каналов за меньшее количество запросов, тем самым сокращая время и потенциальную нагрузку на процессор. Однако этот параметр потребует предоставления разрешений на все очереди и все каналы, включая объекты &#039;&#039;&#039;SYSTEM&#039;&#039;&#039;. Этот параметр не подходит для крупных сред с большим количеством очередей или каналов.&lt;br /&gt;
** Наконец, выберите, какие наборы &#039;&#039;&#039;характеристик&#039;&#039;&#039; (&#039;&#039;&#039;группы метрик&#039;&#039;&#039;) должна собирать эта конфигурация. Выбор слишком малого количества не обеспечит необходимого уровня прозрачности и может привести к потере важных данных о производительности, а также ключевых показателей, которые можно сопоставить между различными объектами.&lt;br /&gt;
&lt;br /&gt;
[[Файл:Image4047.png|граница]]&lt;br /&gt;
&lt;br /&gt;
=== Для удаленного развертывания (АктивныйШлюз): ===&lt;br /&gt;
&lt;br /&gt;
* Выберите, какая группа АктивныхШлюзов будет запускать это расширение&lt;br /&gt;
** &#039;&#039;&#039;Уровень логов&#039;&#039;&#039;: включайте &#039;&#039;&#039;DEBUG&#039;&#039;&#039; только в том случае, если специалисты по устранению неполадок или служба поддержки дают такую ​​рекомендацию.&lt;br /&gt;
** &#039;&#039;&#039;Размер контейнера задач&#039;&#039;&#039;: по умолчанию все конечные точки, определённые в конфигурации мониторинга, создают задачу. Используйте этот параметр для создания отдельных задач для групп конечных точек, определённых в конфигурации мониторинга. Это позволит оптимизировать использование ресурсов вашего АктивногоШлюза и потенциально распределить выполнение задач между другими АктивнымиШлюзами в вашей группе.&lt;br /&gt;
** &#039;&#039;&#039;Добавить менеджер очередей&#039;&#039;&#039;: нажмите эту кнопку для каждого менеджера очередей, который вы хотите подключить. Рекомендуется использовать несколько менеджеров очередей на группу АктивныхШлюзов.&lt;br /&gt;
** &#039;&#039;&#039;Хосты, разделённые запятыми&#039;&#039;&#039;: Большинство менеджеров очередей работают на одном хосте, но бывают случаи, когда у вас есть многоэкземплярные менеджеры очередей, работающие на нескольких хостах. Введите здесь этот хост и порт или список хостов и портов, разделённых запятыми, для этого менеджера очередей.&lt;br /&gt;
** &#039;&#039;&#039;Название менеджера очередей&#039;&#039;&#039;: введите название менеджера очередей, к которому вы подключаетесь. Это обязательное поле.&lt;br /&gt;
** &#039;&#039;&#039;Канал подключения к серверу&#039;&#039;&#039;: любое клиентское приложение, например это расширение, подключающееся к &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;, должно взаимодействовать с менеджером очередей через канал. Введите здесь имя этого канала подключения к серверу.&lt;br /&gt;
** &#039;&#039;&#039;Использовать хранилище учётных данных&#039;&#039;&#039;: это позволит вам выбрать имя пользователя и пароль, хранящиеся в хранилище учётных данных Ключ-АСТРОМ. При использовании этой функции любые имя пользователя и пароль, введённые вручную, будут игнорироваться, и будут использоваться только учётные данные, хранящиеся в хранилище.&lt;br /&gt;
** &#039;&#039;&#039;Имя пользователя&#039;&#039;&#039;: необязательно, но рекомендуется добавить пользователя. Имя пользователя всегда указывается, но в зависимости от конфигурации менеджера очередей в &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; его можно игнорировать или аутентифицировать пользователя в этом поле. Рекомендуется всегда указывать имя пользователя.&lt;br /&gt;
** &#039;&#039;&#039;Пароль&#039;&#039;&#039;: Пароль указанного выше пользователя.&lt;br /&gt;
** &#039;&#039;&#039;Использовать SS&#039;&#039;&#039;L: включите этот параметр, чтобы установить &#039;&#039;&#039;TLS&#039;&#039;&#039;-соединение между расширением (клиентом) и сервером &#039;&#039;&#039;MQ&#039;&#039;&#039;. Поддерживается как односторонняя, так и двусторонняя аутентификация, которая полностью обрабатывается сервером &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;. Расширение всегда предоставляет сертификат, и &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; принимает решение о его принятии или отклонении.&lt;br /&gt;
** &#039;&#039;&#039;Очередь моделей&#039;&#039;&#039;: необязательно. Если не задано, будет использоваться системная очередь моделей по умолчанию для запросов и ответов команд.&lt;br /&gt;
** &#039;&#039;&#039;Префикс ответа&#039;&#039;&#039;: Если вы ввели модель очереди, необходимо ввести префикс для очереди ответа.&lt;br /&gt;
** &#039;&#039;&#039;Объекты для мониторинга&#039;&#039;&#039;: два способа добавления объектов.&lt;br /&gt;
*** Используя новый режим, просто нажимайте кнопки для ввода правил. Если есть объект, который вы совершенно не хотите отслеживать, удалите это правило.&lt;br /&gt;
*** В расширенном режиме добавьте фильтры, разделяя их запятыми, под каждой вкладкой. Наведите указатель мыши на значок &amp;lt;code&amp;gt;(&#039;&#039;&#039;i&#039;&#039;&#039;)&amp;lt;/code&amp;gt; рядом с каждым типом объекта, чтобы увидеть правила и примеры.&lt;br /&gt;
*** &#039;&#039;&#039;Примечание&#039;&#039;&#039;: Правила оцениваются последовательно. Таким образом, вы можете включать или исключать объекты из результата предыдущего правила. Например: &amp;lt;code&amp;gt;*, -SYSTEM.*, SYSTEM.CLUSTER*&amp;lt;/code&amp;gt; включит все очереди, а затем удалит те, которые начинаются с &#039;&#039;&#039;SYSTEM&#039;&#039;&#039;, а затем включит те, которые начинаются с &#039;&#039;&#039;SYSTEM.CLUSTER&#039;&#039;&#039;. Обратите особое внимание на порядок ввода правил, независимо от того, используете ли вы обычный или расширенный режим.&lt;br /&gt;
** &#039;&#039;&#039;Отправлять событие логов для очереди недоставленных сообщений&#039;&#039;&#039;: включите этот параметр, чтобы любое событие &#039;&#039;&#039;DLQ&#039;&#039;&#039; в любом менеджере очередей, соответствующем этой конфигурации, запускало событие логов, указывающее на то, что количество сообщений в очереди &#039;&#039;&#039;DLQ&#039;&#039;&#039; превысило пороговое значение. Вы можете создать оповещение на основе этого события логов.﻿&lt;br /&gt;
** &#039;&#039;&#039;Отправлять событие логов при высокой глубине очереди из менеджера очередей&#039;&#039;&#039;: включите этот параметр, чтобы любая соответствующая очередь в любом менеджере очередей в этой конфигурации запускала событие логов при превышении заданного порогового значения глубины. Этот порог настраивается в &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;.&lt;br /&gt;
** &#039;&#039;&#039;Отправлять событие логов при малой глубине очереди из менеджера очередей&#039;&#039;&#039;: включите этот параметр, чтобы любая соответствующая очередь в любом менеджере очередей в этой конфигурации запускала событие логов, если её заданная глубина ниже порогового значения. Это пороговое значение настраивается в &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;.&lt;br /&gt;
** &#039;&#039;&#039;Извлечь топологию для улучшенной трассировки транзакций&#039;&#039;&#039;: включение этого параметра позволит собирать сопоставления для псевдонимов очередей, удалённых очередей и очередей кластера. Эти сопоставления затем отправляются в Ключ-АСТРОМ для дополнения информации о сопоставлениях для улучшенной трассировки транзакций. Сбор этой информации может потребоваться только один раз, если сопоставления в &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; не меняются часто. Если этот параметр включён, введите токен Ключ-АСТРОМ для взаимодействия с &#039;&#039;&#039;API&#039;&#039;&#039; со следующими разрешениями: &amp;lt;code&amp;gt;Read settings&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Write settings&amp;lt;/code&amp;gt;.&lt;br /&gt;
** &#039;&#039;&#039;Переименовать менеджеров очередей&#039;&#039;&#039;: включение этого параметра позволит вам добавлять псевдонимы к менеджерам очередей, соответствующим вашему фильтру (см. выше). Настоящее имя менеджера очередей будет по-прежнему включено в название. Это необходимо только для того, чтобы различать менеджеры очередей с похожими или одинаковыми именами в Ключ-АСТРОМ. Это не приведёт к переименованию менеджеров очередей в &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;.&lt;br /&gt;
** &#039;&#039;&#039;Массовый запрос метрик&#039;&#039;&#039;: включение этого параметра сократит количество запросов к &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; и позволит собирать метрики для очередей и каналов за меньшее количество запросов, тем самым сокращая время и потенциальную нагрузку на процессор. Однако этот параметр потребует предоставления разрешений на все очереди и все каналы, включая объекты &#039;&#039;&#039;SYSTEM&#039;&#039;&#039;. Этот параметр не подходит для крупных сред с большим количеством очередей или каналов.&lt;br /&gt;
** &#039;&#039;&#039;Отключить автоматическое оповещение&#039;&#039;&#039;: автоматическое создание проблем при сбоях будет отключено. Ошибки по-прежнему будут регистрироваться как события, но не будут вызывать проблемы. Если вы хотите создавать проблемы, вам потребуется создать правила для их запуска из событий логов.&lt;br /&gt;
** Наконец, выберите, какие наборы &#039;&#039;&#039;характеристик&#039;&#039;&#039; (&#039;&#039;&#039;группы метрик&#039;&#039;&#039;) должна собирать эта конфигурация. Выбор слишком малого количества не обеспечит необходимого уровня прозрачности и может привести к потере важных данных о производительности, а также ключевых показателей, которые можно сопоставить между различными объектами.&lt;br /&gt;
&lt;br /&gt;
== Варианты использования ==&lt;br /&gt;
&lt;br /&gt;
* Мониторинг инфраструктуры &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;, включая менеджеры очередей, очереди, каналы, темы.&lt;br /&gt;
* Получайте оповещения, если диспетчер очередей недавно был запущен, недоступен, имеет каналы повторных попыток и т. д.&lt;br /&gt;
* Контролируйте свой &#039;&#039;&#039;IBM MQ&#039;&#039;&#039;, развернув его локально на контролируемом хосте ЕдиногоАгента или удаленно с помощью АктивногоШлюза.&lt;br /&gt;
&lt;br /&gt;
== Информация о совместимости ==&lt;br /&gt;
Более подробную информацию о совместимости можно найти в разделе &#039;&#039;&#039;&#039;&#039;Начало работы&#039;&#039;&#039;.&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
== Часто задаваемые вопросы и устранение неполадок ==&lt;br /&gt;
&lt;br /&gt;
=== Сколько DDU он будет потреблять в год? ===&lt;br /&gt;
Ниже приведены приблизительные значения. Метрики меняются в зависимости от типа объектов. Некоторые метрики доступны не для всех каналов, некоторые — не для всех очередей.&lt;br /&gt;
&lt;br /&gt;
Например:&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|1      Queue manager&lt;br /&gt;
&lt;br /&gt;
400    Local queues&lt;br /&gt;
&lt;br /&gt;
20     Alias and remote queues&lt;br /&gt;
&lt;br /&gt;
50     Channels&lt;br /&gt;
&lt;br /&gt;
1      Listener&lt;br /&gt;
&lt;br /&gt;
50     Topics&lt;br /&gt;
&lt;br /&gt;
( 10 + (400 * 16) + (20 * 2) + (50 * 18) + (1 * 1) + (50 * 4) ) * 1 * 525.6 =&lt;br /&gt;
&lt;br /&gt;
(10 + 6400 + 40 + 900 + 1 + 200)  * 525.6 = approximately 3.9M DDUs per year&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Не видны все показатели очереди ===&lt;br /&gt;
Некоторые метрики зависят от типа очередей. Другие — от настроек вашего менеджера очередей и наличия у вашего пользователя достаточных прав для их сбора.&lt;br /&gt;
&lt;br /&gt;
* Вам не хватает &#039;&#039;&#039;Enqueue&#039;&#039;&#039; и &#039;&#039;&#039;Dequeue&#039;&#039;&#039;? Убедитесь, что у вашего пользователя есть разрешение &#039;&#039;&#039;CHG&#039;&#039;&#039; на очередях, чтобы сбросить статистику. Только после этого вы сможете получать метрики &#039;&#039;&#039;Enqueue&#039;&#039;&#039; и &#039;&#039;&#039;Dequeue&#039;&#039;&#039;.&lt;br /&gt;
* Не хватает самого старого сообщения и последнего получения? Убедитесь, что мониторинг статистики включён в менеджере очередей для всех очередей.&lt;br /&gt;
* Вы рассматриваете очереди &#039;&#039;&#039;Alias&#039;&#039;&#039; ​​или &#039;&#039;&#039;Remote&#039;&#039;&#039;? Метрики состояния есть только у локальных очередей. У &#039;&#039;&#039;Alias&#039;&#039;&#039; ​​и &#039;&#039;&#039;Remote&#039;&#039;&#039; есть только метрики запрета &#039;&#039;&#039;GET/PUT&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
=== Ошибки - Неавторизованный пользователь ===&lt;br /&gt;
Проверьте сам менеджер очередей &amp;lt;code&amp;gt;AMQERR01.LOG&amp;lt;/code&amp;gt;. В этом файле логов будет указано, какие именно данные он пытался аутентифицировать и каких прав не хватает. Если вам не удаётся подключиться к менеджеру очередей, убедитесь, что у пользователя, запускающего процесс расширения, есть разрешения на доступ к менеджеру очередей &amp;lt;code&amp;gt;ADOPTCTX&amp;lt;/code&amp;gt;, или что расширение &amp;lt;code&amp;gt;CHLAUTH&amp;lt;/code&amp;gt; включено, чтобы аутентифицировать комбинацию имени пользователя и пароля, переданную в блоке &amp;lt;code&amp;gt;MQCSP&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Ошибка &amp;lt;code&amp;gt;pymqe&amp;lt;/code&amp;gt;, сообщающая, что &amp;lt;code&amp;gt;libmqm_r.so&amp;lt;/code&amp;gt; не найден ===&lt;br /&gt;
Это означает, что библиотеки &#039;&#039;&#039;IBM MQ&#039;&#039;&#039; не найдены в переменной &#039;&#039;&#039;PATH&#039;&#039;&#039; в &#039;&#039;&#039;Unix&#039;&#039;&#039;. Убедитесь, что вы выполнили шаги &amp;lt;code&amp;gt;ldconfig&amp;lt;/code&amp;gt;, описанные выше в разделе «&#039;&#039;&#039;Локальное развёртывание&#039;&#039;&#039;».&lt;br /&gt;
&lt;br /&gt;
=== Другие распространенные ошибки и их значения ===&lt;br /&gt;
&amp;lt;code&amp;gt;MQRC_HOST_NOT_AVAILABLE&amp;lt;/code&amp;gt;: Менеджер очередей недоступен из вашего АктивногоШлюза. Обычно это означает отсутствие правила брандмауэра. Поскольку менеджер очередей может работать на пользовательском порту, необходимо убедиться, что параметр &amp;lt;code&amp;gt;host:port&amp;lt;/code&amp;gt; доступен из АктивногоШлюза, на котором запущено расширение.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;MQRC_NO_MSG_AVAILABLE&amp;lt;/code&amp;gt;: Ответ от вашего менеджера очередей пришёл слишком поздно, и ответ оказался пустым. Это может произойти, если размер очереди ответов (&#039;&#039;&#039;MAX LENGTH&#039;&#039;&#039;) недостаточен для размещения полезной нагрузки ответа. Вы можете попробовать увеличить это значение. Это также может быть вызвано тайм-аутом или несвоевременным ответом менеджера очередей.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;MQRC_CONNECTION_BROKEN&amp;lt;/code&amp;gt;: Соединение с менеджером очередей разорвано либо из-за сбоя в работе сети, либо из-за того, что менеджер очередей его закрыл. Убедитесь, что производительность сети оптимальна. Кроме того, если вы используете &#039;&#039;&#039;SSL&#039;&#039;&#039;, убедитесь, что вы не используете устаревший шифр &#039;&#039;&#039;TLS&#039;&#039;&#039;, требующий ручного сброса ключей &#039;&#039;&#039;TLS&#039;&#039;&#039;, например, шифры T&#039;&#039;&#039;LS 1.2 AES-GCM&#039;&#039;&#039;. Переключитесь на шифр &#039;&#039;&#039;TLS 1.3&#039;&#039;&#039; с автоматическим сбросом ключей &#039;&#039;&#039;TLS&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 3.9.0&lt;br /&gt;
|&lt;br /&gt;
Версия расширения для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.314.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Добавлена поддержка локального выполнения через ЕдиныйАгент и удалённого выполнения через АктивныйШлюз.&lt;br /&gt;
&lt;br /&gt;
Добавлен защищённый сбор через TLS с односторонней и взаимной проверкой сертификатов.&lt;br /&gt;
&lt;br /&gt;
Добавлены правила фильтрации очередей, каналов, слушателей и топиков.&lt;br /&gt;
&lt;br /&gt;
Добавлены сбор данных Queue Sharing Group и настройка Outbound SNI.&lt;br /&gt;
&lt;br /&gt;
Добавлены сущности менеджеров очередей, очередей, каналов, слушателей, топиков, буферных пулов и наборов страниц.&lt;br /&gt;
&lt;br /&gt;
Добавлены классическая обзорная панель и панель в формате документов.&lt;br /&gt;
&lt;br /&gt;
Добавлены восемь шаблонов оповещений.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6976</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6976"/>
		<updated>2026-10-02T02:48:22Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Прием и анализ пользовательских метрик */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak|Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ|Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory|Microsoft Active Directory]]&lt;br /&gt;
* [[Microsoft Exchange Server]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V|Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix|IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
*[[OpenTelemetry Collector]]&lt;br /&gt;
*[[OpenTelemetry Span Metrics Gateway]]&lt;br /&gt;
*[[RabbitMQ]]&lt;br /&gt;
*[[Prometheus Redis]]&lt;br /&gt;
*[[SOWA Monitor]]&lt;br /&gt;
*[[SOWA]]&lt;br /&gt;
*[[Tomcat JMX]]&lt;br /&gt;
*[[Управление расширениями базы данных SAP Hana|SAP Hana]]&lt;br /&gt;
*[[Расширение HAProxy|HAProxy]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D0%B5_HAProxy&amp;diff=6975</id>
		<title>Расширение HAProxy</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D0%B5_HAProxy&amp;diff=6975"/>
		<updated>2026-10-02T02:48:02Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Расширение &#039;&#039;&#039;HAProxy&#039;&#039;&#039; предназначено для удалённого мониторинга балансировщиков HAProxy в Ключ-АСТРОМ. Данные собираются через Runtime API либо HTTP-страницу статистики.&lt;br /&gt;
&lt;br /&gt;
== Возможности ==&lt;br /&gt;
&lt;br /&gt;
Расширение позволяет:&lt;br /&gt;
&lt;br /&gt;
* контролировать доступность HAProxy;&lt;br /&gt;
* отслеживать состояние frontend, backend и server;&lt;br /&gt;
* контролировать количество и использование сессий;&lt;br /&gt;
* анализировать очереди, запросы и соединения;&lt;br /&gt;
* отслеживать HTTP-ответы по классам &amp;lt;code&amp;gt;2xx&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;3xx&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;4xx&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;5xx&amp;lt;/code&amp;gt;;&lt;br /&gt;
* выявлять ошибки и прерванные соединения;&lt;br /&gt;
* контролировать объём входящего и исходящего трафика;&lt;br /&gt;
* получать общую информацию о процессе HAProxy;&lt;br /&gt;
* автоматически создавать сущности HAProxy и связи между ними;&lt;br /&gt;
* отображать данные на готовой обзорной панели.&lt;br /&gt;
&lt;br /&gt;
== Архитектура ==&lt;br /&gt;
&lt;br /&gt;
Расширение выполняется на АктивномШлюзе и удалённо подключается к HAProxy одним из способов:&lt;br /&gt;
&lt;br /&gt;
* через TCP-сокет Runtime API — рекомендуемый вариант;&lt;br /&gt;
* через HTTP-страницу статистики в формате CSV.&lt;br /&gt;
&lt;br /&gt;
На сервер HAProxy не требуется устанавливать ЕдиныйАгент или дополнительные компоненты.&lt;br /&gt;
&lt;br /&gt;
Сбор данных по умолчанию выполняется каждую минуту. Интервал можно изменить в конфигурации точки подключения.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
Для работы расширения необходимы:&lt;br /&gt;
&lt;br /&gt;
* Ключ-АСТРОМ версии &amp;lt;code&amp;gt;1.313.0&amp;lt;/code&amp;gt; или новее;&lt;br /&gt;
* АктивныйШлюз с EEC версии &amp;lt;code&amp;gt;1.313.0&amp;lt;/code&amp;gt; или новее;&lt;br /&gt;
* Python версии &amp;lt;code&amp;gt;3.10&amp;lt;/code&amp;gt; или новее на стороне EEC;&lt;br /&gt;
* сетевой доступ от АктивногоШлюза до HAProxy;&lt;br /&gt;
* доступ к TCP-сокету Runtime API либо HTTP-странице статистики HAProxy.&lt;br /&gt;
&lt;br /&gt;
Одна конфигурация расширения может содержать до 200 точек подключения.&lt;br /&gt;
&lt;br /&gt;
== Подготовка HAProxy ==&lt;br /&gt;
&lt;br /&gt;
=== Вариант 1. Runtime API ===&lt;br /&gt;
&lt;br /&gt;
Подключение через Runtime API является рекомендуемым, поскольку предоставляет наиболее полный набор данных, включая общую информацию о процессе HAProxy.&lt;br /&gt;
&lt;br /&gt;
В секции &amp;lt;code&amp;gt;global&amp;lt;/code&amp;gt; файла конфигурации HAProxy добавьте TCP-сокет статистики:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
global&lt;br /&gt;
    stats socket ipv4@192.0.2.10:9000 level user&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Замените &amp;lt;code&amp;gt;192.0.2.10&amp;lt;/code&amp;gt; на адрес интерфейса HAProxy, доступный с АктивногоШлюза.&lt;br /&gt;
&lt;br /&gt;
Порт Runtime API должен отличаться от портов, на которых HAProxy принимает пользовательский HTTP- или HTTPS-трафик.&lt;br /&gt;
&lt;br /&gt;
После изменения конфигурации проверьте её и перезапустите либо перезагрузите HAProxy.&lt;br /&gt;
&lt;br /&gt;
Проверить доступ к Runtime API можно с АктивногоШлюза:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
printf &#039;show info; show stat\n&#039; | nc 192.0.2.10 9000&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
В ответ должна вернуться информация о процессе HAProxy и CSV-таблица статистики.&lt;br /&gt;
&lt;br /&gt;
Рекомендуется разрешить подключение к порту Runtime API только с адресов АктивныхШлюзов с помощью межсетевого экрана.&lt;br /&gt;
&lt;br /&gt;
=== Вариант 2. HTTP-статистика ===&lt;br /&gt;
&lt;br /&gt;
Для сбора данных по HTTP можно настроить отдельную страницу статистики:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
listen stats&lt;br /&gt;
    bind 192.0.2.10:8404&lt;br /&gt;
    mode http&lt;br /&gt;
    stats enable&lt;br /&gt;
    stats uri /stats&lt;br /&gt;
    stats refresh 10s&lt;br /&gt;
    stats auth monitoring:strong-password&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Замените адрес, имя пользователя и пароль на значения, принятые в вашей инфраструктуре.&lt;br /&gt;
&lt;br /&gt;
В конфигурации расширения необходимо указать адрес без суффикса &amp;lt;code&amp;gt;;csv&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://192.0.2.10:8404/stats&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
При выполнении запроса расширение автоматически добавляет суффикс &amp;lt;code&amp;gt;;csv&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://192.0.2.10:8404/stats;csv&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Проверить доступность статистики можно командой:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl -u &#039;monitoring:&amp;amp;lt;password&amp;amp;gt;&#039; \&lt;br /&gt;
  &#039;http://192.0.2.10:8404/stats;csv&#039;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
В ответ должна вернуться статистика HAProxy в формате CSV.&lt;br /&gt;
&lt;br /&gt;
В режиме HTTP расширение получает статистику frontend, backend и server, однако общая информация о процессе из набора &amp;lt;code&amp;gt;Info&amp;lt;/code&amp;gt; недоступна. Для полного набора данных используйте Runtime API.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Откройте раздел управления расширениями в Ключ-АСТРОМ.&lt;br /&gt;
# Загрузите архив расширения HAProxy.&lt;br /&gt;
# Дождитесь завершения проверки и активации расширения.&lt;br /&gt;
# Убедитесь, что для расширения доступен АктивныйШлюз с установленным EEC.&lt;br /&gt;
# Откройте конфигурацию расширения и создайте точку подключения.&lt;br /&gt;
&lt;br /&gt;
== Настройка точки подключения ==&lt;br /&gt;
&lt;br /&gt;
При создании конфигурации выберите способ подключения.&lt;br /&gt;
&lt;br /&gt;
=== Подключение через Runtime API ===&lt;br /&gt;
&lt;br /&gt;
Для подключения через TCP-сокет заполните следующие параметры:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Включено&lt;br /&gt;
| Разрешает или приостанавливает сбор данных для точки подключения.&lt;br /&gt;
|-&lt;br /&gt;
| Использовать HTTP&lt;br /&gt;
| Отключите параметр для работы через Runtime API.&lt;br /&gt;
|-&lt;br /&gt;
| Сервер HAProxy&lt;br /&gt;
| Имя узла или IP-адрес сервера HAProxy.&lt;br /&gt;
|-&lt;br /&gt;
| Порт HAProxy&lt;br /&gt;
| Порт TCP-сокета Runtime API. Значение по умолчанию — &amp;lt;code&amp;gt;9000&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Интервал сбора&lt;br /&gt;
| Период между запусками сбора, в минутах. Допустимый диапазон — от &amp;lt;code&amp;gt;1&amp;lt;/code&amp;gt; до &amp;lt;code&amp;gt;1440&amp;lt;/code&amp;gt;.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Пример:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
Использовать HTTP: нет&lt;br /&gt;
Сервер HAProxy: haproxy.example.local&lt;br /&gt;
Порт HAProxy: 9000&lt;br /&gt;
Интервал сбора: 1 минута&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Подключение через HTTP ===&lt;br /&gt;
&lt;br /&gt;
Для подключения к странице статистики заполните следующие параметры:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Включено&lt;br /&gt;
| Разрешает или приостанавливает сбор данных для точки подключения.&lt;br /&gt;
|-&lt;br /&gt;
| Использовать HTTP&lt;br /&gt;
| Включите параметр для работы через HTTP-статистику.&lt;br /&gt;
|-&lt;br /&gt;
| Адрес HAProxy&lt;br /&gt;
| Полный адрес страницы статистики, например &amp;lt;code&amp;gt;http://haproxy.example.local:8404/stats&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Использовать хранилище учётных данных&lt;br /&gt;
| Позволяет получить имя пользователя и пароль из хранилища учётных данных.&lt;br /&gt;
|-&lt;br /&gt;
| Идентификатор учётных данных&lt;br /&gt;
| Идентификатор записи в хранилище учётных данных.&lt;br /&gt;
|-&lt;br /&gt;
| Имя пользователя&lt;br /&gt;
| Имя пользователя HTTP Basic Authentication. Если поле не заполнено, запрос выполняется без аутентификации.&lt;br /&gt;
|-&lt;br /&gt;
| Пароль&lt;br /&gt;
| Пароль пользователя HTTP Basic Authentication.&lt;br /&gt;
|-&lt;br /&gt;
| Интервал сбора&lt;br /&gt;
| Период между запусками сбора, в минутах. Допустимый диапазон — от &amp;lt;code&amp;gt;1&amp;lt;/code&amp;gt; до &amp;lt;code&amp;gt;1440&amp;lt;/code&amp;gt;.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Пример:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
Использовать HTTP: да&lt;br /&gt;
Адрес HAProxy: http://haproxy.example.local:8404/stats&lt;br /&gt;
Имя пользователя: monitoring&lt;br /&gt;
Пароль: &amp;amp;lt;password&amp;amp;gt;&lt;br /&gt;
Интервал сбора: 1 минута&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для производственной среды рекомендуется хранить учётные данные в хранилище учётных данных, а не непосредственно в конфигурации расширения.&lt;br /&gt;
&lt;br /&gt;
== Общие параметры ==&lt;br /&gt;
&lt;br /&gt;
Для расширения можно выбрать уровень журналирования:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Значение&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;INFO&amp;lt;/code&amp;gt;&lt;br /&gt;
| Стандартный уровень журналирования. Рекомендуется для постоянной работы.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;DEBUG&amp;lt;/code&amp;gt;&lt;br /&gt;
| Подробное журналирование для диагностики проблем. После устранения проблемы рекомендуется вернуть уровень &amp;lt;code&amp;gt;INFO&amp;lt;/code&amp;gt;.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Наборы функций ==&lt;br /&gt;
&lt;br /&gt;
Метрики расширения распределены по следующим наборам функций:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Описание&lt;br /&gt;
! Количество метрик&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;default&amp;lt;/code&amp;gt;&lt;br /&gt;
| Доступность точки подключения HAProxy.&lt;br /&gt;
| 1&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Info&amp;lt;/code&amp;gt;&lt;br /&gt;
| Общая информация о процессе HAProxy, времени работы, подключениях, потоках, памяти и внутренних ресурсах.&lt;br /&gt;
| 51&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Queuing&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущая и максимальная длина очереди, среднее и максимальное время ожидания.&lt;br /&gt;
| 4&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Request&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущая и максимальная скорость обработки запросов.&lt;br /&gt;
| 2&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Response&amp;lt;/code&amp;gt;&lt;br /&gt;
| Среднее и максимальное время ответа и полное время обработки.&lt;br /&gt;
| 4&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Sessions&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущие, максимальные и предельные значения сессий, а также процент использования лимита.&lt;br /&gt;
| 4&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Rate&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущая и максимальная скорость обработки операций.&lt;br /&gt;
| 2&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Aborts&amp;lt;/code&amp;gt;&lt;br /&gt;
| Соединения, прерванные клиентом или сервером.&lt;br /&gt;
| 2&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Connection&amp;lt;/code&amp;gt;&lt;br /&gt;
| Время установления соединений и скорость создания соединений.&lt;br /&gt;
| 4&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;HTTP responses&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество ответов HTTP классов &amp;lt;code&amp;gt;2xx&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;3xx&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;4xx&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;5xx&amp;lt;/code&amp;gt;.&lt;br /&gt;
| 4&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Errors&amp;lt;/code&amp;gt;&lt;br /&gt;
| Ошибки запросов, ответов и соединений, а также отклонённые запросы и ответы.&lt;br /&gt;
| 5&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Bytes&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество принятых и переданных байт.&lt;br /&gt;
| 2&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Всего расширение содержит 85 метрик, включая метрику доступности.&lt;br /&gt;
&lt;br /&gt;
Набор &amp;lt;code&amp;gt;default&amp;lt;/code&amp;gt; рекомендуется оставлять включённым во всех конфигурациях.&lt;br /&gt;
&lt;br /&gt;
== Контролируемые показатели ==&lt;br /&gt;
&lt;br /&gt;
=== Доступность ===&lt;br /&gt;
&lt;br /&gt;
Метрика доступности показывает, смог ли АктивныйШлюз подключиться к HAProxy и получить статистику:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;100&amp;lt;/code&amp;gt; — данные успешно получены;&lt;br /&gt;
* &amp;lt;code&amp;gt;0&amp;lt;/code&amp;gt; — произошла ошибка подключения или получения данных.&lt;br /&gt;
&lt;br /&gt;
Метрика отражает доступность HAProxy с точки зрения АктивногоШлюза и не является результатом проверки доступности пользовательских приложений через балансировщик.&lt;br /&gt;
&lt;br /&gt;
=== Общая информация ===&lt;br /&gt;
&lt;br /&gt;
При подключении через Runtime API расширение получает:&lt;br /&gt;
&lt;br /&gt;
* время работы HAProxy;&lt;br /&gt;
* количество процессов и потоков;&lt;br /&gt;
* количество активных заданий, слушателей и пиров;&lt;br /&gt;
* текущие и максимальные подключения;&lt;br /&gt;
* загрузку внутренних ресурсов;&lt;br /&gt;
* использование пулов памяти;&lt;br /&gt;
* использование SSL;&lt;br /&gt;
* количество отброшенных сообщений журнала;&lt;br /&gt;
* ошибки разрешения имён;&lt;br /&gt;
* использование сокетов и каналов;&lt;br /&gt;
* показатели сжатия;&lt;br /&gt;
* объём переданных данных.&lt;br /&gt;
&lt;br /&gt;
=== Сессии и очереди ===&lt;br /&gt;
&lt;br /&gt;
Расширение контролирует:&lt;br /&gt;
&lt;br /&gt;
* текущие и максимальные сессии;&lt;br /&gt;
* настроенный предел сессий;&lt;br /&gt;
* процент использования лимита;&lt;br /&gt;
* текущую и максимальную очередь;&lt;br /&gt;
* среднее и максимальное время ожидания в очереди.&lt;br /&gt;
&lt;br /&gt;
=== HTTP-ответы и ошибки ===&lt;br /&gt;
&lt;br /&gt;
Для сервисов HAProxy собираются:&lt;br /&gt;
&lt;br /&gt;
* ответы классов &amp;lt;code&amp;gt;2xx&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;3xx&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;4xx&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;5xx&amp;lt;/code&amp;gt;;&lt;br /&gt;
* ошибки запросов и ответов;&lt;br /&gt;
* отклонённые запросы и ответы;&lt;br /&gt;
* ошибки установления соединений;&lt;br /&gt;
* соединения, прерванные клиентом или сервером.&lt;br /&gt;
&lt;br /&gt;
== Топология ==&lt;br /&gt;
&lt;br /&gt;
Расширение создаёт следующие типы сущностей:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Сущность&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| HAProxy server&lt;br /&gt;
| Экземпляр HAProxy, к которому подключается АктивныйШлюз.&lt;br /&gt;
|-&lt;br /&gt;
| HAProxy service&lt;br /&gt;
| Frontend, backend или server, полученный из статистики HAProxy.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Сущность сервиса связывается с соответствующим экземпляром HAProxy отношением «дочерняя сущность».&lt;br /&gt;
&lt;br /&gt;
Для сервисов сохраняются следующие свойства:&lt;br /&gt;
&lt;br /&gt;
* имя proxy;&lt;br /&gt;
* имя сервиса;&lt;br /&gt;
* состояние;&lt;br /&gt;
* результат проверки работоспособности;&lt;br /&gt;
* код проверки;&lt;br /&gt;
* адрес и порт экземпляра HAProxy.&lt;br /&gt;
&lt;br /&gt;
== Обзорная панель ==&lt;br /&gt;
&lt;br /&gt;
В пакет расширения входит готовая панель &#039;&#039;&#039;HAProxy Overview&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
Она позволяет анализировать:&lt;br /&gt;
&lt;br /&gt;
* доступность экземпляров HAProxy;&lt;br /&gt;
* состояние сервисов;&lt;br /&gt;
* текущие сессии и использование их лимита;&lt;br /&gt;
* очереди;&lt;br /&gt;
* скорость запросов и соединений;&lt;br /&gt;
* распределение HTTP-ответов;&lt;br /&gt;
* ошибки и прерванные соединения;&lt;br /&gt;
* объём входящего и исходящего трафика.&lt;br /&gt;
&lt;br /&gt;
Пакет содержит панель как в классическом формате, так и в формате документов.&lt;br /&gt;
&lt;br /&gt;
== Оповещения ==&lt;br /&gt;
&lt;br /&gt;
При необходимости можно создать правила обнаружения аномалий для следующих показателей:&lt;br /&gt;
&lt;br /&gt;
* недоступность HAProxy;&lt;br /&gt;
* высокий процент использования лимита сессий;&lt;br /&gt;
* продолжительный рост очереди;&lt;br /&gt;
* увеличение времени ожидания;&lt;br /&gt;
* рост количества ответов &amp;lt;code&amp;gt;5xx&amp;lt;/code&amp;gt;;&lt;br /&gt;
* увеличение количества ошибок соединений;&lt;br /&gt;
* рост количества соединений, прерванных клиентом или сервером.&lt;br /&gt;
&lt;br /&gt;
Пороговые значения следует выбирать с учётом обычной нагрузки конкретного экземпляра HAProxy.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После сохранения конфигурации:&lt;br /&gt;
&lt;br /&gt;
# Убедитесь, что конфигурация имеет состояние «Работает».&lt;br /&gt;
# Откройте страницу созданной сущности HAProxy.&lt;br /&gt;
# Проверьте наличие метрики доступности.&lt;br /&gt;
# Убедитесь, что созданы дочерние сущности сервисов.&lt;br /&gt;
# Откройте панель &#039;&#039;&#039;HAProxy Overview&#039;&#039;&#039; и выберите нужный экземпляр.&lt;br /&gt;
&lt;br /&gt;
Первые данные обычно появляются после завершения первого интервала сбора.&lt;br /&gt;
&lt;br /&gt;
== Устранение неисправностей ==&lt;br /&gt;
&lt;br /&gt;
=== Нет подключения к Runtime API ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* адрес и порт TCP-сокета;&lt;br /&gt;
* доступность порта с АктивногоШлюза;&lt;br /&gt;
* правила межсетевого экрана;&lt;br /&gt;
* наличие директивы &amp;lt;code&amp;gt;stats socket&amp;lt;/code&amp;gt; в секции &amp;lt;code&amp;gt;global&amp;lt;/code&amp;gt;;&lt;br /&gt;
* возможность выполнить команды &amp;lt;code&amp;gt;show info&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;show stat&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== HTTP возвращает ошибку ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* правильность адреса страницы статистики;&lt;br /&gt;
* доступность адреса с АктивногоШлюза;&lt;br /&gt;
* имя пользователя и пароль;&lt;br /&gt;
* доступность URL с суффиксом &amp;lt;code&amp;gt;;csv&amp;lt;/code&amp;gt;;&lt;br /&gt;
* отсутствие перенаправления на страницу интерактивного входа.&lt;br /&gt;
&lt;br /&gt;
=== Доступность есть, но набор Info пуст ===&lt;br /&gt;
&lt;br /&gt;
Набор &amp;lt;code&amp;gt;Info&amp;lt;/code&amp;gt; формируется из команды &amp;lt;code&amp;gt;show info&amp;lt;/code&amp;gt; и доступен при подключении через Runtime API. Переключите точку подключения с HTTP на TCP-сокет.&lt;br /&gt;
&lt;br /&gt;
=== Отсутствует часть сервисов или метрик ===&lt;br /&gt;
&lt;br /&gt;
Набор доступных полей статистики зависит от версии и конфигурации HAProxy. Убедитесь, что необходимые frontend, backend и server присутствуют в ответе команды &amp;lt;code&amp;gt;show stat&amp;lt;/code&amp;gt; или на странице &amp;lt;code&amp;gt;/stats;csv&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Требуется подробная диагностика ===&lt;br /&gt;
&lt;br /&gt;
Временно установите уровень журналирования &amp;lt;code&amp;gt;DEBUG&amp;lt;/code&amp;gt;, повторите сбор данных и изучите журнал расширения на АктивномШлюзе. После завершения диагностики верните уровень &amp;lt;code&amp;gt;INFO&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 1.0.5&lt;br /&gt;
|&lt;br /&gt;
* Версия расширения для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.313.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Добавлен удалённый сбор данных через Runtime API и HTTP-страницу статистики HAProxy.&lt;br /&gt;
* Добавлены метрики процесса, сервисов, сессий, очередей, запросов, соединений, HTTP-ответов, ошибок и трафика.&lt;br /&gt;
* Добавлено автоматическое создание сущностей экземпляров и сервисов HAProxy.&lt;br /&gt;
* Добавлены классическая обзорная панель и панель в формате документов.&lt;br /&gt;
* Добавлена поддержка хранения учётных данных HTTP-подключения в хранилище учётных данных.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_Microsoft_Hyper-V&amp;diff=6974</id>
		<title>Мониторинг Microsoft Hyper-V</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_Microsoft_Hyper-V&amp;diff=6974"/>
		<updated>2026-10-02T02:36:37Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Расширение предназначено для локального мониторинга кластеров, узлов и виртуальных машин Microsoft Hyper-V.&lt;br /&gt;
&lt;br /&gt;
== Назначение ==&lt;br /&gt;
&lt;br /&gt;
Расширение собирает показатели Microsoft Hyper-V с помощью WMI и PowerShell непосредственно на узлах гипервизора.&lt;br /&gt;
&lt;br /&gt;
С помощью расширения можно:&lt;br /&gt;
&lt;br /&gt;
* контролировать состояние кластеров Hyper-V;&lt;br /&gt;
* анализировать загрузку процессора и памяти узлов;&lt;br /&gt;
* отслеживать количество и состояние виртуальных машин;&lt;br /&gt;
* контролировать использование процессора и памяти виртуальными машинами;&lt;br /&gt;
* анализировать физические и виртуальные накопители;&lt;br /&gt;
* отслеживать Cluster Shared Volumes;&lt;br /&gt;
* контролировать физические и виртуальные сетевые интерфейсы;&lt;br /&gt;
* выявлять нехватку вычислительных ресурсов и хранилища;&lt;br /&gt;
* связывать обнаруженные виртуальные машины с гостевыми ОС, контролируемыми ЕдинымАгентом;&lt;br /&gt;
* использовать готовую панель мониторинга и шаблоны оповещений.&lt;br /&gt;
&lt;br /&gt;
== Архитектура мониторинга ==&lt;br /&gt;
&lt;br /&gt;
Расширение работает локально на каждом узле Hyper-V.&lt;br /&gt;
&lt;br /&gt;
Удалённый запуск через АктивныйШлюз не поддерживается.&lt;br /&gt;
&lt;br /&gt;
Для полноценного мониторинга кластера необходимо:&lt;br /&gt;
&lt;br /&gt;
* установить ЕдиныйАгент на каждый узел Hyper-V;&lt;br /&gt;
* установить расширение в Ключ-АСТРОМ;&lt;br /&gt;
* разрешить запуск расширения от имени &amp;lt;code&amp;gt;LOCAL SYSTEM&amp;lt;/code&amp;gt;;&lt;br /&gt;
* включить конфигурацию расширения на каждом узле кластера.&lt;br /&gt;
&lt;br /&gt;
Расширение выполняет:&lt;br /&gt;
&lt;br /&gt;
* WMI-запросы к локальному хранилищу показателей Windows;&lt;br /&gt;
* PowerShell-команды для получения конфигурации Hyper-V, сведений о кластере и дополнительных метрик;&lt;br /&gt;
* построение связей между кластерами, узлами, виртуальными машинами, дисками и сетевыми интерфейсами.&lt;br /&gt;
&lt;br /&gt;
== Поддерживаемые системы ==&lt;br /&gt;
&lt;br /&gt;
Для работы расширения необходима 64-разрядная операционная система с включённой аппаратной виртуализацией:&lt;br /&gt;
&lt;br /&gt;
* Windows 10 Enterprise, Pro или Education;&lt;br /&gt;
* Windows Server 2016 и более новые версии.&lt;br /&gt;
&lt;br /&gt;
Версия конфигурации виртуальных машин Hyper-V должна быть &amp;lt;code&amp;gt;9.0&amp;lt;/code&amp;gt; или выше.&lt;br /&gt;
&lt;br /&gt;
Минимальная версия Ключ-АСТРОМ — &amp;lt;code&amp;gt;1.318.0&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Расширение выполняется только на Windows.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
Перед установкой убедитесь, что:&lt;br /&gt;
&lt;br /&gt;
* на каждом узле кластера установлен и работает ЕдиныйАгент;&lt;br /&gt;
* роль Hyper-V установлена и активна;&lt;br /&gt;
* аппаратная виртуализация включена в BIOS или UEFI;&lt;br /&gt;
* доступны локальные WMI-классы Hyper-V;&lt;br /&gt;
* PowerShell может выполнять команды управления Hyper-V;&lt;br /&gt;
* для кластерной конфигурации установлен компонент Failover Clustering;&lt;br /&gt;
* служба ЕдиныйАгент имеет доступ к WMI, системному реестру и PowerShell;&lt;br /&gt;
* расширению разрешён запуск от имени &amp;lt;code&amp;gt;LOCAL SYSTEM&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Настройка повышенных привилегий ==&lt;br /&gt;
&lt;br /&gt;
Обычно Python-расширения выполняются от имени &amp;lt;code&amp;gt;LOCAL SERVICE&amp;lt;/code&amp;gt;. Этой учётной записи недостаточно для выполнения части PowerShell-команд и чтения некоторых WMI-объектов Hyper-V.&lt;br /&gt;
&lt;br /&gt;
Расширение должно выполняться от имени &amp;lt;code&amp;gt;LOCAL SYSTEM&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
На каждом узле Hyper-V откройте файл &amp;lt;code&amp;gt;extensionsuser.conf&amp;lt;/code&amp;gt; в каталоге конфигурации ЕдиногоАгента и добавьте:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
elevated_privileges_extensions=[ru.ruscomtech.extension.hyperv:*]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Если в параметре уже перечислены другие расширения, добавьте IBM Hyper-V через запятую, не удаляя существующие значения.&lt;br /&gt;
&lt;br /&gt;
После изменения конфигурации перезапустите службу ЕдиногоАгента.&lt;br /&gt;
&lt;br /&gt;
Проверьте этот параметр на каждом узле кластера, где должно выполняться расширение.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Откройте раздел управления расширениями в Ключ-АСТРОМ.&lt;br /&gt;
# Загрузите подписанный архив расширения.&lt;br /&gt;
# Убедитесь, что установлена версия &amp;lt;code&amp;gt;4.1.5&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Настройте запуск с повышенными привилегиями на узлах Hyper-V.&lt;br /&gt;
# Создайте конфигурацию мониторинга.&lt;br /&gt;
# Назначьте конфигурацию на все необходимые узлы Hyper-V.&lt;br /&gt;
# Выберите наборы функций.&lt;br /&gt;
# Сохраните и активируйте конфигурацию.&lt;br /&gt;
&lt;br /&gt;
== Настройка конфигурации ==&lt;br /&gt;
&lt;br /&gt;
=== Частота сбора ===&lt;br /&gt;
&lt;br /&gt;
Параметр &amp;lt;code&amp;gt;Frequency&amp;lt;/code&amp;gt; определяет интервал сбора данных в минутах.&lt;br /&gt;
&lt;br /&gt;
По умолчанию данные собираются каждую минуту.&lt;br /&gt;
&lt;br /&gt;
Для крупных кластеров интервал можно увеличить, если сбор не успевает завершиться до начала следующего цикла.&lt;br /&gt;
&lt;br /&gt;
=== Уровень журналирования ===&lt;br /&gt;
&lt;br /&gt;
Доступны уровни:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;INFO&amp;lt;/code&amp;gt; — обычная работа;&lt;br /&gt;
* &amp;lt;code&amp;gt;DEBUG&amp;lt;/code&amp;gt; — подробная диагностика.&lt;br /&gt;
&lt;br /&gt;
Используйте &amp;lt;code&amp;gt;DEBUG&amp;lt;/code&amp;gt; только при устранении неполадок.&lt;br /&gt;
&lt;br /&gt;
=== Режим фильтрации ===&lt;br /&gt;
&lt;br /&gt;
Параметр &amp;lt;code&amp;gt;Filter Mode&amp;lt;/code&amp;gt; определяет действие регулярных выражений:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Режим&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;ALLOW&amp;lt;/code&amp;gt;&lt;br /&gt;
| Собираются только сущности, соответствующие регулярному выражению.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;DENY&amp;lt;/code&amp;gt;&lt;br /&gt;
| Сущности, соответствующие регулярному выражению, исключаются из мониторинга.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Значение по умолчанию — &amp;lt;code&amp;gt;ALLOW&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Выражение &amp;lt;code&amp;gt;.*&amp;lt;/code&amp;gt; в режиме &amp;lt;code&amp;gt;ALLOW&amp;lt;/code&amp;gt; включает все сущности соответствующего типа.&lt;br /&gt;
&lt;br /&gt;
=== Фильтры сущностей ===&lt;br /&gt;
&lt;br /&gt;
Можно настроить отдельные регулярные выражения для:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Что фильтруется&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Cluster Filter&amp;lt;/code&amp;gt;&lt;br /&gt;
| Кластеры Hyper-V.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Host Filter&amp;lt;/code&amp;gt;&lt;br /&gt;
| Узлы Hyper-V.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;VM Filter&amp;lt;/code&amp;gt;&lt;br /&gt;
| Виртуальные машины.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Network Interface Card Filter&amp;lt;/code&amp;gt;&lt;br /&gt;
| Физические сетевые интерфейсы узлов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Storage Device Filter&amp;lt;/code&amp;gt;&lt;br /&gt;
| Физические накопители узлов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Virtual Network Interface Card Filter&amp;lt;/code&amp;gt;&lt;br /&gt;
| Виртуальные сетевые интерфейсы.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Virtual Storage Device Filter&amp;lt;/code&amp;gt;&lt;br /&gt;
| Виртуальные накопители.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Например:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
^.*-test$&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
В режиме &amp;lt;code&amp;gt;ALLOW&amp;lt;/code&amp;gt; выражение включает только сущности, имена которых заканчиваются на &amp;lt;code&amp;gt;-test&amp;lt;/code&amp;gt;. В режиме &amp;lt;code&amp;gt;DENY&amp;lt;/code&amp;gt; такие сущности исключаются.&lt;br /&gt;
&lt;br /&gt;
Ошибочное регулярное выражение может привести к отсутствию данных.&lt;br /&gt;
&lt;br /&gt;
== Наборы функций ==&lt;br /&gt;
&lt;br /&gt;
Для работы конфигурации необходимо выбрать хотя бы один набор функций.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор функций&lt;br /&gt;
! Метрик&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;cluster-shared-volume&amp;lt;/code&amp;gt;&lt;br /&gt;
| 5&lt;br /&gt;
| Размер, свободное и используемое пространство, скорость чтения и записи Cluster Shared Volumes.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;host-virtual-machine&amp;lt;/code&amp;gt;&lt;br /&gt;
| 3&lt;br /&gt;
| Количество виртуальных машин, количество работающих машин и время работы узла.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;host-cpu&amp;lt;/code&amp;gt;&lt;br /&gt;
| 4&lt;br /&gt;
| Загрузка процессора, резерв процессора, количество физических и логических ядер.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;host-memory&amp;lt;/code&amp;gt;&lt;br /&gt;
| 4&lt;br /&gt;
| Общая, используемая и доступная память узла, процент использования.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;basic-network-interface-card&amp;lt;/code&amp;gt;&lt;br /&gt;
| 3&lt;br /&gt;
| Переданные, полученные и суммарные пакеты физических сетевых интерфейсов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;advanced-network-interface-card&amp;lt;/code&amp;gt;&lt;br /&gt;
| 3&lt;br /&gt;
| Переданный, полученный и суммарный трафик физических сетевых интерфейсов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;basic-storage-device&amp;lt;/code&amp;gt;&lt;br /&gt;
| 4&lt;br /&gt;
| Использование, общий размер, занятое и свободное пространство физических накопителей.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;advanced-storage-device&amp;lt;/code&amp;gt;&lt;br /&gt;
| 3&lt;br /&gt;
| Скорость чтения, скорость записи и IOPS физических накопителей.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;virtual-machine&amp;lt;/code&amp;gt;&lt;br /&gt;
| 9&lt;br /&gt;
| Процессор, память и давление на память виртуальных машин.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;basic-virtual-network-interface-card&amp;lt;/code&amp;gt;&lt;br /&gt;
| 3&lt;br /&gt;
| Переданные, полученные и суммарные пакеты виртуальных сетевых интерфейсов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;advanced-virtual-network-interface-card&amp;lt;/code&amp;gt;&lt;br /&gt;
| 3&lt;br /&gt;
| Переданный, полученный и суммарный трафик виртуальных сетевых интерфейсов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;basic-virtual-storage-device&amp;lt;/code&amp;gt;&lt;br /&gt;
| 4&lt;br /&gt;
| Использование и объём виртуальных накопителей.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;advanced-virtual-storage-device&amp;lt;/code&amp;gt;&lt;br /&gt;
| 3&lt;br /&gt;
| Скорость чтения, скорость записи и IOPS виртуальных накопителей.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Для базового мониторинга рекомендуется включить:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;host-virtual-machine&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;host-cpu&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;host-memory&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;virtual-machine&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;basic-storage-device&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;basic-virtual-storage-device&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;cluster-shared-volume&amp;lt;/code&amp;gt; — для кластерной конфигурации.&lt;br /&gt;
&lt;br /&gt;
Расширенные наборы сетевых и дисковых показателей включайте при необходимости.&lt;br /&gt;
&lt;br /&gt;
== Собираемые данные ==&lt;br /&gt;
&lt;br /&gt;
=== Кластеры и Cluster Shared Volumes ===&lt;br /&gt;
&lt;br /&gt;
Расширение собирает:&lt;br /&gt;
&lt;br /&gt;
* общий размер тома;&lt;br /&gt;
* используемое пространство;&lt;br /&gt;
* доступное пространство;&lt;br /&gt;
* скорость чтения;&lt;br /&gt;
* скорость записи.&lt;br /&gt;
&lt;br /&gt;
=== Узлы Hyper-V ===&lt;br /&gt;
&lt;br /&gt;
Для каждого узла собираются:&lt;br /&gt;
&lt;br /&gt;
* количество виртуальных машин;&lt;br /&gt;
* количество работающих виртуальных машин;&lt;br /&gt;
* время работы;&lt;br /&gt;
* загрузка процессора;&lt;br /&gt;
* резерв процессора;&lt;br /&gt;
* количество физических процессоров;&lt;br /&gt;
* количество логических процессоров;&lt;br /&gt;
* общий объём памяти;&lt;br /&gt;
* используемая память;&lt;br /&gt;
* доступная память;&lt;br /&gt;
* процент использования памяти.&lt;br /&gt;
&lt;br /&gt;
=== Виртуальные машины ===&lt;br /&gt;
&lt;br /&gt;
Для виртуальных машин собираются:&lt;br /&gt;
&lt;br /&gt;
* количество виртуальных процессоров;&lt;br /&gt;
* резерв процессора;&lt;br /&gt;
* использование процессора относительно ресурсов узла;&lt;br /&gt;
* фактическое использование процессора внутри виртуальной машины;&lt;br /&gt;
* общий объём памяти;&lt;br /&gt;
* используемая память;&lt;br /&gt;
* доступная память;&lt;br /&gt;
* процент использования памяти;&lt;br /&gt;
* давление на память.&lt;br /&gt;
&lt;br /&gt;
Показатель фактической загрузки процессора отражает загрузку, видимую внутри виртуальной машины. Обычный показатель загрузки отражает использование относительно полной вычислительной мощности узла.&lt;br /&gt;
&lt;br /&gt;
=== Накопители ===&lt;br /&gt;
&lt;br /&gt;
Для физических и виртуальных накопителей собираются:&lt;br /&gt;
&lt;br /&gt;
* общий размер;&lt;br /&gt;
* используемое пространство;&lt;br /&gt;
* свободное пространство;&lt;br /&gt;
* процент использования;&lt;br /&gt;
* скорость чтения;&lt;br /&gt;
* скорость записи;&lt;br /&gt;
* количество операций ввода-вывода в секунду.&lt;br /&gt;
&lt;br /&gt;
=== Сетевые интерфейсы ===&lt;br /&gt;
&lt;br /&gt;
Для физических и виртуальных сетевых интерфейсов собираются:&lt;br /&gt;
&lt;br /&gt;
* отправленные пакеты;&lt;br /&gt;
* полученные пакеты;&lt;br /&gt;
* общий поток пакетов;&lt;br /&gt;
* отправленные байты;&lt;br /&gt;
* полученные байты;&lt;br /&gt;
* общий сетевой трафик.&lt;br /&gt;
&lt;br /&gt;
== Топология ==&lt;br /&gt;
&lt;br /&gt;
Расширение создаёт сущности:&lt;br /&gt;
&lt;br /&gt;
* кластер Hyper-V;&lt;br /&gt;
* узел Hyper-V;&lt;br /&gt;
* виртуальная машина;&lt;br /&gt;
* физический накопитель;&lt;br /&gt;
* виртуальный накопитель;&lt;br /&gt;
* физический сетевой интерфейс;&lt;br /&gt;
* виртуальный сетевой интерфейс.&lt;br /&gt;
&lt;br /&gt;
Создаются следующие связи:&lt;br /&gt;
&lt;br /&gt;
* узел входит в кластер;&lt;br /&gt;
* виртуальная машина работает на узле;&lt;br /&gt;
* физический накопитель относится к узлу;&lt;br /&gt;
* физический сетевой интерфейс относится к узлу;&lt;br /&gt;
* виртуальный накопитель относится к виртуальной машине;&lt;br /&gt;
* виртуальный сетевой интерфейс относится к виртуальной машине.&lt;br /&gt;
&lt;br /&gt;
Если гостевая ОС также контролируется ЕдинымАгентом, расширение пытается связать обнаруженную виртуальную машину с соответствующим экземпляром гостевой ОС по IP-адресу.&lt;br /&gt;
&lt;br /&gt;
Для гостевых Windows связь обычно определяется автоматически. Для Linux результат зависит от поддержки Microsoft Linux Integration Services и доступности IP-адресов гостевой системы.&lt;br /&gt;
&lt;br /&gt;
== Панели мониторинга ==&lt;br /&gt;
&lt;br /&gt;
В пакет входят:&lt;br /&gt;
&lt;br /&gt;
* классическая панель &amp;lt;code&amp;gt;Hyper-V Overview&amp;lt;/code&amp;gt;;&lt;br /&gt;
* панель нового формата &amp;lt;code&amp;gt;Microsoft Hyper-V Infrastructure Overview&amp;lt;/code&amp;gt;;&lt;br /&gt;
* аналитические представления кластеров, узлов, виртуальных машин, дисков и сетевых интерфейсов.&lt;br /&gt;
&lt;br /&gt;
Панели позволяют анализировать:&lt;br /&gt;
&lt;br /&gt;
* распределение ресурсов между виртуальными машинами;&lt;br /&gt;
* загрузку процессоров и памяти;&lt;br /&gt;
* заполнение физических и виртуальных дисков;&lt;br /&gt;
* состояние Cluster Shared Volumes;&lt;br /&gt;
* сетевую нагрузку;&lt;br /&gt;
* взаимосвязи между кластером, узлами и виртуальными машинами.&lt;br /&gt;
&lt;br /&gt;
== Оповещения ==&lt;br /&gt;
&lt;br /&gt;
Расширение содержит десять шаблонов оповещений.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Оповещение&lt;br /&gt;
! Условие по умолчанию&lt;br /&gt;
|-&lt;br /&gt;
| Высокая загрузка процессора кластера&lt;br /&gt;
| Выше 85%.&lt;br /&gt;
|-&lt;br /&gt;
| Высокое использование файловой системы кластера&lt;br /&gt;
| Выше 80%.&lt;br /&gt;
|-&lt;br /&gt;
| Высокое использование памяти кластера&lt;br /&gt;
| Выше 85%.&lt;br /&gt;
|-&lt;br /&gt;
| Мало свободного места на Cluster Shared Volume&lt;br /&gt;
| Ниже 15%.&lt;br /&gt;
|-&lt;br /&gt;
| Высокая загрузка процессора узла&lt;br /&gt;
| Выше 85%.&lt;br /&gt;
|-&lt;br /&gt;
| Высокое использование памяти узла&lt;br /&gt;
| Выше 85%.&lt;br /&gt;
|-&lt;br /&gt;
| Высокая загрузка физического накопителя&lt;br /&gt;
| Выше 85%.&lt;br /&gt;
|-&lt;br /&gt;
| Высокая загрузка виртуального накопителя&lt;br /&gt;
| Выше 85%.&lt;br /&gt;
|-&lt;br /&gt;
| Высокая загрузка процессора виртуальной машины&lt;br /&gt;
| Выше 85%.&lt;br /&gt;
|-&lt;br /&gt;
| Высокое использование памяти виртуальной машины&lt;br /&gt;
| Выше 85%.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Порог проверяется в окне из пяти измерений. По умолчанию достаточно одного нарушающего измерения для создания события.&lt;br /&gt;
&lt;br /&gt;
Перед включением шаблонов адаптируйте пороговые значения к обычной нагрузке среды.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После активации конфигурации:&lt;br /&gt;
&lt;br /&gt;
# Проверьте состояние расширения на каждом узле Hyper-V.&lt;br /&gt;
# Убедитесь, что расширение запущено от имени &amp;lt;code&amp;gt;LOCAL SYSTEM&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Проверьте появление сущностей Hyper-V Host.&lt;br /&gt;
# Для кластерной среды проверьте появление Hyper-V Cluster.&lt;br /&gt;
# Убедитесь, что на каждом узле отображаются работающие виртуальные машины.&lt;br /&gt;
# Проверьте метрики процессора и памяти.&lt;br /&gt;
# Проверьте физические и виртуальные накопители.&lt;br /&gt;
# Откройте панель &amp;lt;code&amp;gt;Microsoft Hyper-V Infrastructure Overview&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Проверьте связи между кластером, узлами и виртуальными машинами.&lt;br /&gt;
&lt;br /&gt;
== Устранение неполадок ==&lt;br /&gt;
&lt;br /&gt;
=== Расширение не запускается ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* установлен ли ЕдиныйАгент на узле;&lt;br /&gt;
* добавлено ли расширение в &amp;lt;code&amp;gt;elevated_privileges_extensions&amp;lt;/code&amp;gt;;&lt;br /&gt;
* перезапущена ли служба ЕдиногоАгента после изменения конфигурации;&lt;br /&gt;
* соответствует ли имя расширения &amp;lt;code&amp;gt;ru.ruscomtech.extension.hyperv&amp;lt;/code&amp;gt;;&lt;br /&gt;
* доступен ли PowerShell;&lt;br /&gt;
* включена ли роль Hyper-V;&lt;br /&gt;
* отсутствуют ли ошибки в журнале расширения.&lt;br /&gt;
&lt;br /&gt;
=== Узел отображается, но виртуальные машины отсутствуют ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* набор функций &amp;lt;code&amp;gt;virtual-machine&amp;lt;/code&amp;gt;;&lt;br /&gt;
* фильтр виртуальных машин;&lt;br /&gt;
* режим &amp;lt;code&amp;gt;ALLOW&amp;lt;/code&amp;gt; или &amp;lt;code&amp;gt;DENY&amp;lt;/code&amp;gt;;&lt;br /&gt;
* права на выполнение команд Hyper-V PowerShell;&lt;br /&gt;
* доступ к WMI-классам Hyper-V;&lt;br /&gt;
* наличие работающих виртуальных машин на этом узле.&lt;br /&gt;
&lt;br /&gt;
Расширение должно быть включено на каждом узле кластера. Один узел не собирает все локальные показатели виртуальных машин с остальных узлов.&lt;br /&gt;
&lt;br /&gt;
=== Не определяется кластер ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* установлен ли компонент Failover Clustering;&lt;br /&gt;
* доступна ли команда получения сведений о кластере в PowerShell;&lt;br /&gt;
* фильтр кластера;&lt;br /&gt;
* выполнение расширения от имени &amp;lt;code&amp;gt;LOCAL SYSTEM&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Узлы, не входящие в кластер, могут контролироваться отдельно.&lt;br /&gt;
&lt;br /&gt;
=== После миграции виртуальная машина видна на двух узлах ===&lt;br /&gt;
&lt;br /&gt;
Версия &amp;lt;code&amp;gt;4.1.5&amp;lt;/code&amp;gt; содержит исправления очистки устаревших данных о размещении виртуальных машин.&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* что на всех узлах используется одинаковая версия расширения;&lt;br /&gt;
* что конфигурация активна на всех узлах;&lt;br /&gt;
* что сбор данных завершается без ошибок;&lt;br /&gt;
* что фильтры виртуальных машин одинаковы на всех узлах.&lt;br /&gt;
&lt;br /&gt;
=== Не создаётся связь с гостевой ОС ===&lt;br /&gt;
&lt;br /&gt;
Связь определяется по IP-адресу.&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* установлен ли ЕдиныйАгент внутри гостевой ОС;&lt;br /&gt;
* передаёт ли Hyper-V IP-адрес виртуальной машины;&lt;br /&gt;
* совпадает ли IP-адрес с адресом гостевой ОС;&lt;br /&gt;
* установлен ли Microsoft Linux Integration Services для Linux-гостя.&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 4.1.5&lt;br /&gt;
| Перепакованы Python-библиотеки для будущей совместимости с Python 3.14.&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=IBM_i&amp;diff=6973</id>
		<title>IBM i</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=IBM_i&amp;diff=6973"/>
		<updated>2026-10-02T02:28:23Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Расширение предназначено для удалённого мониторинга производительности и состояния систем IBM i.&lt;br /&gt;
&lt;br /&gt;
== Назначение ==&lt;br /&gt;
&lt;br /&gt;
Расширение подключается к IBM i через драйвер IBM i Access ODBC и передаёт в Ключ-АСТРОМ показатели состояния системы, процессора, памяти, заданий, накопителей, очередей, сети и HTTP-серверов.&lt;br /&gt;
&lt;br /&gt;
С помощью расширения можно:&lt;br /&gt;
&lt;br /&gt;
* контролировать доступность хостов IBM i;&lt;br /&gt;
* отслеживать использование процессора и системного ASP;&lt;br /&gt;
* анализировать активные задания и их состояния;&lt;br /&gt;
* контролировать пулы памяти и ошибки страниц;&lt;br /&gt;
* отслеживать диски и вспомогательные пулы хранения;&lt;br /&gt;
* контролировать очереди заданий, сообщений и вывода;&lt;br /&gt;
* анализировать сетевые подключения;&lt;br /&gt;
* получать сообщения из очередей и журнала истории;&lt;br /&gt;
* отслеживать заблокированные учётные записи;&lt;br /&gt;
* контролировать встроенные HTTP-серверы IBM i;&lt;br /&gt;
* создавать оповещения при превышении установленных порогов.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
Для работы расширения необходимы:&lt;br /&gt;
&lt;br /&gt;
* Ключ-АСТРОМ версии &amp;lt;code&amp;gt;1.318.0&amp;lt;/code&amp;gt; или выше;&lt;br /&gt;
* среда выполнения расширений АктивногоШлюза версии &amp;lt;code&amp;gt;1.313.0&amp;lt;/code&amp;gt; или выше;&lt;br /&gt;
* драйвер IBM i Access ODBC;&lt;br /&gt;
* сетевой доступ с АктивногоШлюза до IBM i;&lt;br /&gt;
* включённый пул ODBC-соединений;&lt;br /&gt;
* учётная запись IBM i с необходимыми правами;&lt;br /&gt;
* хотя бы один АктивныйШлюз в выбранной группе.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Требования к учётной записи ===&lt;br /&gt;
&lt;br /&gt;
Рекомендуется использовать профиль с классом &amp;lt;code&amp;gt;SECOFR&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Учётной записи также требуются:&lt;br /&gt;
&lt;br /&gt;
* специальное право &amp;lt;code&amp;gt;*JOBCTL&amp;lt;/code&amp;gt;;&lt;br /&gt;
* право &amp;lt;code&amp;gt;*USE&amp;lt;/code&amp;gt; на команду &amp;lt;code&amp;gt;WRKPTFGRP&amp;lt;/code&amp;gt;;&lt;br /&gt;
* доступ к таблицам производительности;&lt;br /&gt;
* доступ к используемым табличным функциям и внутренним процедурам IBM i.&lt;br /&gt;
&lt;br /&gt;
Использование менее привилегированной учётной записи возможно, но может привести к отсутствию отдельных метрик, сообщений или сведений о заданиях.&lt;br /&gt;
&lt;br /&gt;
=== Сетевые порты ===&lt;br /&gt;
&lt;br /&gt;
Между АктивнымШлюзом и IBM i должны быть разрешены необходимые подключения.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Служба&lt;br /&gt;
! Имя службы&lt;br /&gt;
! Без SSL&lt;br /&gt;
! SSL&lt;br /&gt;
|-&lt;br /&gt;
| Сопоставление серверов&lt;br /&gt;
| &amp;lt;code&amp;gt;as-svrmap&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;449&amp;lt;/code&amp;gt;&lt;br /&gt;
| —&lt;br /&gt;
|-&lt;br /&gt;
| Управление лицензиями&lt;br /&gt;
| &amp;lt;code&amp;gt;as-central&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;8470&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;9470&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Доступ к базе данных&lt;br /&gt;
| &amp;lt;code&amp;gt;as-database&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;8471&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;9471&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Очереди данных&lt;br /&gt;
| &amp;lt;code&amp;gt;as-dtaq&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;8472&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;9472&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Доступ к IFS&lt;br /&gt;
| &amp;lt;code&amp;gt;as-file&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;8473&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;9473&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Сетевые принтеры&lt;br /&gt;
| &amp;lt;code&amp;gt;as-netprt&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;8474&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;9474&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Удалённые команды&lt;br /&gt;
| &amp;lt;code&amp;gt;as-rmtcmd&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;8475&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;9475&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Проверка учётных данных&lt;br /&gt;
| &amp;lt;code&amp;gt;as-signon&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;8476&amp;lt;/code&amp;gt;&lt;br /&gt;
| &amp;lt;code&amp;gt;9476&amp;lt;/code&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Открывайте только те порты, которые необходимы для используемой конфигурации.&lt;br /&gt;
&lt;br /&gt;
== Установка ODBC-драйвера ==&lt;br /&gt;
&lt;br /&gt;
=== Windows ===&lt;br /&gt;
&lt;br /&gt;
# Откройте страницу [https://www.ibm.com/support/pages/ibm-i-access-client-solutions IBM i Access Client Solutions].&lt;br /&gt;
# Выберите загрузку IBM i Access Client Solutions.&lt;br /&gt;
# Войдите под учётной записью IBM и примите лицензионное соглашение.&lt;br /&gt;
# Загрузите пакет &amp;lt;code&amp;gt;IBM i Access Client Solutions — Windows Application Package&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Установите входящий в пакет драйвер IBM i Access ODBC на АктивныйШлюз.&lt;br /&gt;
# Откройте системное приложение «Источники данных ODBC».&lt;br /&gt;
# Убедитесь, что драйвер установлен и пул соединений включён.&lt;br /&gt;
# Рекомендуется установить тайм-аут пула соединений не менее 60 секунд.&lt;br /&gt;
&lt;br /&gt;
Не устанавливайте только базовый клиент IBM i Access: расширению необходим пакет, содержащий ODBC-драйвер.&lt;br /&gt;
&lt;br /&gt;
=== Linux ===&lt;br /&gt;
&lt;br /&gt;
Для АктивногоШлюза под управлением Linux необходим менеджер драйверов &amp;lt;code&amp;gt;unixODBC&amp;lt;/code&amp;gt; версии &amp;lt;code&amp;gt;2.3.12&amp;lt;/code&amp;gt; или выше.&lt;br /&gt;
&lt;br /&gt;
# Установите &amp;lt;code&amp;gt;unixODBC&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Загрузите пакет &amp;lt;code&amp;gt;IBM i Access Client Solutions — Linux Application Package&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Установите драйвер IBM i Access ODBC.&lt;br /&gt;
# Найдите файл &amp;lt;code&amp;gt;odbcinst.ini&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Включите пул соединений для определения драйвера IBM i Access.&lt;br /&gt;
# Добавьте параметр &amp;lt;code&amp;gt;CPTimeout=60&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Обычно файл находится по одному из путей:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;/etc/odbcinst.ini&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;/etc/unixODBC/odbcinst.ini&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Версии unixODBC ниже &amp;lt;code&amp;gt;2.3.12&amp;lt;/code&amp;gt; не рекомендуются из-за известных проблем с утечками памяти и пулом соединений.&lt;br /&gt;
&lt;br /&gt;
=== SSL ===&lt;br /&gt;
&lt;br /&gt;
При использовании SSL настройте драйвер IBM i Access для работы через TLS.&lt;br /&gt;
&lt;br /&gt;
На Windows для настройки можно использовать утилиту &amp;lt;code&amp;gt;cwbcossl&amp;lt;/code&amp;gt;, входящую в комплект IBM i Access.&lt;br /&gt;
&lt;br /&gt;
На Linux защищённое подключение настраивается в соответствии с документацией IBM, например с использованием &amp;lt;code&amp;gt;stunnel&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Скачайте архив IBM i со страницы [[Расширения]].&lt;br /&gt;
# Откройте управление расширениями в Ключ-АСТРОМ.&lt;br /&gt;
# Загрузите подписанный архив.&lt;br /&gt;
# Убедитесь, что версия &amp;lt;code&amp;gt;2.6.5&amp;lt;/code&amp;gt; установлена без ошибок.&lt;br /&gt;
# Создайте конфигурацию мониторинга IBM i.&lt;br /&gt;
&lt;br /&gt;
== Настройка расширения ==&lt;br /&gt;
&lt;br /&gt;
=== Группа АктивныхШлюзов ===&lt;br /&gt;
&lt;br /&gt;
Выберите группу, из которой доступны контролируемые IBM i.&lt;br /&gt;
&lt;br /&gt;
В группе должен находиться хотя бы один работающий АктивныйШлюз с установленным ODBC-драйвером.&lt;br /&gt;
&lt;br /&gt;
=== Уровень журналирования ===&lt;br /&gt;
&lt;br /&gt;
По умолчанию используйте уровень &amp;lt;code&amp;gt;INFO&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Уровень &amp;lt;code&amp;gt;DEBUG&amp;lt;/code&amp;gt; включайте только для диагностики. Он создаёт значительно больше записей в журнале расширения.&lt;br /&gt;
&lt;br /&gt;
=== Размер группы задач ===&lt;br /&gt;
&lt;br /&gt;
Параметр &amp;lt;code&amp;gt;Task bucket size&amp;lt;/code&amp;gt; определяет количество конечных точек, обрабатываемых одной задачей.&lt;br /&gt;
&lt;br /&gt;
Уменьшение значения позволяет распределить большое количество IBM i между несколькими задачами и АктивнымиШлюзами одной группы.&lt;br /&gt;
&lt;br /&gt;
=== Подключение к IBM i ===&lt;br /&gt;
&lt;br /&gt;
Для каждого хоста укажите:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Хост или IP-адрес&lt;br /&gt;
| Имя или адрес контролируемой системы IBM i.&lt;br /&gt;
|-&lt;br /&gt;
| Хранилище учётных данных&lt;br /&gt;
| Включите, чтобы использовать сохранённую пару имени пользователя и пароля.&lt;br /&gt;
|-&lt;br /&gt;
| Имя пользователя&lt;br /&gt;
| Учётная запись IBM i с необходимыми полномочиями.&lt;br /&gt;
|-&lt;br /&gt;
| Пароль&lt;br /&gt;
| Пароль учётной записи. Не используется, если выбрано хранилище учётных данных.&lt;br /&gt;
|-&lt;br /&gt;
| Использовать SSL&lt;br /&gt;
| Включите для защищённого подключения через настроенный IBM i Access ODBC.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Для каждого сервера IBM i создаётся отдельная конечная точка.&lt;br /&gt;
&lt;br /&gt;
=== Активные задания ===&lt;br /&gt;
&lt;br /&gt;
Параметр «Получать наиболее активные задания» включает автоматический сбор заданий, потребляющих больше всего процессорного времени.&lt;br /&gt;
&lt;br /&gt;
По умолчанию собираются 50 наиболее активных заданий. Допускается значение до 500.&lt;br /&gt;
&lt;br /&gt;
При отключении автоматического выбора можно создавать фильтры по:&lt;br /&gt;
&lt;br /&gt;
* имени задания;&lt;br /&gt;
* пользователю;&lt;br /&gt;
* пользователю авторизации;&lt;br /&gt;
* подсистеме;&lt;br /&gt;
* состоянию задания.&lt;br /&gt;
&lt;br /&gt;
Для выбранных состояний можно создавать события журнала. Например, состояние &amp;lt;code&amp;gt;LCKW&amp;lt;/code&amp;gt; указывает на ожидание блокировки.&lt;br /&gt;
&lt;br /&gt;
Чем точнее настроены фильтры, тем меньше нагрузка на IBM i и объём собираемых данных.&lt;br /&gt;
&lt;br /&gt;
=== Очереди заданий ===&lt;br /&gt;
&lt;br /&gt;
Для очередей заданий задаются:&lt;br /&gt;
&lt;br /&gt;
* имя очереди;&lt;br /&gt;
* условие сопоставления;&lt;br /&gt;
* имя библиотеки;&lt;br /&gt;
* условие сопоставления библиотеки.&lt;br /&gt;
&lt;br /&gt;
Конфигурация по умолчанию контролирует очередь &amp;lt;code&amp;gt;QBATCH&amp;lt;/code&amp;gt; в библиотеке &amp;lt;code&amp;gt;QGPL&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Подсистемы ===&lt;br /&gt;
&lt;br /&gt;
Фильтры подсистем позволяют выбрать подсистемы по имени и библиотеке.&lt;br /&gt;
&lt;br /&gt;
По умолчанию настроены:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;QSYSWRK&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;QUSRWRK&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;QSERVER&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;QHTTPSVR&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Очереди сообщений ===&lt;br /&gt;
&lt;br /&gt;
По умолчанию контролируется очередь &amp;lt;code&amp;gt;QSYSOPR&amp;lt;/code&amp;gt; в библиотеке &amp;lt;code&amp;gt;QSYS&amp;lt;/code&amp;gt; с минимальной серьёзностью 50.&lt;br /&gt;
&lt;br /&gt;
Для каждой очереди можно настроить:&lt;br /&gt;
&lt;br /&gt;
* имя очереди;&lt;br /&gt;
* библиотеку;&lt;br /&gt;
* минимальную серьёзность от 0 до 99;&lt;br /&gt;
* идентификаторы сообщений;&lt;br /&gt;
* типы сообщений;&lt;br /&gt;
* необходимость ответа;&lt;br /&gt;
* отправку найденных сообщений как событий журнала.&lt;br /&gt;
&lt;br /&gt;
Пустой список идентификаторов соответствует любому сообщению.&lt;br /&gt;
&lt;br /&gt;
Слишком широкие фильтры могут увеличить нагрузку и объём событий.&lt;br /&gt;
&lt;br /&gt;
=== Журнал истории ===&lt;br /&gt;
&lt;br /&gt;
Набор позволяет получать сообщения журнала истории IBM i.&lt;br /&gt;
&lt;br /&gt;
Можно фильтровать сообщения по:&lt;br /&gt;
&lt;br /&gt;
* библиотеке;&lt;br /&gt;
* файлу сообщений;&lt;br /&gt;
* минимальной серьёзности;&lt;br /&gt;
* идентификатору;&lt;br /&gt;
* типу сообщения.&lt;br /&gt;
&lt;br /&gt;
Все сообщения, соответствующие фильтрам журнала истории, отправляются как события журнала.&lt;br /&gt;
&lt;br /&gt;
Большинство сообщений из очередей также попадает в журнал истории. При одновременном сборе обоих источников возможны дублирующиеся события.&lt;br /&gt;
&lt;br /&gt;
=== Очереди вывода ===&lt;br /&gt;
&lt;br /&gt;
Фильтры очередей вывода задаются по имени очереди и библиотеке.&lt;br /&gt;
&lt;br /&gt;
По умолчанию контролируется очередь &amp;lt;code&amp;gt;QPRINT&amp;lt;/code&amp;gt; в библиотеке &amp;lt;code&amp;gt;QGPL&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
В зависимости от выбранных наборов функций расширение может собирать:&lt;br /&gt;
&lt;br /&gt;
* количество файлов;&lt;br /&gt;
* количество активных обработчиков;&lt;br /&gt;
* общий размер очереди;&lt;br /&gt;
* размер и число страниц отдельных спул-файлов;&lt;br /&gt;
* количество оставшихся копий;&lt;br /&gt;
* общий размер спул-файлов по пользователям.&lt;br /&gt;
&lt;br /&gt;
=== Мониторинг сети ===&lt;br /&gt;
&lt;br /&gt;
Можно указать локальные и удалённые адреса, для которых требуется собирать статистику соединений.&lt;br /&gt;
&lt;br /&gt;
Адреса и порты вводятся списком через запятую.&lt;br /&gt;
&lt;br /&gt;
Для выбранных соединений собираются:&lt;br /&gt;
&lt;br /&gt;
* переданные и полученные байты;&lt;br /&gt;
* время простоя;&lt;br /&gt;
* время прохождения пакетов;&lt;br /&gt;
* отклонение времени прохождения;&lt;br /&gt;
* повторные передачи;&lt;br /&gt;
* количество установленных TCP-соединений.&lt;br /&gt;
&lt;br /&gt;
Не задавайте слишком широкие диапазоны без необходимости.&lt;br /&gt;
&lt;br /&gt;
=== Контроль пользователей ===&lt;br /&gt;
&lt;br /&gt;
Можно включить создание события журнала при блокировке выбранных профилей пользователей.&lt;br /&gt;
&lt;br /&gt;
Имена профилей указываются через запятую. Поддерживаются шаблоны в составе имени, но шаблон из одного символа &amp;lt;code&amp;gt;*&amp;lt;/code&amp;gt; использовать нельзя.&lt;br /&gt;
&lt;br /&gt;
=== Расширенные параметры ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Значение по умолчанию&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Частота опроса&lt;br /&gt;
| &amp;lt;code&amp;gt;1&amp;lt;/code&amp;gt; минута&lt;br /&gt;
| Интервал сбора от 1 до 15 минут. Интервал в одну минуту обеспечивает наиболее подробные данные.&lt;br /&gt;
|-&lt;br /&gt;
| Тайм-аут подключения&lt;br /&gt;
| &amp;lt;code&amp;gt;15&amp;lt;/code&amp;gt; секунд&lt;br /&gt;
| Максимальное время установки соединения. Не рекомендуется устанавливать значение больше 30 секунд.&lt;br /&gt;
|-&lt;br /&gt;
| Тайм-аут запроса&lt;br /&gt;
| &amp;lt;code&amp;gt;60&amp;lt;/code&amp;gt; секунд&lt;br /&gt;
| Максимальное время выполнения отдельного запроса.&lt;br /&gt;
|-&lt;br /&gt;
| Важные состояния заданий&lt;br /&gt;
| Предустановленный список&lt;br /&gt;
| Состояния, которые отображаются отдельно. Остальные объединяются в категорию &amp;lt;code&amp;gt;Other&amp;lt;/code&amp;gt;.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Группировка состояний не изменяет события журнала: в событиях всегда передаётся фактическое состояние задания.&lt;br /&gt;
&lt;br /&gt;
== Наборы функций ==&lt;br /&gt;
&lt;br /&gt;
Набор &amp;lt;code&amp;gt;default&amp;lt;/code&amp;gt; содержит показатель доступности хоста и собирается всегда.&lt;br /&gt;
&lt;br /&gt;
=== Рекомендуемые наборы ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;System status&amp;lt;/code&amp;gt;&lt;br /&gt;
| Задания, использование системного ASP, временное хранилище и активные потоки.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;System activity&amp;lt;/code&amp;gt;&lt;br /&gt;
| Средняя, минимальная и максимальная загрузка процессора, а также CPU rate.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Active Memory pools&amp;lt;/code&amp;gt;&lt;br /&gt;
| Размеры пулов памяти, потоки, ошибки страниц и операции со страницами.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Subsystems&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество активных заданий в подсистемах.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Auxiliary Storage Pools&amp;lt;/code&amp;gt;&lt;br /&gt;
| Ёмкость, доступное пространство и использование ASP.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Job queues&amp;lt;/code&amp;gt;&lt;br /&gt;
| Активные, удерживаемые, освобождённые и запланированные задания.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Active jobs&amp;lt;/code&amp;gt;&lt;br /&gt;
| Процессор, дисковый ввод-вывод, временное хранилище, потоки, время ответа и состояния заданий.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Message queues&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество сообщений, соответствующих настроенным фильтрам.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Disk info&amp;lt;/code&amp;gt;&lt;br /&gt;
| Ёмкость, использование, ввод-вывод, занятость и состояние SSD.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Network interfaces&amp;lt;/code&amp;gt;&lt;br /&gt;
| Состояние и свойства сетевых интерфейсов.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Дополнительные наборы ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Output queues&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество файлов, обработчиков и общий размер очередей вывода.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Output queues - Size&amp;lt;/code&amp;gt;&lt;br /&gt;
| Только общий размер очередей вывода.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Spooled files in output queues&amp;lt;/code&amp;gt;&lt;br /&gt;
| Размер, число страниц и оставшихся копий отдельных спул-файлов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Spooling size by users&amp;lt;/code&amp;gt;&lt;br /&gt;
| Общий размер спул-файлов по пользователям.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;History log&amp;lt;/code&amp;gt;&lt;br /&gt;
| Сообщения журнала истории, соответствующие фильтрам.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Network status&amp;lt;/code&amp;gt;&lt;br /&gt;
| Показатели TCP- и UDP-соединений.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;HTTP server info&amp;lt;/code&amp;gt;&lt;br /&gt;
| Соединения, потоки, запросы, ответы и объём трафика HTTP-серверов IBM i.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Наборы &amp;lt;code&amp;gt;History log&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Network status&amp;lt;/code&amp;gt;, подробные данные спул-файлов и &amp;lt;code&amp;gt;HTTP server info&amp;lt;/code&amp;gt; включайте только при необходимости.&lt;br /&gt;
&lt;br /&gt;
== HTTP-серверы ==&lt;br /&gt;
&lt;br /&gt;
Набор &amp;lt;code&amp;gt;HTTP server info&amp;lt;/code&amp;gt;, добавленный в версии &amp;lt;code&amp;gt;2.6.5&amp;lt;/code&amp;gt;, собирает:&lt;br /&gt;
&lt;br /&gt;
* время с момента запуска и перезапуска;&lt;br /&gt;
* обычные и SSL-соединения;&lt;br /&gt;
* активные и простаивающие потоки;&lt;br /&gt;
* общее количество запросов;&lt;br /&gt;
* отклонённые запросы;&lt;br /&gt;
* отправленные ответы;&lt;br /&gt;
* ответы с ошибками;&lt;br /&gt;
* запросы и ответы по функциям;&lt;br /&gt;
* объём полученных и отправленных данных;&lt;br /&gt;
* время обработки кэшированных и некэшированных ответов.&lt;br /&gt;
&lt;br /&gt;
== Топология и представления ==&lt;br /&gt;
&lt;br /&gt;
Расширение создаёт сущности:&lt;br /&gt;
&lt;br /&gt;
* IBM i Host;&lt;br /&gt;
* пул памяти;&lt;br /&gt;
* задание;&lt;br /&gt;
* ASP;&lt;br /&gt;
* диск;&lt;br /&gt;
* очередь заданий;&lt;br /&gt;
* подсистема;&lt;br /&gt;
* очередь сообщений;&lt;br /&gt;
* журнал истории;&lt;br /&gt;
* очередь вывода;&lt;br /&gt;
* спул-файл;&lt;br /&gt;
* сетевой интерфейс;&lt;br /&gt;
* локальный сетевой адрес;&lt;br /&gt;
* удалённый сетевой адрес;&lt;br /&gt;
* HTTP-сервер.&lt;br /&gt;
&lt;br /&gt;
Сущности связываются с соответствующим хостом IBM i и друг с другом.&lt;br /&gt;
&lt;br /&gt;
В пакет включена готовая панель &amp;lt;code&amp;gt;IBM i Overview&amp;lt;/code&amp;gt; в классическом и новом формате.&lt;br /&gt;
&lt;br /&gt;
Панель содержит сведения о:&lt;br /&gt;
&lt;br /&gt;
* состоянии хостов;&lt;br /&gt;
* загрузке процессора;&lt;br /&gt;
* пулах памяти;&lt;br /&gt;
* активных заданиях;&lt;br /&gt;
* ASP и дисках;&lt;br /&gt;
* очередях заданий;&lt;br /&gt;
* подсистемах;&lt;br /&gt;
* очередях сообщений и вывода;&lt;br /&gt;
* сетевых интерфейсах и соединениях;&lt;br /&gt;
* HTTP-серверах.&lt;br /&gt;
&lt;br /&gt;
== Оповещения ==&lt;br /&gt;
&lt;br /&gt;
В пакет включены шаблоны оповещений:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Оповещение&lt;br /&gt;
! Условие по умолчанию&lt;br /&gt;
|-&lt;br /&gt;
| Критическое заполнение системного ASP&lt;br /&gt;
| Среднее использование выше 80%, не менее трёх нарушений за пять измерений.&lt;br /&gt;
|-&lt;br /&gt;
| Недоступность IBM i&lt;br /&gt;
| Доступность ниже 100%, не менее трёх нарушений за пять измерений.&lt;br /&gt;
|-&lt;br /&gt;
| Высокая загрузка процессора&lt;br /&gt;
| Средняя загрузка выше 70%, не менее трёх нарушений за пять измерений.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
После установки проверьте пороговые значения и адаптируйте их к нормальной нагрузке контролируемых систем.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После сохранения конфигурации:&lt;br /&gt;
&lt;br /&gt;
# Проверьте состояние конечной точки.&lt;br /&gt;
# Убедитесь, что метрика доступности имеет значение.&lt;br /&gt;
# Проверьте поступление показателей системы и процессора.&lt;br /&gt;
# Откройте панель &amp;lt;code&amp;gt;IBM i Overview&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Проверьте создание сущности IBM i Host.&lt;br /&gt;
# Убедитесь, что появились сущности выбранных наборов функций.&lt;br /&gt;
# Если включены сообщения или журнал истории, проверьте поступление событий.&lt;br /&gt;
# Если включён &amp;lt;code&amp;gt;HTTP server info&amp;lt;/code&amp;gt;, проверьте обнаружение HTTP-серверов.&lt;br /&gt;
&lt;br /&gt;
== Устранение неполадок ==&lt;br /&gt;
&lt;br /&gt;
=== Подключение не устанавливается ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* доступность IBM i с АктивногоШлюза;&lt;br /&gt;
* сетевые порты;&lt;br /&gt;
* имя хоста или IP-адрес;&lt;br /&gt;
* имя пользователя и пароль;&lt;br /&gt;
* установку IBM i Access ODBC;&lt;br /&gt;
* соответствие разрядности драйвера и АктивногоШлюза;&lt;br /&gt;
* настройки SSL;&lt;br /&gt;
* тайм-аут подключения.&lt;br /&gt;
&lt;br /&gt;
=== Часть метрик отсутствует ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* выбранные наборы функций;&lt;br /&gt;
* уровень Technology Refresh и PTF;&lt;br /&gt;
* права учётной записи;&lt;br /&gt;
* наличие &amp;lt;code&amp;gt;*JOBCTL&amp;lt;/code&amp;gt;;&lt;br /&gt;
* право &amp;lt;code&amp;gt;*USE&amp;lt;/code&amp;gt; на &amp;lt;code&amp;gt;WRKPTFGRP&amp;lt;/code&amp;gt;;&lt;br /&gt;
* фильтры заданий, очередей и подсистем;&lt;br /&gt;
* журнал расширения на АктивномШлюзе.&lt;br /&gt;
&lt;br /&gt;
=== АктивныйШлюз под Linux потребляет много памяти ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* версию unixODBC;&lt;br /&gt;
* настройку пула соединений;&lt;br /&gt;
* наличие &amp;lt;code&amp;gt;CPTimeout=60&amp;lt;/code&amp;gt;;&lt;br /&gt;
* отсутствие устаревших определений драйвера;&lt;br /&gt;
* количество конечных точек в одной задаче.&lt;br /&gt;
&lt;br /&gt;
=== Слишком много событий ===&lt;br /&gt;
&lt;br /&gt;
Увеличьте минимальную серьёзность и сузьте фильтры по:&lt;br /&gt;
&lt;br /&gt;
* идентификаторам сообщений;&lt;br /&gt;
* типам сообщений;&lt;br /&gt;
* очередям;&lt;br /&gt;
* файлам сообщений;&lt;br /&gt;
* состояниям заданий.&lt;br /&gt;
&lt;br /&gt;
Не собирайте одни и те же сообщения одновременно из очередей и журнала истории без необходимости.&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 2.6.5&lt;br /&gt;
|&lt;br /&gt;
* Добавлен набор метрик &amp;lt;code&amp;gt;HTTP server info&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Добавлена поддержка Python 3.14.&lt;br /&gt;
* Добавлены описания и рекомендации для наборов функций.&lt;br /&gt;
* Минимальная версия Ключ-АСТРОМ — &amp;lt;code&amp;gt;1.318.0&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Минимальная версия среды выполнения расширений — &amp;lt;code&amp;gt;1.313.0&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6970</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6970"/>
		<updated>2026-09-30T05:26:21Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak|Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ|Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory|Microsoft Active Directory]]&lt;br /&gt;
* [[Microsoft Exchange Server]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V|Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix|IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
*[[OpenTelemetry Collector]]&lt;br /&gt;
*[[OpenTelemetry Span Metrics Gateway]]&lt;br /&gt;
*[[RabbitMQ]]&lt;br /&gt;
*[[Prometheus Redis]]&lt;br /&gt;
*[[SOWA Monitor]]&lt;br /&gt;
*[[SOWA]]&lt;br /&gt;
*[[Tomcat JMX]]&lt;br /&gt;
*[[Управление расширениями базы данных SAP Hana|SAP Hana]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=Microsoft_Exchange_Server&amp;diff=6969</id>
		<title>Microsoft Exchange Server</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=Microsoft_Exchange_Server&amp;diff=6969"/>
		<updated>2026-09-30T05:25:53Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «Расширение предназначено для мониторинга локально развёрнутых серверов Microsoft Exchange через WMI. == Назначение ==  Расширение позволяет контролировать состояние Microsoft Exchange Server, анализировать почтовый трафик и транспортные очереди, а также передавать событи...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Расширение предназначено для мониторинга локально развёрнутых серверов Microsoft Exchange через WMI.&lt;br /&gt;
== Назначение ==&lt;br /&gt;
&lt;br /&gt;
Расширение позволяет контролировать состояние Microsoft Exchange Server, анализировать почтовый трафик и транспортные очереди, а также передавать события Exchange в Ключ-АСТРОМ.&lt;br /&gt;
&lt;br /&gt;
С помощью расширения можно:&lt;br /&gt;
&lt;br /&gt;
* контролировать количество отправленных и полученных сообщений;&lt;br /&gt;
* отслеживать скорость обработки сообщений;&lt;br /&gt;
* контролировать объём отправленных и полученных данных;&lt;br /&gt;
* выявлять сообщения, отклонённые из-за размера;&lt;br /&gt;
* отслеживать состояние внутренних и внешних транспортных очередей;&lt;br /&gt;
* обнаруживать задержанные и просроченные сообщения;&lt;br /&gt;
* получать события Microsoft Exchange;&lt;br /&gt;
* создавать оповещения при превышении допустимой длины очередей.&lt;br /&gt;
&lt;br /&gt;
== Поддерживаемые версии ==&lt;br /&gt;
&lt;br /&gt;
Поддерживаются локально развёрнутые версии:&lt;br /&gt;
&lt;br /&gt;
* Microsoft Exchange Server 2013;&lt;br /&gt;
* Microsoft Exchange Server 2016 и более новые версии.&lt;br /&gt;
&lt;br /&gt;
Облачная служба Exchange Online не поддерживается.&lt;br /&gt;
&lt;br /&gt;
== Принцип работы ==&lt;br /&gt;
&lt;br /&gt;
Сбор данных выполняется удалённо через АктивныйШлюз с использованием WMI.&lt;br /&gt;
&lt;br /&gt;
Интервал сбора данных — одна минута.&lt;br /&gt;
&lt;br /&gt;
Расширение получает данные из классов производительности Microsoft Exchange и создаёт в Ключ-АСТРОМ сущности:&lt;br /&gt;
&lt;br /&gt;
* экземпляр Microsoft Exchange;&lt;br /&gt;
* почтовый коннектор;&lt;br /&gt;
* транспортная очередь.&lt;br /&gt;
&lt;br /&gt;
Созданные сущности связываются между собой и с хостом, на котором работает Microsoft Exchange.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
Перед настройкой расширения убедитесь, что:&lt;br /&gt;
&lt;br /&gt;
* АктивныйШлюз имеет сетевой доступ к серверу Microsoft Exchange;&lt;br /&gt;
* на сервере Exchange запущена служба WMI;&lt;br /&gt;
* межсетевой экран разрешает удалённые подключения WMI/DCOM;&lt;br /&gt;
* учётная запись мониторинга имеет право выполнять WMI-запросы;&lt;br /&gt;
* указанные имя хоста или IP-адрес разрешаются с АктивногоШлюза;&lt;br /&gt;
* на сервере зарегистрированы классы производительности Microsoft Exchange.&lt;br /&gt;
&lt;br /&gt;
Если учётная запись мониторинга не является локальным администратором сервера Exchange, добавьте её в следующие локальные группы Windows:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;Performance Monitor Users&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;Event Log Readers&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Группа &amp;lt;code&amp;gt;Event Log Readers&amp;lt;/code&amp;gt; необходима для получения событий Exchange.&lt;br /&gt;
&lt;br /&gt;
Права требуется настроить на каждом контролируемом сервере.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Откройте раздел управления расширениями в Ключ-АСТРОМ.&lt;br /&gt;
# Загрузите архив расширения.&lt;br /&gt;
# Убедитесь, что расширение установлено без ошибок.&lt;br /&gt;
# Откройте страницу Microsoft Exchange Server.&lt;br /&gt;
# Создайте новую конфигурацию мониторинга.&lt;br /&gt;
&lt;br /&gt;
== Настройка подключения ==&lt;br /&gt;
&lt;br /&gt;
При создании конфигурации укажите:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Имя конфигурации&lt;br /&gt;
| Понятное имя конфигурации мониторинга, например &amp;lt;code&amp;gt;Exchange Production&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Группа АктивныхШлюзов&lt;br /&gt;
| Группа АктивныхШлюзов, с которой доступен контролируемый сервер Exchange.&lt;br /&gt;
|-&lt;br /&gt;
| Конечная точка&lt;br /&gt;
| Имя хоста или IP-адрес сервера Microsoft Exchange.&lt;br /&gt;
|-&lt;br /&gt;
| Учётные данные&lt;br /&gt;
| Учётная запись Windows, имеющая права на удалённые WMI-запросы.&lt;br /&gt;
|-&lt;br /&gt;
| Наборы функций&lt;br /&gt;
| Группы собираемых данных. Набор очередей должен соответствовать версии Exchange.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Для мониторинга нескольких серверов добавьте каждый сервер отдельной конечной точкой либо создайте отдельные конфигурации.&lt;br /&gt;
&lt;br /&gt;
После заполнения параметров проверьте подключение и сохраните конфигурацию.&lt;br /&gt;
&lt;br /&gt;
== Наборы функций ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор функций&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;default&amp;lt;/code&amp;gt;&lt;br /&gt;
| Основные показатели отправленных, полученных и отклонённых сообщений. Эти показатели собираются по умолчанию.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;bytes&amp;lt;/code&amp;gt;&lt;br /&gt;
| Объём отправленных и полученных данных, а также скорость передачи данных.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;queues_2013&amp;lt;/code&amp;gt;&lt;br /&gt;
| Показатели транспортных очередей Microsoft Exchange Server 2013.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;queues_2016+&amp;lt;/code&amp;gt;&lt;br /&gt;
| Показатели транспортных очередей и расширенная статистика обработки сообщений для Microsoft Exchange Server 2016 и более новых версий.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;events&amp;lt;/code&amp;gt;&lt;br /&gt;
| События из журнала &amp;lt;code&amp;gt;MSExchange Management&amp;lt;/code&amp;gt; и другие события Microsoft Exchange.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Для одной конечной точки не следует одновременно включать &amp;lt;code&amp;gt;queues_2013&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;queues_2016+&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Используйте:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;queues_2013&amp;lt;/code&amp;gt; для Microsoft Exchange Server 2013;&lt;br /&gt;
* &amp;lt;code&amp;gt;queues_2016+&amp;lt;/code&amp;gt; для Microsoft Exchange Server 2016 и более новых версий.&lt;br /&gt;
&lt;br /&gt;
== Собираемые данные ==&lt;br /&gt;
&lt;br /&gt;
=== Почтовый трафик ===&lt;br /&gt;
&lt;br /&gt;
Расширение собирает:&lt;br /&gt;
&lt;br /&gt;
* общее количество отправленных сообщений;&lt;br /&gt;
* количество отправленных сообщений в секунду;&lt;br /&gt;
* общее количество полученных сообщений;&lt;br /&gt;
* количество полученных сообщений в секунду;&lt;br /&gt;
* количество сообщений, отклонённых из-за превышения размера;&lt;br /&gt;
* общий объём отправленных данных;&lt;br /&gt;
* объём отправленных данных в секунду;&lt;br /&gt;
* общий объём полученных данных;&lt;br /&gt;
* объём полученных данных в секунду.&lt;br /&gt;
&lt;br /&gt;
Показатели объёма данных собираются при включённом наборе функций &amp;lt;code&amp;gt;bytes&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Транспортные очереди ===&lt;br /&gt;
&lt;br /&gt;
Для Microsoft Exchange Server 2013 собираются:&lt;br /&gt;
&lt;br /&gt;
* длина активной очереди доставки в почтовые ящики;&lt;br /&gt;
* длина активной очереди доставки не по SMTP;&lt;br /&gt;
* длина активной внешней очереди удалённой доставки;&lt;br /&gt;
* суммарная длина внешних очередей;&lt;br /&gt;
* длина активной внутренней очереди удалённой доставки;&lt;br /&gt;
* суммарная длина внутренних очередей;&lt;br /&gt;
* длина очереди недоставляемых сообщений;&lt;br /&gt;
* длина очереди повторной доставки в почтовые ящики;&lt;br /&gt;
* длина очереди повторной доставки не по SMTP;&lt;br /&gt;
* длина очереди отправки;&lt;br /&gt;
* количество просроченных сообщений в очереди отправки.&lt;br /&gt;
&lt;br /&gt;
Для Microsoft Exchange Server 2016 и более новых версий дополнительно собираются:&lt;br /&gt;
&lt;br /&gt;
* количество обработанных элементов;&lt;br /&gt;
* скорость обработки элементов;&lt;br /&gt;
* количество элементов, поставленных в очередь;&lt;br /&gt;
* скорость постановки элементов в очередь;&lt;br /&gt;
* количество просроченных элементов;&lt;br /&gt;
* количество обработанных сообщений;&lt;br /&gt;
* скорость обработки сообщений;&lt;br /&gt;
* количество задержанных сообщений;&lt;br /&gt;
* скорость появления задержанных сообщений;&lt;br /&gt;
* текущее и общее количество сообщений в очереди;&lt;br /&gt;
* количество сообщений, поставленных в очередь за секунду;&lt;br /&gt;
* количество отправленных сообщений;&lt;br /&gt;
* скорость отправки сообщений;&lt;br /&gt;
* количество отложенных сообщений в очереди отправки.&lt;br /&gt;
&lt;br /&gt;
=== События Exchange ===&lt;br /&gt;
&lt;br /&gt;
Набор функций &amp;lt;code&amp;gt;events&amp;lt;/code&amp;gt; получает:&lt;br /&gt;
&lt;br /&gt;
* события из журнала &amp;lt;code&amp;gt;MSExchange Management&amp;lt;/code&amp;gt;;&lt;br /&gt;
* события, имя источника которых содержит &amp;lt;code&amp;gt;MSExchange&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Для каждого события передаются:&lt;br /&gt;
&lt;br /&gt;
* источник;&lt;br /&gt;
* код события;&lt;br /&gt;
* категория;&lt;br /&gt;
* текст сообщения;&lt;br /&gt;
* тип события;&lt;br /&gt;
* номер записи;&lt;br /&gt;
* время возникновения.&lt;br /&gt;
&lt;br /&gt;
Включение этого набора может увеличить объём передаваемых данных. Рекомендуется использовать его только на серверах, для которых требуется анализ событий Exchange.&lt;br /&gt;
&lt;br /&gt;
== Панели мониторинга ==&lt;br /&gt;
&lt;br /&gt;
Расширение содержит две готовые панели:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;MS Exchange 2013&amp;lt;/code&amp;gt; — для Microsoft Exchange Server 2013;&lt;br /&gt;
* &amp;lt;code&amp;gt;MS Exchange&amp;lt;/code&amp;gt; — для Microsoft Exchange Server 2016 и более новых версий.&lt;br /&gt;
&lt;br /&gt;
Панели позволяют просматривать:&lt;br /&gt;
&lt;br /&gt;
* отправленные и полученные сообщения;&lt;br /&gt;
* скорость обработки сообщений;&lt;br /&gt;
* объём почтового трафика;&lt;br /&gt;
* отклонённые сообщения;&lt;br /&gt;
* состояние внутренних и внешних очередей;&lt;br /&gt;
* очереди повторной доставки;&lt;br /&gt;
* задержанные и просроченные сообщения;&lt;br /&gt;
* основные показатели хоста.&lt;br /&gt;
&lt;br /&gt;
== Оповещения ==&lt;br /&gt;
&lt;br /&gt;
В пакет включены шаблоны оповещений для следующих ситуаций:&lt;br /&gt;
&lt;br /&gt;
* большое количество сообщений, отклонённых из-за размера;&lt;br /&gt;
* высокая длина внешней транспортной очереди;&lt;br /&gt;
* высокая длина внутренней транспортной очереди;&lt;br /&gt;
* большое количество просроченных элементов;&lt;br /&gt;
* большое количество задержанных сообщений;&lt;br /&gt;
* высокая длина очереди повторной доставки в почтовые ящики;&lt;br /&gt;
* большое количество просроченных сообщений в очереди отправки.&lt;br /&gt;
&lt;br /&gt;
После установки расширения проверьте пороговые значения шаблонов и при необходимости адаптируйте их к обычной нагрузке вашей среды.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После сохранения конфигурации:&lt;br /&gt;
&lt;br /&gt;
# Дождитесь завершения первого цикла сбора.&lt;br /&gt;
# Проверьте состояние конечной точки.&lt;br /&gt;
# Убедитесь, что поступают показатели отправки и получения сообщений.&lt;br /&gt;
# Проверьте поступление данных выбранного набора очередей.&lt;br /&gt;
# Убедитесь, что созданы сущности Microsoft Exchange.&lt;br /&gt;
# Проверьте связь сущности Exchange с контролируемым хостом.&lt;br /&gt;
# Откройте панель, соответствующую версии Exchange.&lt;br /&gt;
# Если включён набор &amp;lt;code&amp;gt;events&amp;lt;/code&amp;gt;, проверьте поступление событий.&lt;br /&gt;
&lt;br /&gt;
== Устранение неполадок ==&lt;br /&gt;
&lt;br /&gt;
=== Данные не поступают ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* доступность сервера с выбранного АктивногоШлюза;&lt;br /&gt;
* правильность имени хоста или IP-адреса;&lt;br /&gt;
* учётные данные и права пользователя;&lt;br /&gt;
* работу службы WMI;&lt;br /&gt;
* настройки межсетевого экрана;&lt;br /&gt;
* поддержку установленной версии Microsoft Exchange.&lt;br /&gt;
&lt;br /&gt;
=== Показатели сообщений поступают, но очереди отсутствуют ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* выбранный набор функций;&lt;br /&gt;
* соответствие набора функций версии Exchange;&lt;br /&gt;
* наличие транспортных классов производительности Exchange в WMI;&lt;br /&gt;
* работу транспортных служб Microsoft Exchange.&lt;br /&gt;
&lt;br /&gt;
Для Exchange 2013 должен использоваться набор &amp;lt;code&amp;gt;queues_2013&amp;lt;/code&amp;gt;, а для Exchange 2016 и более новых версий — &amp;lt;code&amp;gt;queues_2016+&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Не поступают события ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* включён ли набор функций &amp;lt;code&amp;gt;events&amp;lt;/code&amp;gt;;&lt;br /&gt;
* добавлена ли учётная запись в группу &amp;lt;code&amp;gt;Event Log Readers&amp;lt;/code&amp;gt;;&lt;br /&gt;
* имеет ли пользователь доступ к журналам событий Windows;&lt;br /&gt;
* создаются ли на сервере события Microsoft Exchange;&lt;br /&gt;
* доступен ли журнал &amp;lt;code&amp;gt;MSExchange Management&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 1.2.6&lt;br /&gt;
|&lt;br /&gt;
* Начало поддержки расширения.&lt;br /&gt;
&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6968</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6968"/>
		<updated>2026-09-30T04:41:16Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak|Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ|Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory|Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V|Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix|IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
*[[OpenTelemetry Collector]]&lt;br /&gt;
*[[OpenTelemetry Span Metrics Gateway]]&lt;br /&gt;
*[[RabbitMQ]]&lt;br /&gt;
*[[Prometheus Redis]]&lt;br /&gt;
*[[SOWA Monitor]]&lt;br /&gt;
*[[SOWA]]&lt;br /&gt;
*[[Tomcat JMX]]&lt;br /&gt;
*[[Управление расширениями базы данных SAP Hana|SAP Hana]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A3%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5_%D1%80%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F%D0%BC%D0%B8_%D0%B1%D0%B0%D0%B7%D1%8B_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85_SAP_Hana&amp;diff=6967</id>
		<title>Управление расширениями базы данных SAP Hana</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A3%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5_%D1%80%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F%D0%BC%D0%B8_%D0%B1%D0%B0%D0%B7%D1%8B_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85_SAP_Hana&amp;diff=6967"/>
		<updated>2026-09-30T04:39:29Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Расширение &#039;&#039;&#039;SAP HANA&#039;&#039;&#039; предназначено для удалённого сбора показателей работоспособности и производительности баз данных SAP HANA через АктивныйШлюз.&lt;br /&gt;
&lt;br /&gt;
Расширение подключается к SAP HANA с помощью JDBC, выполняет запросы к системным представлениям и передаёт в Ключ-АСТРОМ метрики, журнальные события и сведения для построения топологии.&lt;br /&gt;
&lt;br /&gt;
Идентификатор расширения: &amp;lt;code&amp;gt;ru.ruscomtech.extension.sql-sap-hana&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Основные возможности ==&lt;br /&gt;
&lt;br /&gt;
Расширение позволяет:&lt;br /&gt;
&lt;br /&gt;
* контролировать доступность и состояние SAP HANA;&lt;br /&gt;
* отслеживать загрузку процессора, памяти, дисков и сети;&lt;br /&gt;
* контролировать подключения и активные транзакции;&lt;br /&gt;
* анализировать использование памяти хостами и сервисами;&lt;br /&gt;
* контролировать резервное копирование;&lt;br /&gt;
* отслеживать системную репликацию;&lt;br /&gt;
* анализировать savepoint;&lt;br /&gt;
* контролировать состояние сервисов SAP HANA;&lt;br /&gt;
* отслеживать блокировки и заблокированные транзакции;&lt;br /&gt;
* получать информацию о таблицах и занимаемом ими пространстве;&lt;br /&gt;
* анализировать активные и ресурсоёмкие SQL-запросы;&lt;br /&gt;
* контролировать кэш планов выполнения;&lt;br /&gt;
* получать текущие предупреждения SAP HANA;&lt;br /&gt;
* регистрировать события нехватки памяти;&lt;br /&gt;
* получать информацию о диагностических файлах;&lt;br /&gt;
* контролировать состояние лицензии SAP HANA;&lt;br /&gt;
* создавать сущности хостов, баз данных и сервисов SAP HANA;&lt;br /&gt;
* отображать данные на готовой обзорной панели.&lt;br /&gt;
&lt;br /&gt;
== Архитектура ==&lt;br /&gt;
&lt;br /&gt;
Сбор данных выполняется по следующей схеме:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
Ключ-АСТРОМ&lt;br /&gt;
    |&lt;br /&gt;
    v&lt;br /&gt;
АктивныйШлюз&lt;br /&gt;
    |&lt;br /&gt;
    | JDBC&lt;br /&gt;
    v&lt;br /&gt;
SAP HANA&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Расширение работает удалённо. Установка ЕдиногоАгента непосредственно на сервер SAP HANA для сбора метрик расширения не требуется.&lt;br /&gt;
&lt;br /&gt;
АктивныйШлюз должен иметь сетевой доступ к SQL-порту SAP HANA.&lt;br /&gt;
&lt;br /&gt;
== Поддерживаемые системы ==&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для SAP HANA версии 2.0 и более поздних поддерживаемых выпусков.&lt;br /&gt;
&lt;br /&gt;
Возможность работы с конкретной редакцией, вариантом размещения и исправлением SAP HANA рекомендуется предварительно проверять на тестовой конфигурации.&lt;br /&gt;
&lt;br /&gt;
== Предварительные требования ==&lt;br /&gt;
&lt;br /&gt;
Перед настройкой убедитесь, что:&lt;br /&gt;
&lt;br /&gt;
* расширение установлено в среде Ключ-АСТРОМ;&lt;br /&gt;
* назначена группа АктивныхШлюзов;&lt;br /&gt;
* каждый АктивныйШлюз выбранной группы имеет доступ к SAP HANA;&lt;br /&gt;
* на АктивномШлюзе установлен JDBC-драйвер SAP HANA;&lt;br /&gt;
* известны имя узла и SQL-порт базы данных;&lt;br /&gt;
* создан отдельный пользователь мониторинга;&lt;br /&gt;
* пользователю выданы права на чтение системных представлений;&lt;br /&gt;
* межсетевой экран разрешает подключение АктивногоШлюза к SAP HANA;&lt;br /&gt;
* имя сервера разрешается через DNS либо используется IP-адрес;&lt;br /&gt;
* при использовании SSL подготовлена доверенная цепочка сертификатов.&lt;br /&gt;
&lt;br /&gt;
== Создание пользователя мониторинга ==&lt;br /&gt;
&lt;br /&gt;
Рекомендуется создать отдельного пользователя, предназначенного только для мониторинга.&lt;br /&gt;
&lt;br /&gt;
Пример:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
CREATE USER ASTROM_MONITOR&lt;br /&gt;
PASSWORD &amp;quot;ЗАМЕНИТЕ_НА_НАДЕЖНЫЙ_ПАРОЛЬ&amp;quot;&lt;br /&gt;
NO FORCE_FIRST_PASSWORD_CHANGE;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Предоставьте пользователю роль &amp;lt;code&amp;gt;MONITORING&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
GRANT MONITORING TO ASTROM_MONITOR;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Роль &amp;lt;code&amp;gt;PUBLIC&amp;lt;/code&amp;gt; назначается пользователям SAP HANA автоматически.&lt;br /&gt;
&lt;br /&gt;
Пользователь должен иметь возможность читать системные представления, используемые выбранными наборами функций. Если отдельный набор функций возвращает ошибку недостаточных прав, предоставьте доступ только к требуемому системному представлению.&lt;br /&gt;
&lt;br /&gt;
Не рекомендуется использовать для мониторинга системного администратора или пользователя с правами изменения данных.&lt;br /&gt;
&lt;br /&gt;
== Установка JDBC-драйвера ==&lt;br /&gt;
&lt;br /&gt;
Драйвер SAP HANA не входит в пакет расширения и устанавливается отдельно на каждый АктивныйШлюз, который может выполнять конфигурацию.&lt;br /&gt;
&lt;br /&gt;
Требуется файл:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
ngdbc.jar&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Его можно получить из установленного SAP HANA Client.&lt;br /&gt;
&lt;br /&gt;
Стандартные расположения драйвера:&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Windows:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
C:\Program Files\SAP\hdbclient\ngdbc.jar&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Linux:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
/usr/sap/hdbclient/ngdbc.jar&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Скопируйте файл &amp;lt;code&amp;gt;ngdbc.jar&amp;lt;/code&amp;gt; в каталог пользовательских библиотек АктивногоШлюза.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Windows:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
C:\ProgramData\astromkey\remotepluginmodule\agent\conf\userdata\libs&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Linux:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
/var/lib/astromkey/remotepluginmodule/agent/conf/userdata/libs/&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
После установки или замены драйвера перезапустите службу АктивногоШлюза.&lt;br /&gt;
&lt;br /&gt;
Убедитесь, что пользователь, от имени которого работает служба АктивногоШлюза, имеет права на чтение файла.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Откройте раздел управления расширениями в Ключ-АСТРОМ.&lt;br /&gt;
# Если расширение ещё не установлено, загрузите подписанный архив расширения.&lt;br /&gt;
# Найдите расширение &#039;&#039;&#039;SAP HANA&#039;&#039;&#039;.&lt;br /&gt;
# Откройте страницу расширения.&lt;br /&gt;
# Создайте конфигурацию мониторинга.&lt;br /&gt;
# Выберите группу АктивныхШлюзов.&lt;br /&gt;
# Добавьте конечную точку SAP HANA.&lt;br /&gt;
# Укажите учётные данные.&lt;br /&gt;
# Выберите необходимые наборы функций.&lt;br /&gt;
# Сохраните и активируйте конфигурацию.&lt;br /&gt;
&lt;br /&gt;
== Настройка конечных точек ==&lt;br /&gt;
&lt;br /&gt;
Каждая конечная точка представляет отдельное подключение к базе данных SAP HANA.&lt;br /&gt;
&lt;br /&gt;
В мастере одной конфигурации можно определить до 100 конечных точек. Все конечные точки одной конфигурации выполняются на одном АктивномШлюзе выбранной группы.&lt;br /&gt;
&lt;br /&gt;
Для каждой конечной точки укажите:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Хост&lt;br /&gt;
| Полное доменное имя или IP-адрес SAP HANA.&lt;br /&gt;
|-&lt;br /&gt;
| Порт&lt;br /&gt;
| SQL-порт соответствующей системной или пользовательской базы данных.&lt;br /&gt;
|-&lt;br /&gt;
| Имя пользователя&lt;br /&gt;
| Пользователь SAP HANA с правами мониторинга.&lt;br /&gt;
|-&lt;br /&gt;
| Пароль&lt;br /&gt;
| Пароль пользователя мониторинга.&lt;br /&gt;
|-&lt;br /&gt;
| SSL&lt;br /&gt;
| Использование защищённого подключения.&lt;br /&gt;
|-&lt;br /&gt;
| Проверка сертификата&lt;br /&gt;
| Проверка доверия к сертификату и соответствия имени узла.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Пример конечной точки:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
hana01.example.local:30015&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Порт &amp;lt;code&amp;gt;30015&amp;lt;/code&amp;gt; приведён только как пример. Фактический SQL-порт зависит от номера экземпляра и конфигурации SAP HANA.&lt;br /&gt;
&lt;br /&gt;
Для многокомпонентной системы добавьте отдельные конечные точки для тех баз данных, из которых необходимо собирать данные.&lt;br /&gt;
&lt;br /&gt;
== Параметры расширения ==&lt;br /&gt;
&lt;br /&gt;
=== Переопределение имени узла ===&lt;br /&gt;
&lt;br /&gt;
Параметр &amp;lt;code&amp;gt;Override Captured Host Name&amp;lt;/code&amp;gt; позволяет задать имя, под которым узел будет представлен в Ключ-АСТРОМ.&lt;br /&gt;
&lt;br /&gt;
Используйте его, если:&lt;br /&gt;
&lt;br /&gt;
* адрес подключения отличается от фактического имени сервера;&lt;br /&gt;
* подключение выполняется через виртуальный адрес;&lt;br /&gt;
* требуется единое отображаемое имя;&lt;br /&gt;
* несколько адресов относятся к одному логическому узлу.&lt;br /&gt;
&lt;br /&gt;
Изменение этого параметра для уже работающей конфигурации может привести к созданию новых сущностей.&lt;br /&gt;
&lt;br /&gt;
=== Тайм-аут тяжёлых запросов ===&lt;br /&gt;
&lt;br /&gt;
Параметр &amp;lt;code&amp;gt;Override query timeout seconds for heavy queries&amp;lt;/code&amp;gt; задаёт тайм-аут выполнения ресурсоёмких запросов расширения.&lt;br /&gt;
&lt;br /&gt;
Значение по умолчанию:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
10 секунд&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Увеличивайте значение только при возникновении ошибок тайм-аута. Перед увеличением проверьте нагрузку на SAP HANA и длительность соответствующего системного запроса.&lt;br /&gt;
&lt;br /&gt;
=== Фильтр схем ===&lt;br /&gt;
&lt;br /&gt;
Параметр &amp;lt;code&amp;gt;Schema Name Filter&amp;lt;/code&amp;gt; ограничивает сбор набора &amp;lt;code&amp;gt;Table Information&amp;lt;/code&amp;gt; определёнными схемами.&lt;br /&gt;
&lt;br /&gt;
Фильтр рекомендуется использовать в системах с большим количеством схем и таблиц.&lt;br /&gt;
&lt;br /&gt;
=== Фильтр таблиц ===&lt;br /&gt;
&lt;br /&gt;
Параметр &amp;lt;code&amp;gt;Table Name Filter&amp;lt;/code&amp;gt; ограничивает сбор набора &amp;lt;code&amp;gt;Table Information&amp;lt;/code&amp;gt; определёнными таблицами.&lt;br /&gt;
&lt;br /&gt;
Фильтры схем и таблиц позволяют уменьшить количество временных рядов и нагрузку на базу данных.&lt;br /&gt;
&lt;br /&gt;
== Наборы функций ==&lt;br /&gt;
&lt;br /&gt;
Включайте только необходимые наборы. Некоторые проверки выполняют ресурсоёмкие запросы или создают журнальные записи.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Base Metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Основные показатели базы данных, сервисов, транзакций, блокировок, диагностических файлов и кэша планов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Host Infrastructure Metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Процессор, память, диски, подключения и транзакции на уровне хоста.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Host Infrastructure Network Rates&amp;lt;/code&amp;gt;&lt;br /&gt;
| Объём входящего и исходящего сетевого трафика.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Host Agent Network Rates&amp;lt;/code&amp;gt;&lt;br /&gt;
| Скорость передачи данных по сетевым интерфейсам.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Disk Size Usage&amp;lt;/code&amp;gt;&lt;br /&gt;
| Общий, использованный и свободный объём дискового пространства.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Schema Disk Metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование дискового пространства отдельными схемами.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Table Size vs Allocation Limit Usage&amp;lt;/code&amp;gt;&lt;br /&gt;
| Отношение размера таблиц к установленному пределу выделения памяти.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Backup Metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество, размер, продолжительность, возраст и ошибки резервного копирования.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;HANA License&amp;lt;/code&amp;gt;&lt;br /&gt;
| Состояние, срок действия и ограничение лицензии.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Host Temp Heap Usage&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование временной heap-памяти.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Unloads Due to Low Memory&amp;lt;/code&amp;gt;&lt;br /&gt;
| Выгрузки данных, вызванные нехваткой памяти.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Replication Metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Состояние репликации, задержка доставки журналов, ошибки и возраст снимка.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Savepoint Metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество, продолжительность критической фазы и время с предыдущего savepoint.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Service Response Time&amp;lt;/code&amp;gt;&lt;br /&gt;
| Время отклика сервисов SAP HANA.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Table Information&amp;lt;/code&amp;gt;&lt;br /&gt;
| Размер, тип, количество записей и блокировки таблиц.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Active Prepared Statements&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество активных подготовленных SQL-операторов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;SQL Plan Cache Size&amp;lt;/code&amp;gt;&lt;br /&gt;
| Размер кэша SQL-планов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Current Alerts&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущие предупреждения SAP HANA в виде журнальных событий.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Expensive Statements&amp;lt;/code&amp;gt;&lt;br /&gt;
| Подробные сведения о ресурсоёмких SQL-запросах в виде журнальных событий.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Expensive Statement Metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Агрегированные показатели ресурсоёмких запросов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Extended Expensive Statement Metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Дополнительные показатели запросов, превысивших ограничения времени и памяти.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Out Of Memory Events&amp;lt;/code&amp;gt;&lt;br /&gt;
| События нехватки памяти в виде журнальных записей.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Trace File Information&amp;lt;/code&amp;gt;&lt;br /&gt;
| Информация о новых и изменённых диагностических файлах.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Собираемые данные ==&lt;br /&gt;
&lt;br /&gt;
=== Инфраструктура ===&lt;br /&gt;
&lt;br /&gt;
Расширение собирает:&lt;br /&gt;
&lt;br /&gt;
* загрузку процессора;&lt;br /&gt;
* общий и использованный объём памяти;&lt;br /&gt;
* процент использования памяти;&lt;br /&gt;
* общий и использованный объём диска;&lt;br /&gt;
* процент использования диска;&lt;br /&gt;
* скорость дисковых операций чтения и записи;&lt;br /&gt;
* входящий и исходящий сетевой трафик;&lt;br /&gt;
* скорость работы сетевых интерфейсов;&lt;br /&gt;
* количество открытых подключений;&lt;br /&gt;
* количество выполняющихся подключений;&lt;br /&gt;
* долю использованных подключений;&lt;br /&gt;
* количество активных транзакций;&lt;br /&gt;
* долю использованных транзакций.&lt;br /&gt;
&lt;br /&gt;
=== Память ===&lt;br /&gt;
&lt;br /&gt;
Доступны показатели:&lt;br /&gt;
&lt;br /&gt;
* максимальное использование heap-памяти;&lt;br /&gt;
* использование временной heap-памяти;&lt;br /&gt;
* глобальный предел выделения памяти;&lt;br /&gt;
* использованная память экземпляра;&lt;br /&gt;
* использованная физическая память;&lt;br /&gt;
* память отдельных сервисов;&lt;br /&gt;
* память column store;&lt;br /&gt;
* память row store;&lt;br /&gt;
* количество выгрузок из-за нехватки памяти;&lt;br /&gt;
* события исчерпания памяти.&lt;br /&gt;
&lt;br /&gt;
=== Резервное копирование ===&lt;br /&gt;
&lt;br /&gt;
Расширение получает:&lt;br /&gt;
&lt;br /&gt;
* количество резервных копий;&lt;br /&gt;
* оценочный размер резервных копий;&lt;br /&gt;
* время с момента предыдущей резервной копии;&lt;br /&gt;
* продолжительность резервного копирования;&lt;br /&gt;
* тип резервной копии;&lt;br /&gt;
* количество неуспешных операций.&lt;br /&gt;
&lt;br /&gt;
=== Репликация ===&lt;br /&gt;
&lt;br /&gt;
Для системной репликации собираются:&lt;br /&gt;
&lt;br /&gt;
* состояние репликации;&lt;br /&gt;
* режим репликации;&lt;br /&gt;
* состояние полной синхронизации;&lt;br /&gt;
* количество переключений вторичного узла;&lt;br /&gt;
* задержка доставки журналов;&lt;br /&gt;
* количество ошибок;&lt;br /&gt;
* возраст последнего снимка репликации.&lt;br /&gt;
&lt;br /&gt;
=== Savepoint ===&lt;br /&gt;
&lt;br /&gt;
Отслеживаются:&lt;br /&gt;
&lt;br /&gt;
* количество savepoint;&lt;br /&gt;
* продолжительность последней критической фазы;&lt;br /&gt;
* время с момента предыдущего savepoint.&lt;br /&gt;
&lt;br /&gt;
=== Сервисы SAP HANA ===&lt;br /&gt;
&lt;br /&gt;
Для сервисов собираются:&lt;br /&gt;
&lt;br /&gt;
* имя и порт сервиса;&lt;br /&gt;
* SQL-порт;&lt;br /&gt;
* активное состояние;&lt;br /&gt;
* использование памяти;&lt;br /&gt;
* использование процессора;&lt;br /&gt;
* время отклика;&lt;br /&gt;
* состояние потоков;&lt;br /&gt;
* статистика delta merge;&lt;br /&gt;
* используемый и общий размер томов.&lt;br /&gt;
&lt;br /&gt;
=== Таблицы и схемы ===&lt;br /&gt;
&lt;br /&gt;
Расширение позволяет отслеживать:&lt;br /&gt;
&lt;br /&gt;
* тип таблицы;&lt;br /&gt;
* количество записей;&lt;br /&gt;
* размер таблицы;&lt;br /&gt;
* схему;&lt;br /&gt;
* расположение таблицы;&lt;br /&gt;
* количество блокировок;&lt;br /&gt;
* использованное схемой дисковое пространство;&lt;br /&gt;
* долю схемы в общем размере;&lt;br /&gt;
* отношение размеров таблиц к пределу выделения памяти.&lt;br /&gt;
&lt;br /&gt;
В больших системах обязательно используйте фильтры схем и таблиц.&lt;br /&gt;
&lt;br /&gt;
=== SQL-запросы ===&lt;br /&gt;
&lt;br /&gt;
Собираются:&lt;br /&gt;
&lt;br /&gt;
* количество активных операторов;&lt;br /&gt;
* размер кэша планов;&lt;br /&gt;
* коэффициент попаданий в кэш планов;&lt;br /&gt;
* общее количество ресурсоёмких запросов;&lt;br /&gt;
* запросы, превысившие ограничение памяти;&lt;br /&gt;
* запросы, превысившие ограничение продолжительности;&lt;br /&gt;
* текст SQL-запроса;&lt;br /&gt;
* операция;&lt;br /&gt;
* пользователь базы данных;&lt;br /&gt;
* пользователь приложения;&lt;br /&gt;
* продолжительность;&lt;br /&gt;
* процессорное время;&lt;br /&gt;
* использованная память;&lt;br /&gt;
* схема;&lt;br /&gt;
* класс рабочей нагрузки.&lt;br /&gt;
&lt;br /&gt;
Текст SQL-запроса может содержать конфиденциальные сведения. Перед включением набора &amp;lt;code&amp;gt;Expensive Statements&amp;lt;/code&amp;gt; проверьте требования информационной безопасности.&lt;br /&gt;
&lt;br /&gt;
== Журнальные события ==&lt;br /&gt;
&lt;br /&gt;
Некоторые наборы передают данные как журнальные события.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Интервал&lt;br /&gt;
! Содержимое&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Out Of Memory Events&amp;lt;/code&amp;gt;&lt;br /&gt;
| 5 минут&lt;br /&gt;
| Время события, причина, запрошенная и использованная память, установленный предел.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Trace File Information&amp;lt;/code&amp;gt;&lt;br /&gt;
| 5 минут&lt;br /&gt;
| Имя, размер и время изменения диагностического файла.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Current Alerts&amp;lt;/code&amp;gt;&lt;br /&gt;
| 5 минут&lt;br /&gt;
| Идентификатор, название, описание, рейтинг и рекомендуемое действие.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Expensive Statements&amp;lt;/code&amp;gt;&lt;br /&gt;
| 5 минут&lt;br /&gt;
| Текст запроса, пользователь, продолжительность, процессорное время и использование памяти.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Большинство обычных метрик собирается каждую минуту. Метрики свойств и журнальные события обычно обновляются каждые пять минут.&lt;br /&gt;
&lt;br /&gt;
== Используемые системные представления ==&lt;br /&gt;
&lt;br /&gt;
Основные источники данных:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Назначение&lt;br /&gt;
! Представления&lt;br /&gt;
|-&lt;br /&gt;
| Диагностика&lt;br /&gt;
| &amp;lt;code&amp;gt;SYS.M_OUT_OF_MEMORY_EVENTS&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_TRACEFILES&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Резервное копирование&lt;br /&gt;
| &amp;lt;code&amp;gt;SYS.M_BACKUP_CATALOG&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_BACKUP_CATALOG_FILES&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_BACKUP_SIZE_ESTIMATIONS&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Инфраструктура&lt;br /&gt;
| &amp;lt;code&amp;gt;SYS.M_HOST_RESOURCE_UTILIZATION&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_HOST_AGENT_METRICS&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_VOLUME_IO_TOTAL_STATISTICS_RESET&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Свойства&lt;br /&gt;
| &amp;lt;code&amp;gt;SYS.M_SYSTEM_LIMITS&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_LICENSE&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_HOST_INFORMATION&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Память&lt;br /&gt;
| &amp;lt;code&amp;gt;SYS.M_HEAP_MEMORY&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_MEMORY_OBJECT_DISPOSITIONS&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_CS_UNLOADS&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Репликация&lt;br /&gt;
| &amp;lt;code&amp;gt;SYS.M_SERVICE_REPLICATION&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_SNAPSHOTS&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Savepoint&lt;br /&gt;
| &amp;lt;code&amp;gt;SYS.M_SAVEPOINT_STATISTICS&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_SAVEPOINTS&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Сервисы&lt;br /&gt;
| &amp;lt;code&amp;gt;SYS.M_SERVICES&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_SERVICE_MEMORY&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_SERVICE_STATISTICS&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Таблицы и транзакции&lt;br /&gt;
| &amp;lt;code&amp;gt;SYS.M_TABLES&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_TABLE_LOCATIONS&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_TABLE_LOCKS&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_TRANSACTIONS&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_BLOCKED_TRANSACTIONS&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| SQL-запросы&lt;br /&gt;
| &amp;lt;code&amp;gt;SYS.M_ACTIVE_STATEMENTS&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_SQL_PLAN_STATISTICS&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_EXPENSIVE_STATEMENTS&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SYS.M_SQL_PLAN_CACHE_OVERVIEW&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Предупреждения&lt;br /&gt;
| &amp;lt;code&amp;gt;_SYS_STATISTICS.STATISTICS_CURRENT_ALERTS&amp;lt;/code&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Расширение выполняет запросы чтения и не должно изменять пользовательские данные.&lt;br /&gt;
&lt;br /&gt;
== Топология ==&lt;br /&gt;
&lt;br /&gt;
Расширение создаёт следующие сущности:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;sql:hana_db_host&amp;lt;/code&amp;gt; — хост SAP HANA;&lt;br /&gt;
* &amp;lt;code&amp;gt;sql:hana_db_service&amp;lt;/code&amp;gt; — сервис SAP HANA;&lt;br /&gt;
* &amp;lt;code&amp;gt;sql:hana_db_database&amp;lt;/code&amp;gt; — база данных SAP HANA.&lt;br /&gt;
&lt;br /&gt;
Для сущностей сохраняются свойства:&lt;br /&gt;
&lt;br /&gt;
* имя хоста;&lt;br /&gt;
* IP-адрес;&lt;br /&gt;
* версия сборки;&lt;br /&gt;
* имя базы данных;&lt;br /&gt;
* имя и порт сервиса;&lt;br /&gt;
* SQL-порт;&lt;br /&gt;
* состояние сервиса;&lt;br /&gt;
* сведения о лицензии;&lt;br /&gt;
* ограничения количества сессий и транзакций;&lt;br /&gt;
* состояние репликации.&lt;br /&gt;
&lt;br /&gt;
Если на сервере установлен ЕдиныйАгент, расширение может связать сущность сервиса SAP HANA с соответствующим экземпляром процесса по IP-адресу и прослушиваемому порту.&lt;br /&gt;
&lt;br /&gt;
== Обзорная панель ==&lt;br /&gt;
&lt;br /&gt;
В пакет входит обзорная панель:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
SAP HANA DB Overview&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Она содержит сведения о:&lt;br /&gt;
&lt;br /&gt;
* отслеживаемых хостах;&lt;br /&gt;
* загрузке процессора;&lt;br /&gt;
* использовании памяти;&lt;br /&gt;
* дисковом пространстве;&lt;br /&gt;
* скорости дисковых операций;&lt;br /&gt;
* сетевом трафике;&lt;br /&gt;
* сервисах SAP HANA;&lt;br /&gt;
* базах данных;&lt;br /&gt;
* состоянии репликации;&lt;br /&gt;
* SQL-запросах и транзакциях.&lt;br /&gt;
&lt;br /&gt;
== Настройка SSL ==&lt;br /&gt;
&lt;br /&gt;
Включите SSL в конфигурации конечной точки, если подключение SAP HANA должно быть зашифровано.&lt;br /&gt;
&lt;br /&gt;
При использовании сертификата от общедоступного центра сертификации дополнительное хранилище обычно не требуется.&lt;br /&gt;
&lt;br /&gt;
Для внутреннего или самоподписанного сертификата создайте доверенное хранилище PKCS12 на каждом АктивномШлюзе выбранной группы.&lt;br /&gt;
&lt;br /&gt;
Каталог &amp;lt;code&amp;gt;userdata&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Windows:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
C:\ProgramData\astromkey\remotepluginmodule\agent\conf\userdata&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Linux:&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
/var/lib/astromkey/remotepluginmodule/agent/conf/userdata&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Имя хранилища:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
sqlds_truststore&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Пример импорта сертификата:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
keytool -importcert \&lt;br /&gt;
  -alias sap-hana-ca \&lt;br /&gt;
  -file hana-ca.crt \&lt;br /&gt;
  -keystore sqlds_truststore \&lt;br /&gt;
  -storetype PKCS12 \&lt;br /&gt;
  -storepass sqlds_truststore&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
После изменения хранилища перезапустите АктивныйШлюз.&lt;br /&gt;
&lt;br /&gt;
При включённой проверке сертификата имя сервера в конечной точке должно соответствовать имени из сертификата.&lt;br /&gt;
&lt;br /&gt;
== Хранилище учётных данных ==&lt;br /&gt;
&lt;br /&gt;
Вместо хранения имени пользователя и пароля непосредственно в конфигурации можно использовать хранилище учётных данных.&lt;br /&gt;
&lt;br /&gt;
Учётные данные должны:&lt;br /&gt;
&lt;br /&gt;
* иметь тип «Пользователь и пароль»;&lt;br /&gt;
* быть доступны расширениям;&lt;br /&gt;
* принадлежать пользователю, создающему конфигурацию;&lt;br /&gt;
* быть разрешены для выбранной области действия.&lt;br /&gt;
&lt;br /&gt;
Пример фрагмента JSON:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;authentication&amp;quot;: {&lt;br /&gt;
  &amp;quot;scheme&amp;quot;: &amp;quot;basic&amp;quot;,&lt;br /&gt;
  &amp;quot;useCredentialVault&amp;quot;: true,&lt;br /&gt;
  &amp;quot;skipVerifyHttps&amp;quot;: false,&lt;br /&gt;
  &amp;quot;credentialVaultId&amp;quot;: &amp;quot;ИДЕНТИФИКАТОР_УЧЕТНЫХ_ДАННЫХ&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Настройка через API ==&lt;br /&gt;
&lt;br /&gt;
Мастер создания конфигурации формирует JSON автоматически. Рекомендуется сначала настроить подключение через интерфейс, а затем использовать сформированный JSON как шаблон для API.&lt;br /&gt;
&lt;br /&gt;
Пример:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
[&lt;br /&gt;
  {&lt;br /&gt;
    &amp;quot;value&amp;quot;: {&lt;br /&gt;
      &amp;quot;enabled&amp;quot;: true,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;SAP HANA production&amp;quot;,&lt;br /&gt;
      &amp;quot;version&amp;quot;: &amp;quot;2.4.2&amp;quot;,&lt;br /&gt;
      &amp;quot;featureSets&amp;quot;: [&lt;br /&gt;
        &amp;quot;Base Metrics&amp;quot;,&lt;br /&gt;
        &amp;quot;Host Infrastructure Metrics&amp;quot;,&lt;br /&gt;
        &amp;quot;Backup Metrics&amp;quot;,&lt;br /&gt;
        &amp;quot;Replication Metrics&amp;quot;&lt;br /&gt;
      ],&lt;br /&gt;
      &amp;quot;sqlHanaRemote&amp;quot;: {&lt;br /&gt;
        &amp;quot;endpoints&amp;quot;: [&lt;br /&gt;
          {&lt;br /&gt;
            &amp;quot;host&amp;quot;: &amp;quot;hana01.example.local&amp;quot;,&lt;br /&gt;
            &amp;quot;port&amp;quot;: 30015,&lt;br /&gt;
            &amp;quot;authentication&amp;quot;: {&lt;br /&gt;
              &amp;quot;username&amp;quot;: &amp;quot;ASTROM_MONITOR&amp;quot;,&lt;br /&gt;
              &amp;quot;password&amp;quot;: &amp;quot;ЗАМЕНИТЕ_ПАРОЛЬ&amp;quot;&lt;br /&gt;
            },&lt;br /&gt;
            &amp;quot;ssl&amp;quot;: true,&lt;br /&gt;
            &amp;quot;validateCertificates&amp;quot;: true&lt;br /&gt;
          }&lt;br /&gt;
        ]&lt;br /&gt;
      }&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;scope&amp;quot;: &amp;quot;ag_group-default&amp;quot;&lt;br /&gt;
  }&lt;br /&gt;
]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Замените:&lt;br /&gt;
&lt;br /&gt;
* адрес и порт SAP HANA;&lt;br /&gt;
* имя пользователя и пароль;&lt;br /&gt;
* наборы функций;&lt;br /&gt;
* имя группы АктивныхШлюзов;&lt;br /&gt;
* параметры SSL.&lt;br /&gt;
&lt;br /&gt;
Не храните действующие пароли в файлах конфигурации и системах контроля версий.&lt;br /&gt;
&lt;br /&gt;
Чтобы включить все наборы функций, можно указать:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;featureSets&amp;quot;: [&lt;br /&gt;
  &amp;quot;all&amp;quot;&lt;br /&gt;
]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Включение всех наборов может существенно увеличить нагрузку и объём принимаемых данных.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После активации конфигурации:&lt;br /&gt;
&lt;br /&gt;
# Выполните проверку подключения.&lt;br /&gt;
# Убедитесь, что конфигурация перешла в рабочее состояние.&lt;br /&gt;
# Подождите несколько интервалов сбора.&lt;br /&gt;
# Найдите сущности SAP HANA в списке объектов.&lt;br /&gt;
# Проверьте появление хоста, базы данных и сервисов.&lt;br /&gt;
# Откройте панель &amp;lt;code&amp;gt;SAP HANA DB Overview&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Проверьте поступление метрик.&lt;br /&gt;
# Если включены журнальные наборы, проверьте поступление событий.&lt;br /&gt;
# Убедитесь, что отсутствуют ошибки прав доступа и тайм-ауты запросов.&lt;br /&gt;
&lt;br /&gt;
== Устранение неполадок ==&lt;br /&gt;
&lt;br /&gt;
=== Драйвер не найден ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* наличие файла &amp;lt;code&amp;gt;ngdbc.jar&amp;lt;/code&amp;gt;;&lt;br /&gt;
* каталог установки;&lt;br /&gt;
* права на чтение файла;&lt;br /&gt;
* установку драйвера на всех АктивныхШлюзах группы;&lt;br /&gt;
* перезапуск службы после установки драйвера.&lt;br /&gt;
&lt;br /&gt;
=== Ошибка подключения ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* имя сервера;&lt;br /&gt;
* SQL-порт;&lt;br /&gt;
* доступность порта с АктивногоШлюза;&lt;br /&gt;
* правила межсетевого экрана;&lt;br /&gt;
* состояние SAP HANA;&lt;br /&gt;
* соответствие конечной точки требуемой базе данных;&lt;br /&gt;
* настройки SSL.&lt;br /&gt;
&lt;br /&gt;
=== Ошибка аутентификации ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* имя пользователя и пароль;&lt;br /&gt;
* состояние пользователя;&lt;br /&gt;
* необходимость смены первоначального пароля;&lt;br /&gt;
* срок действия пароля;&lt;br /&gt;
* назначение роли &amp;lt;code&amp;gt;MONITORING&amp;lt;/code&amp;gt;;&lt;br /&gt;
* доступ к системным представлениям.&lt;br /&gt;
&lt;br /&gt;
=== Ошибка сертификата ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* доверие к корневому и промежуточным сертификатам;&lt;br /&gt;
* наличие сертификатов в &amp;lt;code&amp;gt;sqlds_truststore&amp;lt;/code&amp;gt;;&lt;br /&gt;
* имя сервера в сертификате;&lt;br /&gt;
* установку хранилища на всех АктивныхШлюзах группы;&lt;br /&gt;
* перезапуск службы после изменения хранилища.&lt;br /&gt;
&lt;br /&gt;
=== Часть метрик отсутствует ===&lt;br /&gt;
&lt;br /&gt;
Проверьте:&lt;br /&gt;
&lt;br /&gt;
* включён ли соответствующий набор функций;&lt;br /&gt;
* существуют ли необходимые системные представления в используемой версии SAP HANA;&lt;br /&gt;
* права пользователя;&lt;br /&gt;
* фильтры схем и таблиц;&lt;br /&gt;
* наличие исходных данных;&lt;br /&gt;
* ошибки выполнения SQL-запросов в состоянии расширения.&lt;br /&gt;
&lt;br /&gt;
=== Запросы завершаются по тайм-ауту ===&lt;br /&gt;
&lt;br /&gt;
Проверьте нагрузку на SAP HANA и выполнение запроса вручную.&lt;br /&gt;
&lt;br /&gt;
При необходимости увеличьте параметр тайм-аута тяжёлых запросов. Не увеличивайте его без предварительной диагностики.&lt;br /&gt;
&lt;br /&gt;
=== Создались новые сущности ===&lt;br /&gt;
&lt;br /&gt;
Проверьте, не изменялось ли значение &amp;lt;code&amp;gt;Override Captured Host Name&amp;lt;/code&amp;gt;. Оно участвует в формировании идентификаторов сущностей.&lt;br /&gt;
&lt;br /&gt;
== Рекомендации по производительности ==&lt;br /&gt;
&lt;br /&gt;
* Не включайте наборы функций, данные которых не используются.&lt;br /&gt;
* Применяйте фильтры схем и таблиц.&lt;br /&gt;
* Осторожно включайте сбор ресурсоёмких SQL-запросов.&lt;br /&gt;
* Учитывайте, что журнальные события увеличивают объём принимаемых данных.&lt;br /&gt;
* Не размещайте чрезмерное количество нагруженных конечных точек на одном АктивномШлюзе.&lt;br /&gt;
* Разделяйте крупные среды между несколькими группами АктивныхШлюзов.&lt;br /&gt;
* Контролируйте длительность системных запросов после включения новых наборов.&lt;br /&gt;
* Сначала проверяйте конфигурацию в тестовой среде.&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 2.4.2&lt;br /&gt;
|&lt;br /&gt;
* Добавлена связь между сущностью сервиса SAP HANA и соответствующим экземпляром процесса при наличии ЕдиногоАгента.&lt;br /&gt;
* Добавлен набор &amp;lt;code&amp;gt;Table Size vs Allocation Limit Usage&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Метрика использования диска переименована в отношение размера таблиц к пределу выделения памяти.&lt;br /&gt;
* Добавлен набор &amp;lt;code&amp;gt;Host Agent Network Rates&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Расширены метрики памяти, дисков и сети хоста.&lt;br /&gt;
* Добавлены отдельные наборы &amp;lt;code&amp;gt;HANA License&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Disk Size Usage&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;Schema Disk Metrics&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Часть основных метрик перенесена в набор &amp;lt;code&amp;gt;Base Metrics&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Интервал сбора свойств базы данных увеличен до пяти минут.&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=MS_SQL&amp;diff=6966</id>
		<title>MS SQL</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=MS_SQL&amp;diff=6966"/>
		<updated>2026-09-30T03:33:47Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Microsoft SQL Server =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для удалённого мониторинга состояния и производительности экземпляров Microsoft SQL Server с помощью SQL-запросов, выполняемых контроллером расширений.&lt;br /&gt;
&lt;br /&gt;
Идентификатор: &amp;lt;code&amp;gt;ru.ruscomtech.extension.sql-server&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Расширение контролирует экземпляры и базы данных SQL Server, блокировки, память, транзакционные журналы, резервное копирование, задания SQL Server Agent и группы доступности Always On.&lt;br /&gt;
&lt;br /&gt;
== Возможности ==&lt;br /&gt;
&lt;br /&gt;
Расширение выполняет:&lt;br /&gt;
&lt;br /&gt;
* мониторинг экземпляров и отдельных баз данных SQL Server;&lt;br /&gt;
* сбор показателей подключений, сессий, памяти и производительности запросов;&lt;br /&gt;
* обнаружение блокировок, взаимоблокировок и длительных ожиданий;&lt;br /&gt;
* контроль заполнения и роста транзакционных журналов;&lt;br /&gt;
* контроль возраста и размера резервных копий;&lt;br /&gt;
* мониторинг файлов баз данных;&lt;br /&gt;
* сбор информации о выполняющихся и завершившихся с ошибкой заданиях;&lt;br /&gt;
* сбор наиболее продолжительных запросов;&lt;br /&gt;
* мониторинг групп, реплик и баз данных Always On;&lt;br /&gt;
* построение топологии экземпляров, баз данных и компонентов Always On;&lt;br /&gt;
* формирование готовой обзорной панели;&lt;br /&gt;
* применение готовых шаблонов оповещений.&lt;br /&gt;
&lt;br /&gt;
Мониторинг выполняется удалённо. Устанавливать ЕдиныйАгент непосредственно на сервер SQL Server не обязательно.&lt;br /&gt;
&lt;br /&gt;
== Поддерживаемые системы ==&lt;br /&gt;
&lt;br /&gt;
Официально поддерживаются:&lt;br /&gt;
&lt;br /&gt;
* Microsoft SQL Server редакций Enterprise, Standard, Developer, Web и Express на Windows;&lt;br /&gt;
* Azure SQL Database;&lt;br /&gt;
* Azure SQL Managed Instance;&lt;br /&gt;
* группы доступности Always On.&lt;br /&gt;
&lt;br /&gt;
Расширение рассчитано на версии SQL Server, находящиеся на основной или расширенной поддержке Microsoft.&lt;br /&gt;
&lt;br /&gt;
Работа с SQL Server на Linux и AWS RDS возможна, но зависит от доступности используемых системных представлений.&lt;br /&gt;
&lt;br /&gt;
Не рекомендуется одновременно контролировать один экземпляр с помощью нескольких конфигураций или разных основных версий расширения: это может привести к дублированию метрик и сущностей.&lt;br /&gt;
&lt;br /&gt;
== Схема работы ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
Microsoft SQL Server&lt;br /&gt;
        |&lt;br /&gt;
        | TCP, SQL-запросы&lt;br /&gt;
        v&lt;br /&gt;
АктивныйШлюз / EEC&lt;br /&gt;
        |&lt;br /&gt;
        | метрики, логи и топология&lt;br /&gt;
        v&lt;br /&gt;
Ключ-АСТРОМ&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Все устройства выбранной группы АктивныхШлюзов должны иметь сетевой доступ к контролируемому экземпляру SQL Server.&lt;br /&gt;
&lt;br /&gt;
== Требования к подключению ==&lt;br /&gt;
&lt;br /&gt;
Перед настройкой подготовьте:&lt;br /&gt;
&lt;br /&gt;
* адрес сервера SQL Server;&lt;br /&gt;
* TCP-порт экземпляра, обычно &amp;lt;code&amp;gt;1433&amp;lt;/code&amp;gt;;&lt;br /&gt;
* имя базы данных;&lt;br /&gt;
* отдельную учётную запись мониторинга;&lt;br /&gt;
* группу АктивныхШлюзов, с которой доступен сервер;&lt;br /&gt;
* разрешение сетевого доступа между АктивнымШлюзом и SQL Server;&lt;br /&gt;
* доверенный сертификат, если используется шифрование TLS.&lt;br /&gt;
&lt;br /&gt;
Для именованного экземпляра рекомендуется указывать фактический TCP-порт. Если экземпляр использует динамический порт, его изменение потребует обновления конфигурации мониторинга.&lt;br /&gt;
&lt;br /&gt;
Для получения общей информации об экземпляре в качестве базы подключения рекомендуется использовать &amp;lt;code&amp;gt;master&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Сбор наиболее продолжительных запросов выполняется для базы данных, указанной в конечной точке подключения. Если необходимо получать статистику Query Store из нескольких баз, для них могут потребоваться отдельные конечные точки.&lt;br /&gt;
&lt;br /&gt;
== Создание пользователя мониторинга ==&lt;br /&gt;
&lt;br /&gt;
Набор разрешений зависит от включённых наборов функций. Не выдавайте учётной записи административные роли без необходимости.&lt;br /&gt;
&lt;br /&gt;
Пример создания отдельной учётной записи:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
USE [master];&lt;br /&gt;
GO&lt;br /&gt;
&lt;br /&gt;
CREATE LOGIN [keyastrom_monitor]&lt;br /&gt;
WITH PASSWORD = &#039;ЗАМЕНИТЕ_НА_НАДЕЖНЫЙ_ПАРОЛЬ&#039;;&lt;br /&gt;
GO&lt;br /&gt;
&lt;br /&gt;
CREATE USER [keyastrom_monitor]&lt;br /&gt;
FOR LOGIN [keyastrom_monitor];&lt;br /&gt;
GO&lt;br /&gt;
&lt;br /&gt;
GRANT VIEW ANY DATABASE TO [keyastrom_monitor];&lt;br /&gt;
GRANT VIEW ANY DEFINITION TO [keyastrom_monitor];&lt;br /&gt;
GO&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для SQL Server 2019 и более ранних версий:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
GRANT VIEW SERVER STATE TO [keyastrom_monitor];&lt;br /&gt;
GO&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для SQL Server 2022 и более новых версий:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
GRANT VIEW SERVER PERFORMANCE STATE TO [keyastrom_monitor];&lt;br /&gt;
GO&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для чтения сведений о резервных копиях и заданиях создайте пользователя в базе &amp;lt;code&amp;gt;msdb&amp;lt;/code&amp;gt; и предоставьте права чтения:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
USE [msdb];&lt;br /&gt;
GO&lt;br /&gt;
&lt;br /&gt;
CREATE USER [keyastrom_monitor]&lt;br /&gt;
FOR LOGIN [keyastrom_monitor];&lt;br /&gt;
GO&lt;br /&gt;
&lt;br /&gt;
ALTER ROLE [db_datareader]&lt;br /&gt;
ADD MEMBER [keyastrom_monitor];&lt;br /&gt;
GO&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для сбора сессий и данных Query Store добавьте пользователя в контролируемую базу:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
USE [имя_базы_данных];&lt;br /&gt;
GO&lt;br /&gt;
&lt;br /&gt;
CREATE USER [keyastrom_monitor]&lt;br /&gt;
FOR LOGIN [keyastrom_monitor];&lt;br /&gt;
GO&lt;br /&gt;
&lt;br /&gt;
GRANT VIEW DATABASE STATE TO [keyastrom_monitor];&lt;br /&gt;
GO&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Если пользователь уже существует в нужной базе, повторно выполнять &amp;lt;code&amp;gt;CREATE USER&amp;lt;/code&amp;gt; не требуется.&lt;br /&gt;
&lt;br /&gt;
Для Azure SQL Database права назначаются с учётом используемой модели аутентификации и уровня службы. Для просмотра всех баз рекомендуется подключаться к базе &amp;lt;code&amp;gt;master&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Подготовка Query Store ==&lt;br /&gt;
&lt;br /&gt;
Сбор наиболее продолжительных запросов требует включённого Query Store.&lt;br /&gt;
&lt;br /&gt;
Проверить его состояние можно запросом:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
SELECT actual_state_desc&lt;br /&gt;
FROM sys.database_query_store_options;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
При необходимости Query Store включается администратором базы данных:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
ALTER DATABASE [имя_базы_данных]&lt;br /&gt;
SET QUERY_STORE = ON;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Query Store необходимо включать отдельно в каждой базе, из которой должны собираться запросы.&lt;br /&gt;
&lt;br /&gt;
== Установка и настройка ==&lt;br /&gt;
&lt;br /&gt;
# Загрузите пакет расширения в Ключ-АСТРОМ.&lt;br /&gt;
# Откройте установленное расширение Microsoft SQL Server.&lt;br /&gt;
# Создайте конфигурацию мониторинга.&lt;br /&gt;
# Укажите имя конфигурации.&lt;br /&gt;
# Выберите группу АктивныхШлюзов.&lt;br /&gt;
# Добавьте конечную точку SQL Server.&lt;br /&gt;
# Укажите адрес сервера и TCP-порт.&lt;br /&gt;
# Укажите базу данных.&lt;br /&gt;
# Введите имя пользователя и пароль либо выберите учётные данные из хранилища секретов.&lt;br /&gt;
# При необходимости включите защищённое соединение.&lt;br /&gt;
# Выберите наборы функций.&lt;br /&gt;
# Сохраните и активируйте конфигурацию.&lt;br /&gt;
&lt;br /&gt;
=== Основные параметры подключения ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Адрес&lt;br /&gt;
| DNS-имя или IP-адрес сервера SQL Server.&lt;br /&gt;
|-&lt;br /&gt;
| Порт&lt;br /&gt;
| TCP-порт экземпляра SQL Server. Стандартное значение — &amp;lt;code&amp;gt;1433&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| База данных&lt;br /&gt;
| База, используемая для подключения. Для общего мониторинга экземпляра рекомендуется &amp;lt;code&amp;gt;master&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Имя пользователя&lt;br /&gt;
| Учётная запись с правами чтения необходимых системных представлений.&lt;br /&gt;
|-&lt;br /&gt;
| Пароль&lt;br /&gt;
| Пароль пользователя мониторинга или ссылка на запись в хранилище секретов.&lt;br /&gt;
|-&lt;br /&gt;
| Шифрование&lt;br /&gt;
| Использование TLS при подключении к SQL Server.&lt;br /&gt;
|-&lt;br /&gt;
| Наборы функций&lt;br /&gt;
| Группы метрик и логов, которые должна собирать конфигурация.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Longest queries timeout&amp;lt;/code&amp;gt;&lt;br /&gt;
| Максимальное время выполнения запроса сбора наиболее продолжительных запросов. Значение по умолчанию — &amp;lt;code&amp;gt;120&amp;lt;/code&amp;gt; секунд. Рекомендуемый максимальный предел — &amp;lt;code&amp;gt;290&amp;lt;/code&amp;gt; секунд.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Наборы функций ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Always On&amp;lt;/code&amp;gt;&lt;br /&gt;
| Группы доступности, реплики, состояние синхронизации, очереди отправки журналов и восстановления.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Backups&amp;lt;/code&amp;gt;&lt;br /&gt;
| Возраст, размер, тип и состояние резервных копий.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Database files&amp;lt;/code&amp;gt;&lt;br /&gt;
| Размер, занятое и свободное пространство файлов баз данных.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Jobs&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущие задания SQL Server Agent и задания, завершившиеся с ошибкой.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Latches&amp;lt;/code&amp;gt;&lt;br /&gt;
| Ожидания защёлок и их средняя продолжительность.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Locks&amp;lt;/code&amp;gt;&lt;br /&gt;
| Блокировки, взаимоблокировки, ожидания и тайм-ауты.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Memory&amp;lt;/code&amp;gt;&lt;br /&gt;
| Физическая, виртуальная и выделенная память, показатели буферного кеша.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Queries&amp;lt;/code&amp;gt;&lt;br /&gt;
| Компиляции, повторные компиляции и наиболее продолжительные запросы.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Replication&amp;lt;/code&amp;gt;&lt;br /&gt;
| Обмен данными с репликами SQL Server.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Sessions&amp;lt;/code&amp;gt;&lt;br /&gt;
| Активные сессии по пользователям и доменам.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Transaction logs&amp;lt;/code&amp;gt;&lt;br /&gt;
| Размер, заполнение, рост, усечение и ожидания сброса транзакционного журнала.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Основные показатели экземпляра и состояние баз данных собираются независимо от дополнительных наборов.&lt;br /&gt;
&lt;br /&gt;
Большинство метрик обновляется раз в минуту. Информация о продолжительных запросах, файлах, резервных копиях и заданиях собирается раз в пять минут.&lt;br /&gt;
&lt;br /&gt;
== Основные группы метрик ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Группа&lt;br /&gt;
! Примеры метрик&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Подключения и сессии&lt;br /&gt;
| &amp;lt;code&amp;gt;sql-server.general.userConnections&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.sessions&amp;lt;/code&amp;gt;&lt;br /&gt;
| Пользовательские подключения и активные сессии.&lt;br /&gt;
|-&lt;br /&gt;
| Блокировки&lt;br /&gt;
| &amp;lt;code&amp;gt;sql-server.locks.deadlocks.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.locks.waits.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.locks.waitTime.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Взаимоблокировки, ожидания и их продолжительность.&lt;br /&gt;
|-&lt;br /&gt;
| Память&lt;br /&gt;
| &amp;lt;code&amp;gt;sql-server.memory.physical&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.memory.virtual&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.memory.grantsPending&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование памяти и процессы, ожидающие её выделения.&lt;br /&gt;
|-&lt;br /&gt;
| Буферный кеш&lt;br /&gt;
| &amp;lt;code&amp;gt;sql-server.buffers.pageLifeExpectancy&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.buffers.pageWrites.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Время жизни страниц и операции записи.&lt;br /&gt;
|-&lt;br /&gt;
| Запросы&lt;br /&gt;
| &amp;lt;code&amp;gt;sql-server.sql.batchRequests.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.sql.compilations.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.sql.recompilations.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Пакеты запросов, компиляции и повторные компиляции.&lt;br /&gt;
|-&lt;br /&gt;
| Базы данных&lt;br /&gt;
| &amp;lt;code&amp;gt;sql-server.databases.state&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.databases.transactions.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Состояние баз данных и количество транзакций.&lt;br /&gt;
|-&lt;br /&gt;
| Транзакционные журналы&lt;br /&gt;
| &amp;lt;code&amp;gt;sql-server.databases.log.percentUsed&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.databases.log.filesSize&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.databases.log.growths.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование, размер и рост журналов.&lt;br /&gt;
|-&lt;br /&gt;
| Резервное копирование&lt;br /&gt;
| &amp;lt;code&amp;gt;sql-server.databases.backup.age&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.databases.backup.size&amp;lt;/code&amp;gt;&lt;br /&gt;
| Возраст и размер последней резервной копии.&lt;br /&gt;
|-&lt;br /&gt;
| Файлы базы данных&lt;br /&gt;
| &amp;lt;code&amp;gt;sql-server.databases.file.size&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.databases.file.usedSpace&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;sql-server.databases.file.emptySpace&amp;lt;/code&amp;gt;&lt;br /&gt;
| Общий, занятый и свободный объём файлов.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Сбор логов ==&lt;br /&gt;
&lt;br /&gt;
Часть подробной информации передаётся в виде записей логов:&lt;br /&gt;
&lt;br /&gt;
* наиболее продолжительные запросы;&lt;br /&gt;
* крупнейшие файлы баз данных;&lt;br /&gt;
* текущие задания;&lt;br /&gt;
* задания, завершившиеся с ошибкой;&lt;br /&gt;
* сведения об отдельных резервных копиях.&lt;br /&gt;
&lt;br /&gt;
Для получения наиболее продолжительных запросов должны быть включены:&lt;br /&gt;
&lt;br /&gt;
* набор &amp;lt;code&amp;gt;Queries&amp;lt;/code&amp;gt;;&lt;br /&gt;
* Query Store в целевой базе;&lt;br /&gt;
* разрешение &amp;lt;code&amp;gt;VIEW DATABASE STATE&amp;lt;/code&amp;gt;;&lt;br /&gt;
* приём логов расширения.&lt;br /&gt;
&lt;br /&gt;
Значение &amp;lt;code&amp;gt;Longest queries timeout&amp;lt;/code&amp;gt; определяет, сколько времени контроллер ожидает завершения служебного запроса. Увеличивайте его только при регулярных тайм-аутах сбора.&lt;br /&gt;
&lt;br /&gt;
== Always On ==&lt;br /&gt;
&lt;br /&gt;
Набор &amp;lt;code&amp;gt;Always On&amp;lt;/code&amp;gt; доступен для SQL Server 2016 и новее.&lt;br /&gt;
&lt;br /&gt;
Расширение собирает:&lt;br /&gt;
&lt;br /&gt;
* состояние и работоспособность группы доступности;&lt;br /&gt;
* роли и состояние подключения реплик;&lt;br /&gt;
* режим доступности и переключения;&lt;br /&gt;
* состояние синхронизации баз данных;&lt;br /&gt;
* размер и скорость обработки очередей отправки и восстановления;&lt;br /&gt;
* скорость передачи FILESTREAM.&lt;br /&gt;
&lt;br /&gt;
Для работы набора требуются права чтения представлений &amp;lt;code&amp;gt;sys.availability_*&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;sys.dm_hadr_*&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
В версии &amp;lt;code&amp;gt;2.5.4&amp;lt;/code&amp;gt; для реплик стандартного экземпляра используется значение &amp;lt;code&amp;gt;MSSQLSERVER&amp;lt;/code&amp;gt;. Это позволяет корректно связывать реплику Always On с соответствующим экземпляром SQL Server.&lt;br /&gt;
&lt;br /&gt;
== Обнаруживаемые сущности ==&lt;br /&gt;
&lt;br /&gt;
Расширение создаёт следующие сущности:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;SQL Server Host&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;SQL Server Instance&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;SQL Server Database&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;SQL Server Availability Group&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;SQL Server Availability Replica&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;SQL Server Availability Database&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Базы данных связываются с экземплярами, экземпляры — с хостами, а базы доступности — с соответствующими репликами и группами.&lt;br /&gt;
&lt;br /&gt;
Для связывания экземпляра с хостом адрес, указанный в конфигурации, должен совпадать с IP-адресом хоста, контролируемого ЕдинымАгентом.&lt;br /&gt;
&lt;br /&gt;
== Обзорная панель ==&lt;br /&gt;
&lt;br /&gt;
В состав расширения входит панель &amp;lt;code&amp;gt;SQL Server Overview&amp;lt;/code&amp;gt;. Она содержит:&lt;br /&gt;
&lt;br /&gt;
* наиболее загруженные экземпляры и базы данных;&lt;br /&gt;
* базы данных, находящиеся не в состоянии &amp;lt;code&amp;gt;ONLINE&amp;lt;/code&amp;gt;;&lt;br /&gt;
* группы и реплики доступности;&lt;br /&gt;
* количество компиляций и повторных компиляций;&lt;br /&gt;
* состояние синхронизации Always On.&lt;br /&gt;
&lt;br /&gt;
== Шаблоны оповещений ==&lt;br /&gt;
&lt;br /&gt;
Расширение содержит готовые шаблоны:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;SQL Server low buffer cache hit rate&amp;lt;/code&amp;gt; — низкий коэффициент попаданий в буферный кеш;&lt;br /&gt;
* &amp;lt;code&amp;gt;SQL Server high log usage&amp;lt;/code&amp;gt; — высокий уровень заполнения транзакционного журнала.&lt;br /&gt;
&lt;br /&gt;
После установки шаблоны необходимо проверить и адаптировать под рабочую нагрузку конкретной среды.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После активации конфигурации проверьте:&lt;br /&gt;
&lt;br /&gt;
# состояние конфигурации расширения;&lt;br /&gt;
# успешность подключения к конечной точке;&lt;br /&gt;
# появление сущности экземпляра SQL Server;&lt;br /&gt;
# обнаружение баз данных;&lt;br /&gt;
# поступление метрик с префиксом &amp;lt;code&amp;gt;sql-server&amp;lt;/code&amp;gt;;&lt;br /&gt;
# наличие данных на панели &amp;lt;code&amp;gt;SQL Server Overview&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Базовую доступность SQL Server можно проверить с хоста АктивногоШлюза:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
sqlcmd -S tcp:&amp;amp;lt;адрес&amp;amp;gt;,&amp;amp;lt;порт&amp;amp;gt; -d master -U keyastrom_monitor -Q &amp;quot;SELECT @@SERVERNAME&amp;quot;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Проверить доступность основных системных представлений можно запросами:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
SELECT TOP (1) * FROM sys.dm_os_sys_info;&lt;br /&gt;
SELECT TOP (1) * FROM sys.dm_os_performance_counters;&lt;br /&gt;
SELECT name, state_desc FROM sys.databases;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Устранение неисправностей ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Проблема&lt;br /&gt;
! Возможная причина и решение&lt;br /&gt;
|-&lt;br /&gt;
| Не удаётся подключиться к серверу&lt;br /&gt;
| Проверьте адрес, порт, правила межсетевого экрана, работу TCP/IP в SQL Server Configuration Manager и доступность сервера с АктивногоШлюза.&lt;br /&gt;
|-&lt;br /&gt;
| Ошибка аутентификации&lt;br /&gt;
| Проверьте тип аутентификации, имя пользователя, пароль и наличие пользователя в указанной базе данных.&lt;br /&gt;
|-&lt;br /&gt;
| Поступает только часть метрик&lt;br /&gt;
| Проверьте выбранные наборы функций и права пользователя на соответствующие системные представления.&lt;br /&gt;
|-&lt;br /&gt;
| Не отображаются все базы данных&lt;br /&gt;
| Подключайтесь к &amp;lt;code&amp;gt;master&amp;lt;/code&amp;gt; и проверьте право &amp;lt;code&amp;gt;VIEW ANY DATABASE&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Не поступают наиболее продолжительные запросы&lt;br /&gt;
| Включите Query Store, набор &amp;lt;code&amp;gt;Queries&amp;lt;/code&amp;gt;, приём логов и право &amp;lt;code&amp;gt;VIEW DATABASE STATE&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Не поступают резервные копии или задания&lt;br /&gt;
| Проверьте доступ пользователя к таблицам базы &amp;lt;code&amp;gt;msdb&amp;lt;/code&amp;gt; и включение наборов &amp;lt;code&amp;gt;Backups&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;Jobs&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Не собираются метрики Always On&lt;br /&gt;
| Проверьте версию SQL Server, набор &amp;lt;code&amp;gt;Always On&amp;lt;/code&amp;gt; и права на представления &amp;lt;code&amp;gt;sys.availability_*&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;sys.dm_hadr_*&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Экземпляр не связывается с хостом&lt;br /&gt;
| Убедитесь, что в конфигурации указан тот же IP-адрес, который обнаружен ЕдинымАгентом.&lt;br /&gt;
|-&lt;br /&gt;
| Служебный запрос завершается по тайм-ауту&lt;br /&gt;
| Увеличьте &amp;lt;code&amp;gt;Longest queries timeout&amp;lt;/code&amp;gt;. Значение должно быть целым числом и не должно превышать &amp;lt;code&amp;gt;290&amp;lt;/code&amp;gt; секунд.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 2.5.4&lt;br /&gt;
|&lt;br /&gt;
* Начало поддержки расширения&lt;br /&gt;
* Для измерения &amp;lt;code&amp;gt;availability.replica.instance&amp;lt;/code&amp;gt; добавлено значение по умолчанию &amp;lt;code&amp;gt;MSSQLSERVER&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Исправлено связывание реплик Always On со стандартными экземплярами SQL Server.&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=Redis&amp;diff=6965</id>
		<title>Redis</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=Redis&amp;diff=6965"/>
		<updated>2026-09-30T01:37:41Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Redis — это база данных «ключ-значение» с открытым исходным кодом, хранящаяся в памяти (или «сервер структуры данных») с дополнительной надежностью. Redis обычно используется в качестве базы данных, кэша, очереди и брокера сообщений (публикация и подписка). По умолчанию Ключ-АСТРОМ отслеживает основные метрики Redis, включая время ответа, фрагментацию памяти, коэффициент попадания в кэш, использование кэша, количество подключений, попаданий, промахов и многое другое.&lt;br /&gt;
&lt;br /&gt;
== Требования и ограничения ==&lt;br /&gt;
&lt;br /&gt;
* Redis Server 2.8 или выше&lt;br /&gt;
* ОС Linux&lt;br /&gt;
* Redis должен прослушивать локальный хост. Требуется привязка между localhost и портом Redis.&lt;br /&gt;
* Если у вас есть несколько экземпляров Redis на одном хосте, все экземпляры должны иметь один и тот же пароль (или не иметь пароля).&lt;br /&gt;
* Это расширение не поддерживает TLS.&lt;br /&gt;
&lt;br /&gt;
== Поддержка Docker ==&lt;br /&gt;
Ключ-АСТРОМ поддерживает работу Redis внутри контейнеров Docker при соблюдении следующих требований:&lt;br /&gt;
&lt;br /&gt;
* ЕдиныйАгент версии 1.157+&lt;br /&gt;
* Образ docker Redis версии 5.0.0+&lt;br /&gt;
* Если вы используете файл конфигурации для операции переименования, вам необходимо использовать его путь в конфигурации отслеживаемого расширения. Например: &amp;lt;code&amp;gt;docker run redis&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Включение глобального мониторинга Redis ==&lt;br /&gt;
Благодаря глобальному мониторингу Redis Ключ-АСТРОМ автоматически собирает метрики Redis всякий раз, когда в вашей среде обнаруживается новый хост, на котором работает Redis.&lt;br /&gt;
&lt;br /&gt;
# Перейдите в &#039;&#039;&#039;Настройки&#039;&#039;&#039; .&lt;br /&gt;
# Выберите &#039;&#039;&#039;Мониторинг &amp;gt; Отслеживаемые технологии&#039;&#039;&#039; .&lt;br /&gt;
# Откройте запись &#039;&#039;&#039;Redis&#039;&#039;&#039; для редактирования.&lt;br /&gt;
#* &#039;&#039;&#039;Подключено к&#039;&#039;&#039; показывает, сколько хостов Redis подключено, и предлагает ссылки непосредственно на страницы хостов.&lt;br /&gt;
#* &#039;&#039;&#039;Пароль&#039;&#039;&#039; — это пароль для всех хостов Redis, которые вы хотите отслеживать глобально. Определите пароль (или оставьте поле пустым, если пароль не установлен на сервере Redis). Если у вас есть несколько экземпляров Redis на одном хосте, все экземпляры должны иметь один и тот же пароль (или не иметь пароля).&lt;br /&gt;
#* &#039;&#039;&#039;Местоположение файла конфигурации&#039;&#039;&#039; — это необязательный файл конфигурации. &#039;&#039;&#039;&#039;&#039;Внимание!&#039;&#039;&#039; Ссылка на настройки хоста открывает &#039;&#039;&#039;Настройки&#039;&#039;&#039; &amp;gt; &#039;&#039;&#039;Мониторинг&#039;&#039;&#039; &amp;gt; &#039;&#039;&#039;Обзор мониторинга&#039;&#039;&#039; на вкладку &#039;&#039;&#039;Хосты&#039;&#039;&#039; . Если вы решили настроить Redis для каждого хоста, а не глобально, отключите мониторинг Redis глобально и выберите &#039;&#039;&#039;параметры хоста&#039;&#039;&#039; , чтобы начать настройку Redis для каждого хоста. Подробности см. в разделе «Включение мониторинга Redis для отдельных хостов» ниже.&#039;&#039;&lt;br /&gt;
# Выберите «&#039;&#039;&#039;Сохранить&#039;&#039;&#039;» , чтобы сохранить изменения.&lt;br /&gt;
# Включите переключатель &#039;&#039;&#039;Redis&#039;&#039;&#039; , чтобы начать глобальный мониторинг Redis.&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|Соединение TLS не поддерживается&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Включение мониторинга Redis для отдельных хостов ==&lt;br /&gt;
Вы можете включить мониторинг Redis для конкретных хостов, а не глобально.&lt;br /&gt;
&lt;br /&gt;
# Перейдите в &#039;&#039;&#039;Настройки&#039;&#039;&#039; .&lt;br /&gt;
# Выберите &#039;&#039;&#039;Мониторинг &amp;gt; Обзор мониторинга&#039;&#039;&#039; .&lt;br /&gt;
# Выберите вкладку &#039;&#039;&#039;Хосты&#039;&#039;&#039; .&lt;br /&gt;
# Выберите хост, на котором вы хотите настроить Redis.&lt;br /&gt;
# Выберите «&#039;&#039;&#039;Изменить&#039;&#039;&#039;» и дождитесь заполнения списка «&#039;&#039;&#039;Отслеживаемые технологии&#039;&#039;&#039;» .                                                 &#039;&#039;&#039;&#039;&#039;Внимание!&#039;&#039;&#039; Если Redis указан как одна из технологий, отслеживаемых глобально, вам необходимо отключить глобальный мониторинг для Redis, а затем настроить мониторинг Redis на уровне хоста. Щелкните ссылку «&#039;&#039;&#039;Включено глобально&#039;&#039;&#039;» и установите переключатель Redis в положение « &#039;&#039;&#039;Выкл.&#039;&#039;&#039;» , а затем вернитесь к конфигурации хоста.&#039;&#039;&lt;br /&gt;
# Найдите запись &#039;&#039;&#039;Redis&#039;&#039;&#039; в списке «&#039;&#039;&#039;Отслеживаемые технологии&#039;&#039;&#039;» и разверните ее для редактирования.&lt;br /&gt;
#* &#039;&#039;&#039;Пароль&#039;&#039;&#039; — это пароль для выбранного хоста Redis, который вы хотите отслеживать.&lt;br /&gt;
#* &#039;&#039;&#039;Расположение файла конфигурации&#039;&#039;&#039; — это дополнительный файл конфигурации для перезаписи команд.&lt;br /&gt;
# Выберите «&#039;&#039;&#039;Сохранить&#039;&#039;&#039;» , чтобы сохранить изменения.&lt;br /&gt;
# Включите переключатель &#039;&#039;&#039;Redis&#039;&#039;&#039; для этого хоста.&lt;br /&gt;
# При необходимости повторите эту процедуру для дополнительных хостов &#039;&#039;&#039;Redis&#039;&#039;&#039;.&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|Соединение TLS не поддерживается&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Мониторинг репликации Redis ==&lt;br /&gt;
Ключ-АСТРОМ автоматически распознает экземпляры главного и реплик Redis и контролирует их репликацию. Экземпляры мастера и реплики Redis должны быть полностью синхронизированы для поддержания оптимальной производительности и стабильности ваших серверов Redis.&lt;br /&gt;
&lt;br /&gt;
Индикатор &#039;&#039;&#039;текущего состояния&#039;&#039;&#039; на странице обзора процессов Redis отображает состояние ваших серверов Redis. Чтобы проанализировать изменения состояния сервера с течением времени, выберите временной интервал на диаграмме &#039;&#039;&#039;состояний реплики&#039;&#039;&#039; или проверьте диаграмму &#039;&#039;&#039;состояния&#039;&#039;&#039; , чтобы увидеть точное распределение состояний в течение заданного периода времени.&lt;br /&gt;
&lt;br /&gt;
Используйте настройки для конкретных событий, чтобы настроить условия отправки оповещений для уведомления вас. Чтобы получить доступ к настройкам событий плагина, перейдите в «&#039;&#039;&#039;Настройки&#039;&#039;&#039;» &amp;gt; «&#039;&#039;&#039;Обнаружение аномалий&#039;&#039;&#039;» &amp;gt; «&#039;&#039;&#039;События расширения&#039;&#039;&#039;» и найдите записи Redis:&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;&#039;Выполняется синхронизация реплики Redis&#039;&#039;&#039;. Если синхронизация реплики Redis продолжается слишком долго, Ключ-АСТРОМ выдает это предупреждение.&lt;br /&gt;
* &#039;&#039;&#039;Реплика Redis не синхронизирована&#039;&#039;&#039;. Если реплика Redis не реплицируется полностью, Ключ-АСТРОМ выдает это предупреждение.&lt;br /&gt;
&lt;br /&gt;
Вы можете включить или отключить эти события, а также настроить условия, при которых выдается соответствующее оповещение.&lt;br /&gt;
&lt;br /&gt;
== Время ответа Redis Sentinel ==&lt;br /&gt;
Redis Sentinel — это имя процесса, отвечающего за доступность вашего развертывания Redis. Производительность процесса Redis Sentinel измеряется на основе &#039;&#039;&#039;времени отклика&#039;&#039;&#039; .&lt;br /&gt;
&lt;br /&gt;
== Метрики группы процессов ==&lt;br /&gt;
Чтобы просмотреть диаграммы метрик на уровне группы процессов Redis:&lt;br /&gt;
&lt;br /&gt;
# Перейдите в &#039;&#039;&#039;раздел «Технологии и процессы Classic»&#039;&#039;&#039; (последняя версия Ключ-АСТРОМ) или «&#039;&#039;&#039;Технологии и процессы&#039;&#039;&#039; » (предыдущая версия Ключ-АСТРОМ), а затем выберите плитку &#039;&#039;&#039;Redis&#039;&#039;&#039; . Группы процессов Redis перечислены в таблице под плитками со следующими показателями для каждой строки (группы процессов): ЦП, подключение, повторные передачи, время прохождения подтверждения, пропускная способность ответа.&lt;br /&gt;
# Чтобы отобразить любую из этих метрик для определенной группы процессов, выберите эту строку, чтобы развернуть ее. Используйте список под диаграммой, чтобы выбрать другой показатель для диаграммы.&lt;br /&gt;
# Чтобы просмотреть сведения о выбранной группе процессов Redis, нажмите кнопку «&#039;&#039;&#039;Сведения о группе процессов&#039;&#039;&#039;» . На странице «&#039;&#039;&#039;Группа процессов&#039;&#039;&#039;» выберите вкладку «&#039;&#039;&#039;Метрики, специфичные для технологии&#039;&#039;&#039;» , чтобы отобразить следующие метрики для выбранной группы процессов Redis:&lt;br /&gt;
#* &#039;&#039;&#039;Фрагментация памяти&#039;&#039;&#039;Соотношение памяти, используемой операционной системой, по сравнению с объемом памяти, выделенным Redis.&lt;br /&gt;
#* &#039;&#039;&#039;Использование памяти&#039;&#039;&#039;Процент используемой памяти Redis. Эта метрика видна только в том случае, если &amp;lt;code&amp;gt;maxmemory&amp;lt;/code&amp;gt;настроен параметр Redis.&lt;br /&gt;
#* &#039;&#039;&#039;Время ответа&#039;&#039;&#039;Время, прошедшее, пока сервер Redis отвечает на &amp;lt;code&amp;gt;INFO&amp;lt;/code&amp;gt;запросы. Redis обычно отвечает в течение миллисекунд.&lt;br /&gt;
#* &#039;&#039;&#039;Всего обработанных команд&#039;&#039;&#039;Число команд, обработанных Redis в секунду.&lt;br /&gt;
&lt;br /&gt;
== Ключевые показатели процесса ==&lt;br /&gt;
Ценные метрики Redis отображаются на каждой странице процесса Redis в виде интуитивно понятной инфографики.&lt;br /&gt;
&lt;br /&gt;
# На странице &#039;&#039;&#039;группы процессов&#039;&#039;&#039; выберите процесс в таблице, чтобы отобразить страницу &#039;&#039;&#039;сведений о процессе&#039;&#039;&#039; для этого процесса.&lt;br /&gt;
# Выберите вкладку «&#039;&#039;&#039;Метрики Redis&#039;&#039;&#039;» , чтобы составить диаграмму ключевых показателей для выбранного экземпляра сервера Redis.&lt;br /&gt;
#* &#039;&#039;&#039;Время ответа&#039;&#039;&#039;Время, прошедшее, пока сервер Redis отвечает на &amp;lt;code&amp;gt;INFO&amp;lt;/code&amp;gt;запросы. Redis обычно отвечает в течение миллисекунд.&lt;br /&gt;
#* &#039;&#039;&#039;Фрагментация памяти&#039;&#039;&#039;Соотношение памяти, используемой операционной системой, по сравнению с объемом памяти, выделенным Redis.&lt;br /&gt;
#** Меньше чем &amp;lt;code&amp;gt;1.0&amp;lt;/code&amp;gt;означает, что Redis требует больше памяти, чем доступно в системе, и вынужден использовать ресурсы памяти подкачки.&lt;br /&gt;
#** Чуть больше &amp;lt;code&amp;gt;1.0&amp;lt;/code&amp;gt;(но не более &amp;lt;code&amp;gt;1.5&amp;lt;/code&amp;gt;) — это нормальный коэффициент фрагментации. Происходит фрагментация, и этот экземпляр Redis потребляет больше физической памяти, чем было запрошено, но фрагментация не является чрезмерной.&lt;br /&gt;
#** Больше чем &amp;lt;code&amp;gt;1.5&amp;lt;/code&amp;gt;указывает на чрезмерную фрагментацию. Чтобы позволить операционной системе восстановить память, которая стала непригодной для использования из-за фрагментации, перезапустите сервер Redis.&lt;br /&gt;
&lt;br /&gt;
== Дополнительные диаграммы метрик процесса Redis ==&lt;br /&gt;
На странице «&#039;&#039;&#039;Сведения о процессе&#039;&#039;&#039;» выберите вкладку «&#039;&#039;&#039;Дополнительные сведения&#039;&#039;&#039;» , чтобы отобразить следующие дополнительные метрики для выбранного экземпляра сервера Redis:&lt;br /&gt;
&lt;br /&gt;
* Кэш&lt;br /&gt;
* Соединения&lt;br /&gt;
* Slow лог&lt;br /&gt;
&lt;br /&gt;
=== Кэш ===&lt;br /&gt;
&#039;&#039;&#039;Команды&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
* Попадания в пространство ключей Число успешных поисков ключей в основном словаре.&lt;br /&gt;
* Промахи в пространстве ключей Число неудачных поисков ключей.&lt;br /&gt;
* Всего обработанных команд Число команд, обработанных Redis в секунду.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Память&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
* Используемая память Процент использованной памяти Redis. Эта метрика видна только в том случае, если &amp;lt;code&amp;gt;maxmemory&amp;lt;/code&amp;gt;настроен параметр Redis.&lt;br /&gt;
* Вытесненные ключи Количество ключей, удаленных из кэша для освобождения памяти для новых элементов. Увеличение количества удаленных ключей может быть признаком использования большого количества памяти.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Ключи с истекшим сроком действия&#039;&#039;&#039; Число событий истечения срока действия ключей. События истечения срока действия запускаются, когда Redis удаляет ключи. Имейте в виду, что события истечения срока действия не запускаются, когда статус TTL (время жизни) ключа падает до нуля.&lt;br /&gt;
&lt;br /&gt;
=== Соединения ===&lt;br /&gt;
&#039;&#039;&#039;Клиенты&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
* Подключено Количество клиентских подключений (без учета подключений от реплик).&lt;br /&gt;
* Заблокировано Количество заблокированных клиентов.&lt;br /&gt;
* Отклоненные соединения Число подключений, отклоненных из-за &amp;lt;code&amp;gt;maxclients&amp;lt;/code&amp;gt;ограничения. По умолчанию последние версии Redis не закрывают соединения с клиентами, даже если клиенты простаивают в течение длительного времени — соединения остаются открытыми на неопределенный срок. У вас есть возможность настроить тайм-аут, и в этом случае клиентские соединения могут быть закрыты, если они простаивают в течение определенного периода времени. Таймауты настраиваются в файле &amp;lt;code&amp;gt;redis.conf&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Всего полученных соединений Число соединений, принятых сервером.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Репликация&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
* Подключенные реплики Количество подключенных реплик. Эта метрика видна для мастера и тех реплик, которые подключены к другим репликам.&lt;br /&gt;
&lt;br /&gt;
=== Slow лог ===&lt;br /&gt;
В Slow логе регистрируются запросы, время выполнения которых превысило указанное.&lt;br /&gt;
&lt;br /&gt;
* Время выполнения включает в себя только время, необходимое для выполнения командного запроса.&lt;br /&gt;
* Время выполнения не включает операции ввода-вывода (например, диалог с клиентом или отправку ответов).&lt;br /&gt;
&lt;br /&gt;
Slow лог можно настроить с двумя параметрами:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;slowlog-log-slower-than&amp;lt;/code&amp;gt;сообщает Redis время выполнения (в микросекундах), превышение которого означает, что запрос был медленным и будет записан в Slow лог.&lt;br /&gt;
* &amp;lt;code&amp;gt;slowlog-max-len&amp;lt;/code&amp;gt;— максимальное количество запросов, сохраняемых в Slow логе.&lt;br /&gt;
&lt;br /&gt;
== Стандартные метрики Redis ==&lt;br /&gt;
Эта таблица основана на стандартных описаниях метрик.&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!Метрика&lt;br /&gt;
!Описание&lt;br /&gt;
|-&lt;br /&gt;
|Total commands processed&lt;br /&gt;
|Количество команд, обрабатываемых Redis в секунду.&lt;br /&gt;
|-&lt;br /&gt;
|Memory usage&lt;br /&gt;
|Процент используемой памяти Redis. Эта метрика видна только в том случае, если &amp;lt;code&amp;gt;maxmemory&amp;lt;/code&amp;gt;настроен параметр Redis.&lt;br /&gt;
|-&lt;br /&gt;
|Connected&lt;br /&gt;
|Количество клиентских подключений (без учета подключений от реплик).&lt;br /&gt;
|-&lt;br /&gt;
|Blocked&lt;br /&gt;
|Количество заблокированных клиентов.&lt;br /&gt;
|-&lt;br /&gt;
|Rejected connections&lt;br /&gt;
|Число подключений, отклоненных из-за &amp;lt;code&amp;gt;maxclients&amp;lt;/code&amp;gt;ограничения. По умолчанию последние версии Redis не закрывают соединения с клиентами, даже если клиенты простаивают в течение длительного времени — соединения остаются открытыми на неопределенный срок. У вас есть возможность настроить тайм-аут, и в этом случае клиентские соединения могут быть закрыты, если они простаивают в течение определенного периода времени. Таймауты настраиваются в файле &amp;lt;code&amp;gt;redis.conf&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|Total connections received&lt;br /&gt;
|Количество соединений, принимаемых сервером.&lt;br /&gt;
|-&lt;br /&gt;
|Connected replicas&lt;br /&gt;
|Количество подключенных реплик. Эта метрика видна для мастера и тех реплик, которые подключены к другим репликам.&lt;br /&gt;
|-&lt;br /&gt;
|Keyspace hits&lt;br /&gt;
|Количество успешных поисков ключей в основном словаре.&lt;br /&gt;
|-&lt;br /&gt;
|Max memory&lt;br /&gt;
|Максимальный объем памяти, разрешенный в кеше Redis. Вы можете настроить этот параметр по своему усмотрению.&lt;br /&gt;
|-&lt;br /&gt;
|Evicted keys&lt;br /&gt;
|Количество ключей, удаленных из кэша для освобождения памяти для новых элементов. Увеличение количества удаленных ключей может быть признаком использования большого количества памяти.&lt;br /&gt;
|-&lt;br /&gt;
|Cache hit ratio&lt;br /&gt;
|Процент успешных поисков ключей в основном словаре.&lt;br /&gt;
|-&lt;br /&gt;
|Expired keys&lt;br /&gt;
|Количество событий истечения срока действия ключа. События истечения срока действия запускаются, когда Redis удаляет ключи. События истечения срока действия не запускаются, когда статус TTL (время жизни) ключа падает до нуля.&lt;br /&gt;
|-&lt;br /&gt;
|# of keys&lt;br /&gt;
|Количество ключей в выбранной базе данных.&lt;br /&gt;
|-&lt;br /&gt;
|Expires&lt;br /&gt;
|Количество ключей, имеющих параметр TTL.&lt;br /&gt;
|-&lt;br /&gt;
|Average TTL&lt;br /&gt;
|Предполагаемый средний срок жизни ключей на сервере.&lt;br /&gt;
|-&lt;br /&gt;
|Slow queries&lt;br /&gt;
|Количество запросов, записанных в Slow логе Redis.&lt;br /&gt;
&lt;br /&gt;
В Slow логе регистрируются запросы, время выполнения которых превысило указанное.&lt;br /&gt;
&lt;br /&gt;
* Время выполнения включает в себя только время, необходимое для выполнения командного запроса.&lt;br /&gt;
* Время выполнения не включает операции ввода-вывода (например, диалог с клиентом или отправку ответов).&lt;br /&gt;
&lt;br /&gt;
Slow лог можно настроить с двумя параметрами:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;slowlog-log-slower-than&amp;lt;/code&amp;gt;сообщает Redis время выполнения (в микросекундах), превышение которого означает, что запрос был медленным и будет записан в Slow лог.&lt;br /&gt;
* &amp;lt;code&amp;gt;slowlog-max-len&amp;lt;/code&amp;gt;— максимальное количество запросов, сохраняемых в Slow логе.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6963</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6963"/>
		<updated>2026-09-29T00:53:22Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
*[[OpenTelemetry Collector]]&lt;br /&gt;
*[[OpenTelemetry Span Metrics Gateway]]&lt;br /&gt;
*[[RabbitMQ]]&lt;br /&gt;
*[[Prometheus Redis]]&lt;br /&gt;
*[[SOWA Monitor]]&lt;br /&gt;
*[[SOWA]]&lt;br /&gt;
*[[Tomcat JMX]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6962</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6962"/>
		<updated>2026-09-29T00:29:47Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
*[[OpenTelemetry Collector]]&lt;br /&gt;
*[[OpenTelemetry Span Metrics Gateway]]&lt;br /&gt;
*[[RabbitMQ]]&lt;br /&gt;
*[[Prometheus Redis]]&lt;br /&gt;
*[[SOWA Monitor]]&lt;br /&gt;
*[[SOWA]]&lt;br /&gt;
*[[Tomcat JMX]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=Tomcat_JMX&amp;diff=6961</id>
		<title>Tomcat JMX</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=Tomcat_JMX&amp;diff=6961"/>
		<updated>2026-09-29T00:29:14Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= Tomcat JMX =  Расширение предназначено для сбора показателей пулов подключений, пулов потоков и обработки веб-запросов Apache Tomcat через JMX.  Идентификатор: &amp;lt;code&amp;gt;ru.ruscomtech.extension.jmx-tomcat-cp&amp;lt;/code&amp;gt;  == Возможности ==  Расширение выполняет:  * мониторинг пулов подключений Tomcat; *...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Tomcat JMX =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для сбора показателей пулов подключений, пулов потоков и обработки веб-запросов Apache Tomcat через JMX.&lt;br /&gt;
&lt;br /&gt;
Идентификатор: &amp;lt;code&amp;gt;ru.ruscomtech.extension.jmx-tomcat-cp&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Возможности ==&lt;br /&gt;
&lt;br /&gt;
Расширение выполняет:&lt;br /&gt;
&lt;br /&gt;
* мониторинг пулов подключений Tomcat;&lt;br /&gt;
* сбор статистики веб-запросов и ошибок;&lt;br /&gt;
* мониторинг загрузки пулов потоков;&lt;br /&gt;
* обнаружение зависших потоков;&lt;br /&gt;
* расчёт доступных подключений и текущей загрузки пула;&lt;br /&gt;
* создание отдельных сущностей для пулов подключений;&lt;br /&gt;
* связывание пулов подключений с процессами Tomcat;&lt;br /&gt;
* формирование готовых обзорных панелей.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
Перед настройкой расширения убедитесь, что:&lt;br /&gt;
&lt;br /&gt;
* ЕдиныйАгент установлен на хосте с процессом Tomcat;&lt;br /&gt;
* активирована функция &amp;lt;code&amp;gt;Java Metric Extensions 2.0 (JMX)&amp;lt;/code&amp;gt;;&lt;br /&gt;
* после первого включения функции процесс Tomcat перезапущен;&lt;br /&gt;
* необходимые MBeans зарегистрированы в домене &amp;lt;code&amp;gt;Catalina&amp;lt;/code&amp;gt;;&lt;br /&gt;
* для сбора метрик пулов подключений используется стандартная реализация пула подключений Tomcat.&lt;br /&gt;
&lt;br /&gt;
Расширение получает данные непосредственно из контролируемого Java-процесса. Отдельно настраивать удалённый адрес, порт или учётную запись JMX не требуется.&lt;br /&gt;
&lt;br /&gt;
== Используемые MBeans ==&lt;br /&gt;
&lt;br /&gt;
Для пулов подключений используются MBeans:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
Catalina:type=DataSource,name=*,class=*,context=*,host=*&lt;br /&gt;
Catalina:type=DataSource,name=*,class=*&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Вторая форма используется для глобальных источников данных, у которых отсутствуют свойства &amp;lt;code&amp;gt;context&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;host&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Для пулов потоков:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
Catalina:type=ThreadPool,name=*,*&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для статистики веб-запросов:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
Catalina:type=GlobalRequestProcessor,name=*,*&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для зависших потоков:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
Catalina:type=Valve,name=StuckThreadDetectionValve,host=*,*&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Метрика зависших потоков доступна только при использовании &amp;lt;code&amp;gt;StuckThreadDetectionValve&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Установка и настройка ==&lt;br /&gt;
&lt;br /&gt;
# Загрузите пакет расширения в Ключ-АСТРОМ.&lt;br /&gt;
# Убедитесь, что на хосте с Tomcat установлен и подключён ЕдиныйАгент.&lt;br /&gt;
# В настройках функций ЕдиногоАгента включите &amp;lt;code&amp;gt;Java Metric Extensions 2.0 (JMX)&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Перезапустите процесс Tomcat после первого включения функции.&lt;br /&gt;
# Создайте конфигурацию расширения.&lt;br /&gt;
# Выберите необходимые наборы метрик.&lt;br /&gt;
# Ограничьте область действия конфигурации нужными хостами или группами хостов.&lt;br /&gt;
# Сохраните и активируйте конфигурацию.&lt;br /&gt;
&lt;br /&gt;
== Наборы метрик ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;key-metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Основные показатели пула: активные, созданные, свободные и ожидающие подключения.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;limits&amp;lt;/code&amp;gt;&lt;br /&gt;
| Настроенные ограничения пула подключений.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;additional-metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество полученных, возвращённых, освобождённых и повторно подключённых соединений.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;web-requests&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество запросов, ошибок, переданных данных и время обработки.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;thread-pools&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущее и максимальное количество потоков, а также количество занятых потоков.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;stuck-threads&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество зависших потоков Tomcat.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Рекомендуется сначала включить наборы &amp;lt;code&amp;gt;key-metrics&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;web-requests&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;thread-pools&amp;lt;/code&amp;gt;. Остальные наборы можно подключить при необходимости.&lt;br /&gt;
&lt;br /&gt;
== Основные метрики ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Группа&lt;br /&gt;
! Примеры метрик&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Пулы подключений&lt;br /&gt;
| &amp;lt;code&amp;gt;tomcat.connectionPool.activeConnections&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;tomcat.connectionPool.idleConnections&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;tomcat.connectionPool.numWaiters&amp;lt;/code&amp;gt;&lt;br /&gt;
| Активные, свободные и ожидающие подключения.&lt;br /&gt;
|-&lt;br /&gt;
| Ограничения пула&lt;br /&gt;
| &amp;lt;code&amp;gt;tomcat.connectionPool.maxActive&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;tomcat.connectionPool.maxTotal&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;tomcat.connectionPool.maxWait&amp;lt;/code&amp;gt;&lt;br /&gt;
| Максимальное количество подключений и время ожидания.&lt;br /&gt;
|-&lt;br /&gt;
| Веб-запросы&lt;br /&gt;
| &amp;lt;code&amp;gt;tomcat.requestCount.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;tomcat.errorCount.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;tomcat.processingTime.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество запросов и ошибок, а также суммарное время обработки.&lt;br /&gt;
|-&lt;br /&gt;
| Передача данных&lt;br /&gt;
| &amp;lt;code&amp;gt;tomcat.bytesReceived.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;tomcat.bytesSent.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество полученных и отправленных байтов.&lt;br /&gt;
|-&lt;br /&gt;
| Пулы потоков&lt;br /&gt;
| &amp;lt;code&amp;gt;tomcat.threadPool.currentThreadCount&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;tomcat.threadPool.currentThreadsBusy&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;tomcat.threadPool.maxThreads&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущее, занятое и максимально допустимое количество потоков.&lt;br /&gt;
|-&lt;br /&gt;
| Зависшие потоки&lt;br /&gt;
| &amp;lt;code&amp;gt;tomcat.stuckThreads&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество потоков, определённых Tomcat как зависшие.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Расчётные метрики ==&lt;br /&gt;
&lt;br /&gt;
Расширение содержит дополнительные расчётные показатели:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;func:tomcat.processingTimePerRequest&amp;lt;/code&amp;gt;&lt;br /&gt;
| Среднее время обработки одного запроса.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;func:tomcat.requestCountPerSecond&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество запросов в секунду.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;func:tomcat.errorCountPerSecond&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество ошибок в секунду.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;func:tomcat.bytesReceivedPerSecond&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество полученных байтов в секунду.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;func:tomcat.bytesSentPerSecond&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество отправленных байтов в секунду.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;func:tomcat.threadPool.utilization&amp;lt;/code&amp;gt;&lt;br /&gt;
| Процент использования пула потоков.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;func:tomcat.connectionPool.availableConnections&amp;lt;/code&amp;gt;&lt;br /&gt;
| Расчётное количество доступных подключений.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;func:tomcat.connectionPool.currentUsage&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущая загрузка пула подключений в процентах.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Обнаруживаемые сущности ==&lt;br /&gt;
&lt;br /&gt;
Для каждого обнаруженного пула подключений создаётся сущность &amp;lt;code&amp;gt;Tomcat Connection Pool&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Имя сущности формируется из имени источника данных. Пул подключений автоматически связывается с соответствующим экземпляром процесса Tomcat.&lt;br /&gt;
&lt;br /&gt;
== Обзорные панели ==&lt;br /&gt;
&lt;br /&gt;
В состав расширения входят готовые обзорные панели, содержащие:&lt;br /&gt;
&lt;br /&gt;
* список обнаруженных пулов подключений;&lt;br /&gt;
* количество активных и созданных подключений;&lt;br /&gt;
* загрузку пулов потоков;&lt;br /&gt;
* количество запросов и ошибок;&lt;br /&gt;
* среднее время обработки запросов.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После активации конфигурации убедитесь, что:&lt;br /&gt;
&lt;br /&gt;
* процесс Tomcat отображается в Ключ-АСТРОМ;&lt;br /&gt;
* поступают метрики с префиксами &amp;lt;code&amp;gt;tomcat.connectionPool&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;tomcat.threadPool&amp;lt;/code&amp;gt; или &amp;lt;code&amp;gt;tomcat.requestCount&amp;lt;/code&amp;gt;;&lt;br /&gt;
* созданы сущности &amp;lt;code&amp;gt;Tomcat Connection Pool&amp;lt;/code&amp;gt;;&lt;br /&gt;
* обзорная панель содержит данные контролируемого процесса.&lt;br /&gt;
&lt;br /&gt;
Наличие необходимых MBeans можно проверить с помощью JConsole или другого клиента JMX.&lt;br /&gt;
&lt;br /&gt;
== Устранение неисправностей ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Проблема&lt;br /&gt;
! Возможная причина и решение&lt;br /&gt;
|-&lt;br /&gt;
| Метрики Tomcat не поступают&lt;br /&gt;
| Проверьте, что функция &amp;lt;code&amp;gt;Java Metric Extensions 2.0 (JMX)&amp;lt;/code&amp;gt; включена, а процесс Tomcat был перезапущен.&lt;br /&gt;
|-&lt;br /&gt;
| Отсутствуют метрики пула подключений&lt;br /&gt;
| Проверьте наличие MBeans &amp;lt;code&amp;gt;Catalina:type=DataSource&amp;lt;/code&amp;gt;. Другие реализации пулов подключений могут использовать несовместимые MBeans.&lt;br /&gt;
|-&lt;br /&gt;
| Отсутствуют метрики веб-запросов&lt;br /&gt;
| Проверьте наличие MBeans &amp;lt;code&amp;gt;Catalina:type=GlobalRequestProcessor&amp;lt;/code&amp;gt; и включение набора &amp;lt;code&amp;gt;web-requests&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Отсутствуют метрики потоков&lt;br /&gt;
| Проверьте наличие MBeans &amp;lt;code&amp;gt;Catalina:type=ThreadPool&amp;lt;/code&amp;gt; и включение набора &amp;lt;code&amp;gt;thread-pools&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Метрика зависших потоков отсутствует&lt;br /&gt;
| Убедитесь, что в Tomcat настроен &amp;lt;code&amp;gt;StuckThreadDetectionValve&amp;lt;/code&amp;gt; и включён набор &amp;lt;code&amp;gt;stuck-threads&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Сущность пула не создаётся&lt;br /&gt;
| Проверьте поступление метрики &amp;lt;code&amp;gt;tomcat.connectionPool.activeConnections&amp;lt;/code&amp;gt; и наличие измерения &amp;lt;code&amp;gt;name&amp;lt;/code&amp;gt;.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 2.2.3&lt;br /&gt;
|Добавлены новые экраны и обзорные панели.&lt;br /&gt;
|-&lt;br /&gt;
| 2.2.1&lt;br /&gt;
|&lt;br /&gt;
* Расширение дополнено показателями сервера приложений.&lt;br /&gt;
* Добавлены наборы метрик пулов потоков и веб-запросов.&lt;br /&gt;
|-&lt;br /&gt;
&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6960</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6960"/>
		<updated>2026-09-29T00:22:03Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
*[[OpenTelemetry Collector]]&lt;br /&gt;
*[[OpenTelemetry Span Metrics Gateway]]&lt;br /&gt;
*[[RabbitMQ]]&lt;br /&gt;
*[[Prometheus Redis]]&lt;br /&gt;
*[[SOWA Monitor]]&lt;br /&gt;
*[[SOWA]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=SOWA&amp;diff=6959</id>
		<title>SOWA</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=SOWA&amp;diff=6959"/>
		<updated>2026-09-29T00:21:48Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= SOWA =  Расширение предназначено для мониторинга профилей SOWA через локальный интерфейс состояния.  Идентификатор: &amp;lt;code&amp;gt;custom:sowa&amp;lt;/code&amp;gt;.  == Возможности ==  Расширение выполняет:  * сбор статистики соединений SOWA; * мониторинг внешних соединений; * сбор показателей с...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= SOWA =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для мониторинга профилей SOWA через локальный интерфейс состояния.&lt;br /&gt;
&lt;br /&gt;
Идентификатор: &amp;lt;code&amp;gt;custom:sowa&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Возможности ==&lt;br /&gt;
&lt;br /&gt;
Расширение выполняет:&lt;br /&gt;
&lt;br /&gt;
* сбор статистики соединений SOWA;&lt;br /&gt;
* мониторинг внешних соединений;&lt;br /&gt;
* сбор показателей серверных зон и фильтров;&lt;br /&gt;
* сбор статистики ответов HTTP, MQ, Kafka и кеша;&lt;br /&gt;
* расчёт средней, минимальной и максимальной продолжительности запросов;&lt;br /&gt;
* создание сущностей хостов и профилей SOWA;&lt;br /&gt;
* установление связи между профилем и соответствующим хостом;&lt;br /&gt;
* формирование готовой обзорной панели.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
Расширение запускается локально на контролируемом хосте.&lt;br /&gt;
&lt;br /&gt;
Перед настройкой убедитесь, что:&lt;br /&gt;
&lt;br /&gt;
* локальный интерфейс состояния SOWA доступен через TCP-порт или Unix-сокет;&lt;br /&gt;
* интерфейс состояния возвращает данные в формате JSON;&lt;br /&gt;
* процесс ЕдиногоАгента или EEC имеет доступ к Unix-сокету SOWA;&lt;br /&gt;
* время на хостах синхронизировано;&lt;br /&gt;
* для каждого контролируемого профиля известно его имя.&lt;br /&gt;
&lt;br /&gt;
== Подключение к SOWA ==&lt;br /&gt;
&lt;br /&gt;
Способ подключения зависит от версии SOWA.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия SOWA&lt;br /&gt;
! Способ подключения&lt;br /&gt;
! Настройка&lt;br /&gt;
|-&lt;br /&gt;
| Ранее 5.2.1&lt;br /&gt;
| Локальный HTTP-интерфейс&lt;br /&gt;
| Укажите порт интерфейса &amp;lt;code&amp;gt;/status&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| 5.2.1 и новее&lt;br /&gt;
| Unix-сокет&lt;br /&gt;
| Оставьте поле порта пустым.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
При указании порта расширение обращается по адресу:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://127.0.0.1:&amp;amp;lt;порт&amp;amp;gt;/status&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Если порт не указан, используется Unix-сокет:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
/sowarun/&amp;amp;lt;имя_профиля&amp;amp;gt;/service_profile_status.sock&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Установка и настройка ==&lt;br /&gt;
&lt;br /&gt;
# Загрузите пакет расширения в Ключ-АСТРОМ.&lt;br /&gt;
# Создайте локальную конфигурацию расширения.&lt;br /&gt;
# Выберите хост, группу хостов или зону управления, на которых должно выполняться расширение.&lt;br /&gt;
# Добавьте конечную точку SOWA.&lt;br /&gt;
# Укажите имя профиля.&lt;br /&gt;
# Для версий SOWA ранее 5.2.1 укажите порт интерфейса состояния.&lt;br /&gt;
# Для подключения через Unix-сокет оставьте поле порта пустым.&lt;br /&gt;
# Сохраните и активируйте конфигурацию.&lt;br /&gt;
&lt;br /&gt;
=== Параметры конфигурации ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Обязательный&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Profile name&amp;lt;/code&amp;gt;&lt;br /&gt;
| Да&lt;br /&gt;
| Имя контролируемого профиля SOWA. Оно также используется для формирования пути к Unix-сокету и как измерение метрик.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;port&amp;lt;/code&amp;gt;&lt;br /&gt;
| Нет&lt;br /&gt;
| Порт локального интерфейса &amp;lt;code&amp;gt;/status&amp;lt;/code&amp;gt;. Используется для версий SOWA ранее 5.2.1. Если поле пустое, расширение подключается через Unix-сокет.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
В одной конфигурации можно добавить несколько профилей SOWA.&lt;br /&gt;
&lt;br /&gt;
Пример для подключения через TCP-порт:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
Profile name: production&lt;br /&gt;
port: 8080&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для подключения через Unix-сокет укажите имя профиля &amp;lt;code&amp;gt;production&amp;lt;/code&amp;gt;, а поле &amp;lt;code&amp;gt;port&amp;lt;/code&amp;gt; оставьте пустым.&lt;br /&gt;
&lt;br /&gt;
== Наборы метрик ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Profile Metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущие и суммарные показатели внутренних и внешних соединений SOWA.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Server Zone Metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Запросы, входящий и исходящий трафик, ответы и продолжительность запросов серверных зон.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Filter Zone Metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Запросы, трафик, ответы и продолжительность запросов для фильтров и их экземпляров.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Основные метрики ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Группа&lt;br /&gt;
! Примеры метрик&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Соединения&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.sowa.connections.active&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;ru.ruscomtech.sowa.connections.requests.total&amp;lt;/code&amp;gt;&lt;br /&gt;
| Активные соединения и общее количество запросов.&lt;br /&gt;
|-&lt;br /&gt;
| Внешние соединения&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.sowa.connections_external.active&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;ru.ruscomtech.sowa.connections_external.requests.total&amp;lt;/code&amp;gt;&lt;br /&gt;
| Состояние соединений внешнего интерфейса.&lt;br /&gt;
|-&lt;br /&gt;
| Серверные зоны&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.sowa.server_zone.request_counter&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;ru.ruscomtech.sowa.server_zone.in_bytes&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;ru.ruscomtech.sowa.server_zone.out_bytes&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество запросов и объём трафика серверной зоны.&lt;br /&gt;
|-&lt;br /&gt;
| Ответы серверных зон&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.sowa.server_zone.responses.2xx&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;ru.ruscomtech.sowa.server_zone.responses.5xx&amp;lt;/code&amp;gt;&lt;br /&gt;
| HTTP-ответы, результаты работы MQ, Kafka и кеша.&lt;br /&gt;
|-&lt;br /&gt;
| Продолжительность запросов&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.sowa.server_zone.request_msecs.avg&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;ru.ruscomtech.sowa.server_zone.request_msecs.high&amp;lt;/code&amp;gt;&lt;br /&gt;
| Средняя, максимальная, минимальная продолжительность и количество запросов.&lt;br /&gt;
|-&lt;br /&gt;
| Фильтры&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.sowa.filter_zone.request_counter&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&amp;lt;code&amp;gt;ru.ruscomtech.sowa.filter_zone.responses.5xx&amp;lt;/code&amp;gt;&lt;br /&gt;
| Показатели отдельных фильтров и их экземпляров.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Метрики содержат измерения с именем хоста, профилем, версиями SOWA и NGINX. Для зон и фильтров дополнительно передаются их имена.&lt;br /&gt;
&lt;br /&gt;
== Обнаруживаемые сущности ==&lt;br /&gt;
&lt;br /&gt;
Расширение создаёт следующие типы сущностей:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;Sowa Host&amp;lt;/code&amp;gt; — контролируемый хост SOWA;&lt;br /&gt;
* &amp;lt;code&amp;gt;Sowa profile&amp;lt;/code&amp;gt; — отдельный профиль SOWA.&lt;br /&gt;
&lt;br /&gt;
Между профилем и хостом автоматически создаётся связь &amp;lt;code&amp;gt;RUNS_ON&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Обзорная панель ==&lt;br /&gt;
&lt;br /&gt;
В состав расширения входит панель &amp;lt;code&amp;gt;SOWA Extension Overview&amp;lt;/code&amp;gt;. Она содержит список обнаруженных профилей и основные показатели соединений и запросов.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
Для подключения через TCP-порт проверьте доступность интерфейса состояния непосредственно на хосте:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl http://127.0.0.1:&amp;amp;lt;порт&amp;amp;gt;/status&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для подключения через Unix-сокет проверьте наличие файла:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
ls -l /sowarun/&amp;amp;lt;имя_профиля&amp;amp;gt;/service_profile_status.sock&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
После активации конфигурации убедитесь, что:&lt;br /&gt;
&lt;br /&gt;
* созданы сущности хоста и профиля SOWA;&lt;br /&gt;
* поступают метрики с префиксом &amp;lt;code&amp;gt;ru.ruscomtech.sowa&amp;lt;/code&amp;gt;;&lt;br /&gt;
* на обзорной панели отображается настроенный профиль.&lt;br /&gt;
&lt;br /&gt;
== Устранение неисправностей ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Проблема&lt;br /&gt;
! Возможная причина и решение&lt;br /&gt;
|-&lt;br /&gt;
| Ошибка подключения к порту&lt;br /&gt;
| Проверьте номер порта и доступность адреса &amp;lt;code&amp;gt;http://127.0.0.1:&amp;amp;lt;порт&amp;amp;gt;/status&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Ошибка подключения к Unix-сокету&lt;br /&gt;
| Проверьте имя профиля, наличие сокета и права процесса ЕдиногоАгента или EEC.&lt;br /&gt;
|-&lt;br /&gt;
| Интерфейс доступен, но метрики отсутствуют&lt;br /&gt;
| Убедитесь, что интерфейс состояния возвращает корректный JSON.&lt;br /&gt;
|-&lt;br /&gt;
| Не собирается продолжительность запросов&lt;br /&gt;
| Проверьте синхронизацию времени на контролируемом хосте.&lt;br /&gt;
|-&lt;br /&gt;
| Не отображается профиль&lt;br /&gt;
| Проверьте значение поля &amp;lt;code&amp;gt;Profile name&amp;lt;/code&amp;gt; и наличие основных метрик соединений.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 0.0.86&lt;br /&gt;
|&lt;br /&gt;
* Добавлен мониторинг профилей SOWA через локальный интерфейс состояния.&lt;br /&gt;
* Добавлена поддержка подключения через TCP-порт и Unix-сокет.&lt;br /&gt;
* Добавлен сбор метрик соединений, серверных зон и фильтров.&lt;br /&gt;
* Добавлены сущности хостов и профилей SOWA.&lt;br /&gt;
* Добавлена готовая обзорная панель.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6958</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6958"/>
		<updated>2026-09-29T00:17:55Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
*[[OpenTelemetry Collector]]&lt;br /&gt;
*[[OpenTelemetry Span Metrics Gateway]]&lt;br /&gt;
*[[RabbitMQ]]&lt;br /&gt;
*[[Prometheus Redis]]&lt;br /&gt;
*[[SOWA Monitor]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=SOWA_Monitor&amp;diff=6957</id>
		<title>SOWA Monitor</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=SOWA_Monitor&amp;diff=6957"/>
		<updated>2026-09-29T00:17:37Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= SOWA Monitor =  Расширение предназначено для сбора метрик SOWA из локального файла статистики, формируемого на контролируемом хосте.  Идентификатор: &amp;lt;code&amp;gt;ru.ruscomtech.sowa-monitor&amp;lt;/code&amp;gt;  == Возможности ==  Расширение выполняет:  * чтение метрик профилей SOWA; * сбор состояния сер...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= SOWA Monitor =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для сбора метрик SOWA из локального файла статистики, формируемого на контролируемом хосте.&lt;br /&gt;
&lt;br /&gt;
Идентификатор: &amp;lt;code&amp;gt;ru.ruscomtech.sowa-monitor&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Возможности ==&lt;br /&gt;
&lt;br /&gt;
Расширение выполняет:&lt;br /&gt;
&lt;br /&gt;
* чтение метрик профилей SOWA;&lt;br /&gt;
* сбор состояния сервисов;&lt;br /&gt;
* расчёт количества дней до окончания срока действия сертификатов;&lt;br /&gt;
* преобразование логических значений &amp;lt;code&amp;gt;true&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;false&amp;lt;/code&amp;gt; в числовые значения;&lt;br /&gt;
* добавление источника, профиля, сервиса и имени метрики в измерения.&lt;br /&gt;
&lt;br /&gt;
Расширение запускается локально на хосте и не устанавливает сетевые подключения к SOWA.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
Перед настройкой расширения убедитесь, что:&lt;br /&gt;
&lt;br /&gt;
* файл статистики создаётся на том же хосте, на котором запускается расширение;&lt;br /&gt;
* файл сохранён в кодировке UTF-8;&lt;br /&gt;
* для файла используется абсолютный путь;&lt;br /&gt;
* процесс ЕдиногоАгента или EEC имеет права на чтение файла;&lt;br /&gt;
* каждая метрика записывается отдельной строкой в поддерживаемом формате.&lt;br /&gt;
&lt;br /&gt;
== Формат файла статистики ==&lt;br /&gt;
&lt;br /&gt;
Каждая строка должна иметь следующий формат:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;amp;lt;источник&amp;amp;gt; &amp;amp;lt;область_метрики&amp;amp;gt;[&amp;amp;lt;объект&amp;amp;gt;,&amp;amp;lt;метрика&amp;amp;gt;] &amp;amp;lt;значение&amp;amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Пример:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
sowa-host-01 sowa.profile[MainProfile,availability] 1&lt;br /&gt;
sowa-host-01 sowa.profile[MainProfile,errors] 0&lt;br /&gt;
sowa-host-01 sowa.profile.certificate[api.example.local,valid_throw] 1798761600&lt;br /&gt;
sowa-host-01 sowa.profile.service.http[frontend,response_time] 125.7&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Элемент&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;источник&amp;lt;/code&amp;gt;&lt;br /&gt;
| Имя системы или хоста, сформировавшего метрику.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;область_метрики&amp;lt;/code&amp;gt;&lt;br /&gt;
| Тип метрики: &amp;lt;code&amp;gt;sowa.profile&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;sowa.profile.certificate&amp;lt;/code&amp;gt; или область, начинающаяся с &amp;lt;code&amp;gt;sowa.profile.service&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;объект&amp;lt;/code&amp;gt;&lt;br /&gt;
| Имя профиля, сертификата или сервиса.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;метрика&amp;lt;/code&amp;gt;&lt;br /&gt;
| Имя показателя.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;значение&amp;lt;/code&amp;gt;&lt;br /&gt;
| Число либо логическое значение &amp;lt;code&amp;gt;true&amp;lt;/code&amp;gt; или &amp;lt;code&amp;gt;false&amp;lt;/code&amp;gt;.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Значение &amp;lt;code&amp;gt;true&amp;lt;/code&amp;gt; преобразуется в &amp;lt;code&amp;gt;1&amp;lt;/code&amp;gt;, а &amp;lt;code&amp;gt;false&amp;lt;/code&amp;gt; — в &amp;lt;code&amp;gt;0&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Для метрики &amp;lt;code&amp;gt;valid_throw&amp;lt;/code&amp;gt; необходимо передавать дату окончания действия сертификата в виде временной метки Unix в секундах. Расширение преобразует её в количество оставшихся дней.&lt;br /&gt;
&lt;br /&gt;
Пустые строки и строки неподдерживаемого формата пропускаются.&lt;br /&gt;
&lt;br /&gt;
== Установка и настройка ==&lt;br /&gt;
&lt;br /&gt;
# Загрузите пакет расширения в Ключ-АСТРОМ.&lt;br /&gt;
# Создайте локальную конфигурацию расширения.&lt;br /&gt;
# Выберите хост, группу хостов или зону управления, на которых должен выполняться сбор.&lt;br /&gt;
# Добавьте источник данных.&lt;br /&gt;
# Укажите абсолютный путь к файлу статистики.&lt;br /&gt;
# При необходимости включите сбор метрик сервисов.&lt;br /&gt;
# Сохраните и активируйте конфигурацию.&lt;br /&gt;
&lt;br /&gt;
=== Параметры конфигурации ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
! Значение по умолчанию&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Stats file path&amp;lt;/code&amp;gt;&lt;br /&gt;
| Абсолютный путь к файлу статистики SOWA.&lt;br /&gt;
| &amp;lt;code&amp;gt;/tmp/zabbix/all_stat.data&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Include sowa.profile.service* metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Включает сбор областей метрик, начинающихся с &amp;lt;code&amp;gt;sowa.profile.service&amp;lt;/code&amp;gt;.&lt;br /&gt;
| Отключено&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
В одной конфигурации можно создать несколько источников для чтения разных файлов статистики.&lt;br /&gt;
&lt;br /&gt;
== Собираемые метрики ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
! Единица измерения&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;sowa.zabbix.profile.value&amp;lt;/code&amp;gt;&lt;br /&gt;
| Значение метрики профиля SOWA.&lt;br /&gt;
| Количество&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;sowa.zabbix.profile.certificate.value&amp;lt;/code&amp;gt;&lt;br /&gt;
| Значение метрики сертификата, включая количество дней до окончания его действия.&lt;br /&gt;
| Дни&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;sowa.zabbix.profile.service.value&amp;lt;/code&amp;gt;&lt;br /&gt;
| Значение метрики сервиса SOWA.&lt;br /&gt;
| Количество&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
На контролируемом хосте проверьте доступность файла:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
test -r /tmp/zabbix/all_stat.data&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
После активации конфигурации убедитесь, что в Ключ-АСТРОМ поступают метрики с префиксом &amp;lt;code&amp;gt;sowa.zabbix&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Успешное сохранение конфигурации не подтверждает доступность файла. Если метрики отсутствуют, проверьте журнал выполнения расширения.&lt;br /&gt;
&lt;br /&gt;
== Устранение неисправностей ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Проблема&lt;br /&gt;
! Возможная причина и решение&lt;br /&gt;
|-&lt;br /&gt;
| Метрики не поступают&lt;br /&gt;
| Проверьте путь к файлу и права процесса ЕдиногоАгента или EEC на его чтение.&lt;br /&gt;
|-&lt;br /&gt;
| Обрабатываются не все строки&lt;br /&gt;
| Проверьте формат строк, наличие запятой между именем объекта и метрики, а также числовой формат значения.&lt;br /&gt;
|-&lt;br /&gt;
| Не поступают метрики сервисов&lt;br /&gt;
| Включите параметр &amp;lt;code&amp;gt;Include sowa.profile.service* metrics&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Неверно рассчитан срок действия сертификата&lt;br /&gt;
| Передавайте для метрики &amp;lt;code&amp;gt;valid_throw&amp;lt;/code&amp;gt; временную метку Unix в секундах, а не в миллисекундах.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 0.1.0&lt;br /&gt;
|&lt;br /&gt;
* Добавлен локальный сбор метрик профилей SOWA из файла статистики.&lt;br /&gt;
* Добавлен сбор метрик сервисов.&lt;br /&gt;
* Добавлен расчёт количества дней до окончания срока действия сертификатов.&lt;br /&gt;
* Добавлена поддержка логических и числовых значений.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6956</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6956"/>
		<updated>2026-09-29T00:12:02Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
*[[OpenTelemetry Collector]]&lt;br /&gt;
*[[OpenTelemetry Span Metrics Gateway]]&lt;br /&gt;
*[[RabbitMQ]]&lt;br /&gt;
*[[Prometheus Redis]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=Prometheus_Redis&amp;diff=6955</id>
		<title>Prometheus Redis</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=Prometheus_Redis&amp;diff=6955"/>
		<updated>2026-09-29T00:10:30Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= Prometheus Redis =  Расширение предназначено для мониторинга Redis по метрикам Prometheus, публикуемым Redis Exporter.  Расширение собирает показатели производительности Redis и самого экспортёра, создаёт связанные сущности Redis и Exporter и добавляет готовую обзорную панель.  &amp;#039;&amp;#039;&amp;#039;...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Prometheus Redis =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для мониторинга Redis по метрикам Prometheus, публикуемым Redis Exporter.&lt;br /&gt;
&lt;br /&gt;
Расширение собирает показатели производительности Redis и самого экспортёра, создаёт связанные сущности Redis и Exporter и добавляет готовую обзорную панель.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Идентификатор расширения:&#039;&#039;&#039; &amp;lt;code&amp;gt;prometheus-redis&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Схема работы ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
Redis&lt;br /&gt;
  |&lt;br /&gt;
  | команды INFO, CONFIG, SLOWLOG и другие&lt;br /&gt;
  v&lt;br /&gt;
Redis Exporter&lt;br /&gt;
  |&lt;br /&gt;
  | Prometheus /metrics&lt;br /&gt;
  v&lt;br /&gt;
EEC&lt;br /&gt;
  |&lt;br /&gt;
  v&lt;br /&gt;
Ключ-АСТРОМ&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Расширение не подключается к Redis напрямую. Перед настройкой необходимо установить и запустить Redis Exporter.&lt;br /&gt;
&lt;br /&gt;
== Возможности ==&lt;br /&gt;
&lt;br /&gt;
* контроль доступности Redis;&lt;br /&gt;
* мониторинг памяти и фрагментации;&lt;br /&gt;
* контроль клиентов и соединений;&lt;br /&gt;
* анализ выполненных и отклонённых команд;&lt;br /&gt;
* мониторинг ключей, попаданий и промахов кеша;&lt;br /&gt;
* контроль удаления и истечения срока действия ключей;&lt;br /&gt;
* мониторинг RDB и AOF;&lt;br /&gt;
* контроль репликации;&lt;br /&gt;
* сбор сетевых показателей;&lt;br /&gt;
* мониторинг состояния Redis Exporter;&lt;br /&gt;
* расчёт коэффициента попаданий в кеш;&lt;br /&gt;
* создание сущностей Redis и Exporter.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
* Redis Exporter должен иметь сетевой доступ к Redis.&lt;br /&gt;
* Prometheus endpoint экспортёра должен быть доступен с сервера EEC.&lt;br /&gt;
* Межсетевой экран должен разрешать подключения от EEC к Redis Exporter.&lt;br /&gt;
* Пользователь Redis должен иметь права, необходимые экспортёру для получения статистики.&lt;br /&gt;
* Для каждого Redis Exporter рекомендуется задавать уникальное имя scraper.&lt;br /&gt;
&lt;br /&gt;
По умолчанию Redis Exporter публикует метрики по адресу:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://exporter.example.local:9121/metrics&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Установка Redis Exporter ==&lt;br /&gt;
&lt;br /&gt;
Redis Exporter можно запустить как отдельный процесс, контейнер или компонент Kubernetes.&lt;br /&gt;
&lt;br /&gt;
Пример файла переменных окружения:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
REDIS_ADDR=redis://redis.example.local:6379&lt;br /&gt;
REDIS_USER=monitoring&lt;br /&gt;
REDIS_PASSWORD=&amp;amp;lt;password&amp;amp;gt;&lt;br /&gt;
REDIS_EXPORTER_WEB_LISTEN_ADDRESS=0.0.0.0:9121&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Пример запуска контейнера:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
docker run -d \&lt;br /&gt;
  --name redis-exporter \&lt;br /&gt;
  --restart unless-stopped \&lt;br /&gt;
  --env-file /etc/redis-exporter.env \&lt;br /&gt;
  -p 9121:9121 \&lt;br /&gt;
  ghcr.io/oliver006/redis_exporter:&amp;amp;lt;version&amp;amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Используйте протестированную в вашей среде версию Redis Exporter. Пароль Redis рекомендуется хранить в защищённом файле или системе управления секретами.&lt;br /&gt;
&lt;br /&gt;
Проверьте работу экспортёра:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl http://exporter.example.local:9121/metrics&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
В ответе должны присутствовать метрики с префиксом &amp;lt;code&amp;gt;redis_&amp;lt;/code&amp;gt;. Метрика &amp;lt;code&amp;gt;redis_up&amp;lt;/code&amp;gt; должна иметь значение &amp;lt;code&amp;gt;1&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Защита Redis Exporter ==&lt;br /&gt;
&lt;br /&gt;
Доступ к порту &amp;lt;code&amp;gt;9121&amp;lt;/code&amp;gt; рекомендуется разрешать только с серверов EEC и других систем мониторинга.&lt;br /&gt;
&lt;br /&gt;
Redis Exporter также поддерживает Basic-аутентификацию:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
REDIS_EXPORTER_BASIC_AUTH_USERNAME=monitoring&lt;br /&gt;
REDIS_EXPORTER_BASIC_AUTH_PASSWORD=&amp;amp;lt;password&amp;amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Если Basic-аутентификация включена, те же учётные данные необходимо указать при настройке Prometheus endpoint в Ключ-АСТРОМ.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Скачайте пакет расширения.&lt;br /&gt;
# В интерфейсе Ключ-АСТРОМ откройте раздел управления расширениями.&lt;br /&gt;
# Загрузите архив расширения.&lt;br /&gt;
# Откройте расширение &amp;lt;code&amp;gt;prometheus-redis&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Добавьте конфигурацию мониторинга.&lt;br /&gt;
# Выберите удалённый режим выполнения.&lt;br /&gt;
# Укажите группу EEC, с которой доступен Redis Exporter.&lt;br /&gt;
# Добавьте Prometheus endpoint.&lt;br /&gt;
# Выберите необходимые наборы функций.&lt;br /&gt;
# Сохраните и активируйте конфигурацию.&lt;br /&gt;
&lt;br /&gt;
== Настройка подключения ==&lt;br /&gt;
&lt;br /&gt;
Укажите URL Prometheus endpoint:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://exporter.example.local:9121/metrics&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Если Redis Exporter защищён Basic-аутентификацией, выберите соответствующий тип аутентификации и укажите имя пользователя и пароль.&lt;br /&gt;
&lt;br /&gt;
В поле «If multiple separate scrapers are used please enter name» укажите понятное уникальное имя экспортёра, например:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
redis-exporter-production&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Значение добавляется в измерение &amp;lt;code&amp;gt;scrapername&amp;lt;/code&amp;gt; и используется при создании сущности Exporter.&lt;br /&gt;
&lt;br /&gt;
== Мониторинг нескольких Redis ==&lt;br /&gt;
&lt;br /&gt;
Для каждого отдельного Redis Exporter можно создать собственный endpoint и указать уникальное значение &amp;lt;code&amp;gt;scrapername&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Redis Exporter также поддерживает multi-target режим через endpoint:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://exporter.example.local:9121/scrape?target=redis://redis.example.local:6379&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
При использовании multi-target режима создайте отдельный endpoint для каждого контролируемого Redis и убедитесь, что адрес Redis корректно закодирован в URL.&lt;br /&gt;
&lt;br /&gt;
== Наборы функций ==&lt;br /&gt;
&lt;br /&gt;
Расширение позволяет отдельно включать следующие группы показателей:&lt;br /&gt;
&lt;br /&gt;
* память и аллокатор;&lt;br /&gt;
* клиенты и соединения;&lt;br /&gt;
* команды Redis;&lt;br /&gt;
* базы данных и keyspace;&lt;br /&gt;
* удаление и истечение ключей;&lt;br /&gt;
* кластер и репликация;&lt;br /&gt;
* RDB и AOF;&lt;br /&gt;
* процессор, сеть и процесс Redis;&lt;br /&gt;
* Pub/Sub и модули;&lt;br /&gt;
* состояние Redis Exporter;&lt;br /&gt;
* процесс и среда Go экспортёра.&lt;br /&gt;
&lt;br /&gt;
Для базового мониторинга рекомендуется включить:&lt;br /&gt;
&lt;br /&gt;
* Memory metrics;&lt;br /&gt;
* Client metrics;&lt;br /&gt;
* Connected metrics;&lt;br /&gt;
* Command metrics;&lt;br /&gt;
* Database metrics;&lt;br /&gt;
* Keyspace metrics;&lt;br /&gt;
* Replication metrics;&lt;br /&gt;
* Exporter metrics.&lt;br /&gt;
&lt;br /&gt;
Набор Standalone scraper metrics содержит показатели процесса Redis Exporter и среды Go.&lt;br /&gt;
&lt;br /&gt;
Не включайте ненужные наборы функций: метки Prometheus автоматически становятся измерениями и могут увеличить количество временных рядов.&lt;br /&gt;
&lt;br /&gt;
== Основные метрики ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Группа&lt;br /&gt;
! Метрики&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| Доступность&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_up&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_uptime_in_seconds&amp;lt;/code&amp;gt;&lt;br /&gt;
| Доступность и время работы Redis.&lt;br /&gt;
|-&lt;br /&gt;
| Память&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_memory_used_bytes&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_memory_max_bytes&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_memory_used_rss_bytes&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_mem_fragmentation_ratio&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование памяти и её фрагментация.&lt;br /&gt;
|-&lt;br /&gt;
| Клиенты&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_connected_clients&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_blocked_clients&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_rejected_connections_total.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Подключённые и заблокированные клиенты, отклонённые подключения.&lt;br /&gt;
|-&lt;br /&gt;
| Команды&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_commands_processed_total.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_commands_failed_calls_total.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_commands_rejected_calls_total.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Выполненные, завершившиеся ошибкой и отклонённые команды.&lt;br /&gt;
|-&lt;br /&gt;
| Keyspace&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_keyspace_hits_total.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_keyspace_misses_total.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;func:ru.ruscomtech.extension.prometheus-redis_keyspace_cache_ratio.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Попадания, промахи и рассчитанный коэффициент попаданий в кеш.&lt;br /&gt;
|-&lt;br /&gt;
| Базы данных&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_db_keys&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_db_keys_expiring&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_db_avg_ttl_seconds&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество ключей и среднее время жизни.&lt;br /&gt;
|-&lt;br /&gt;
| Удаление ключей&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_evicted_keys_total.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_expired_keys_total.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Ключи, удалённые из-за нехватки памяти или истечения TTL.&lt;br /&gt;
|-&lt;br /&gt;
| Репликация&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_master_repl_offset&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_replication_backlog_bytes&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_replica_resyncs_full&amp;lt;/code&amp;gt;&lt;br /&gt;
| Состояние журнала репликации и повторной синхронизации.&lt;br /&gt;
|-&lt;br /&gt;
| Сеть&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_net_input_bytes_total.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_net_output_bytes_total.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Входящий и исходящий сетевой трафик.&lt;br /&gt;
|-&lt;br /&gt;
| Экспортёр&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_exporter_last_scrape_error&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_exporter_last_scrape_duration_seconds&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus_redis-redis_exporter_scrapes_total.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Ошибки, продолжительность и количество опросов Redis Exporter.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Наличие отдельных метрик зависит от версии Redis, конфигурации Redis Exporter и включённых возможностей Redis.&lt;br /&gt;
&lt;br /&gt;
== Сущности и топология ==&lt;br /&gt;
&lt;br /&gt;
Расширение создаёт следующие сущности:&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;&#039;Redis&#039;&#039;&#039; — контролируемый экземпляр Redis;&lt;br /&gt;
* &#039;&#039;&#039;Exporter&#039;&#039;&#039; — экземпляр Redis Exporter.&lt;br /&gt;
&lt;br /&gt;
Сущность Redis связывается с соответствующим Exporter отношением «дочерняя сущность».&lt;br /&gt;
&lt;br /&gt;
Для идентификации Redis используются адрес хоста, TCP-порт и доступные измерения инфраструктуры.&lt;br /&gt;
&lt;br /&gt;
== Обзорная панель ==&lt;br /&gt;
&lt;br /&gt;
В состав расширения входит готовая панель «Redis Extension 2.0». Она отображает:&lt;br /&gt;
&lt;br /&gt;
* доступность экземпляров Redis;&lt;br /&gt;
* количество выполненных команд;&lt;br /&gt;
* использование памяти;&lt;br /&gt;
* попадания и промахи кеша;&lt;br /&gt;
* соединения;&lt;br /&gt;
* удалённые и просроченные ключи;&lt;br /&gt;
* состояние репликации;&lt;br /&gt;
* показатели Redis Exporter.&lt;br /&gt;
&lt;br /&gt;
Расширение также добавляет страницы сущностей Redis и Exporter.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После активации конфигурации убедитесь, что:&lt;br /&gt;
&lt;br /&gt;
* endpoint Redis Exporter доступен с сервера EEC;&lt;br /&gt;
* в ответе присутствуют метрики &amp;lt;code&amp;gt;redis_*&amp;lt;/code&amp;gt;;&lt;br /&gt;
* метрика &amp;lt;code&amp;gt;redis_up&amp;lt;/code&amp;gt; имеет значение &amp;lt;code&amp;gt;1&amp;lt;/code&amp;gt;;&lt;br /&gt;
* конфигурация расширения не содержит ошибок;&lt;br /&gt;
* появляются сущности Redis и Exporter;&lt;br /&gt;
* данные отображаются на обзорной панели.&lt;br /&gt;
&lt;br /&gt;
Если метрики экспортёра поступают, но метрики Redis отсутствуют, проверьте:&lt;br /&gt;
&lt;br /&gt;
* адрес Redis в конфигурации экспортёра;&lt;br /&gt;
* имя пользователя и пароль Redis;&lt;br /&gt;
* сетевой доступ от экспортёра к Redis;&lt;br /&gt;
* значение &amp;lt;code&amp;gt;redis_exporter_last_scrape_error&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 20.22.13&lt;br /&gt;
|&lt;br /&gt;
* Добавлен сбор метрик Redis через Redis Exporter.&lt;br /&gt;
* Добавлены тематические наборы метрик памяти, клиентов, команд, keyspace, репликации, RDB и AOF.&lt;br /&gt;
* Добавлен расчёт коэффициента попаданий в кеш.&lt;br /&gt;
* Добавлены сущности Redis и Exporter.&lt;br /&gt;
* Добавлена готовая обзорная панель.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6954</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6954"/>
		<updated>2026-09-29T00:04:18Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
*[[OpenTelemetry Collector]]&lt;br /&gt;
*[[OpenTelemetry Span Metrics Gateway]]&lt;br /&gt;
*[[RabbitMQ]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=RabbitMQ&amp;diff=6953</id>
		<title>RabbitMQ</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=RabbitMQ&amp;diff=6953"/>
		<updated>2026-09-29T00:03:55Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= RabbitMQ =  Расширение предназначено для мониторинга кластеров RabbitMQ через Management HTTP API.  Собираются показатели кластера, отдельных узлов, виртуальных хостов и очередей. Расширение также создаёт связанные сущности RabbitMQ и добавляет готовую обзорную панель....»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= RabbitMQ =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для мониторинга кластеров RabbitMQ через Management HTTP API.&lt;br /&gt;
&lt;br /&gt;
Собираются показатели кластера, отдельных узлов, виртуальных хостов и очередей. Расширение также создаёт связанные сущности RabbitMQ и добавляет готовую обзорную панель.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Идентификатор расширения:&#039;&#039;&#039; &amp;lt;code&amp;gt;ru.ruscomtech.rabbitmq&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Возможности ==&lt;br /&gt;
&lt;br /&gt;
* мониторинг кластера RabbitMQ;&lt;br /&gt;
* мониторинг состояния узлов;&lt;br /&gt;
* контроль количества и состояния сообщений;&lt;br /&gt;
* мониторинг очередей и потребителей;&lt;br /&gt;
* сбор статистики публикации, доставки и повторной доставки сообщений;&lt;br /&gt;
* контроль памяти, дискового пространства, файловых дескрипторов и сокетов;&lt;br /&gt;
* мониторинг виртуальных хостов;&lt;br /&gt;
* фильтрация собираемых очередей по регулярным выражениям;&lt;br /&gt;
* резервный список адресов RabbitMQ Management API;&lt;br /&gt;
* использование Credential Vault;&lt;br /&gt;
* локальный или удалённый сбор данных.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
* На RabbitMQ должен быть включён плагин &amp;lt;code&amp;gt;rabbitmq_management&amp;lt;/code&amp;gt;.&lt;br /&gt;
* HTTP API должен быть доступен с сервера EEC или с хоста, на котором выполняется локальный сбор.&lt;br /&gt;
* Пользователь должен иметь тег &amp;lt;code&amp;gt;monitoring&amp;lt;/code&amp;gt; и доступ к необходимым виртуальным хостам.&lt;br /&gt;
* Для аутентификации используется имя пользователя и пароль.&lt;br /&gt;
* Если RabbitMQ использует HTTPS, сертификат должен быть доверенным либо необходимо указать файл внутреннего центра сертификации.&lt;br /&gt;
&lt;br /&gt;
Расширение использует следующие методы Management API:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;/api/overview&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;/api/queues&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;/api/nodes&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;/api/vhosts&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Подготовка RabbitMQ ==&lt;br /&gt;
&lt;br /&gt;
Включите Management Plugin:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
rabbitmq-plugins enable rabbitmq_management&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
По умолчанию Management API использует следующие порты:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;15672&amp;lt;/code&amp;gt; — HTTP;&lt;br /&gt;
* &amp;lt;code&amp;gt;15671&amp;lt;/code&amp;gt; — HTTPS, если настроен TLS.&lt;br /&gt;
&lt;br /&gt;
=== Создание пользователя мониторинга ===&lt;br /&gt;
&lt;br /&gt;
Пример создания отдельного пользователя:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
rabbitmqctl add_user monitoring &amp;amp;lt;password&amp;amp;gt;&lt;br /&gt;
rabbitmqctl set_user_tags monitoring monitoring&lt;br /&gt;
rabbitmqctl set_permissions --vhost / monitoring &amp;quot;^$&amp;quot; &amp;quot;^$&amp;quot; &amp;quot;^$&amp;quot;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для мониторинга нескольких виртуальных хостов выполните команду &amp;lt;code&amp;gt;set_permissions&amp;lt;/code&amp;gt; для каждого из них.&lt;br /&gt;
&lt;br /&gt;
Проверьте доступ к Management API:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl -u monitoring http://rabbitmq-01.example.local:15672/api/overview&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Команда запросит пароль пользователя и должна вернуть описание кластера в формате JSON.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Важно:&#039;&#039;&#039; расширение использует Basic-аутентификацию. Если в RabbitMQ установлено &amp;lt;code&amp;gt;management.disable_basic_auth = true&amp;lt;/code&amp;gt;, созданная конфигурация не сможет подключиться.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Скачайте пакет расширения.&lt;br /&gt;
# В интерфейсе Ключ-АСТРОМ откройте раздел управления расширениями.&lt;br /&gt;
# Загрузите архив расширения.&lt;br /&gt;
# Откройте расширение &amp;lt;code&amp;gt;ru.ruscomtech.rabbitmq&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Добавьте конфигурацию мониторинга.&lt;br /&gt;
# Выберите локальный или удалённый режим выполнения.&lt;br /&gt;
# Для удалённого режима выберите группу EEC.&lt;br /&gt;
# Заполните параметры подключения.&lt;br /&gt;
# Выберите необходимые наборы функций.&lt;br /&gt;
# Сохраните и активируйте конфигурацию.&lt;br /&gt;
&lt;br /&gt;
== Настройка подключения ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Cluster name&lt;br /&gt;
| Понятное уникальное имя кластера. Оно используется в измерениях метрик и идентификаторах сущностей.&lt;br /&gt;
|-&lt;br /&gt;
| Nodes&lt;br /&gt;
| Один или несколько базовых URL RabbitMQ Management API. Путь &amp;lt;code&amp;gt;/api&amp;lt;/code&amp;gt; добавлять не нужно.&lt;br /&gt;
|-&lt;br /&gt;
| Use Credential Vault&lt;br /&gt;
| Включите, если имя пользователя и пароль должны храниться в Credential Vault.&lt;br /&gt;
|-&lt;br /&gt;
| Select vault credentials&lt;br /&gt;
| Учётная запись типа username/password с областью Extension authentication.&lt;br /&gt;
|-&lt;br /&gt;
| Username&lt;br /&gt;
| Пользователь RabbitMQ с тегом &amp;lt;code&amp;gt;monitoring&amp;lt;/code&amp;gt;. Заполняется, если Credential Vault не используется.&lt;br /&gt;
|-&lt;br /&gt;
| Password&lt;br /&gt;
| Пароль пользователя RabbitMQ. Заполняется, если Credential Vault не используется.&lt;br /&gt;
|-&lt;br /&gt;
| Queues to monitor&lt;br /&gt;
| Список регулярных выражений для выбора очередей.&lt;br /&gt;
|-&lt;br /&gt;
| Verify Server Certificate&lt;br /&gt;
| Проверка TLS-сертификата RabbitMQ.&lt;br /&gt;
|-&lt;br /&gt;
| CA Certificate Location&lt;br /&gt;
| Путь к файлу сертификата внутреннего центра сертификации.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Пример списка узлов:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
https://rabbitmq-01.example.local:15671&lt;br /&gt;
https://rabbitmq-02.example.local:15671&lt;br /&gt;
https://rabbitmq-03.example.local:15671&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Расширение проверяет адреса по порядку и подключается к первому доступному. Для кластера можно также указать один адрес балансировщика нагрузки.&lt;br /&gt;
&lt;br /&gt;
Файл, заданный в поле «CA Certificate Location», должен существовать на сервере, где выполняется расширение.&lt;br /&gt;
&lt;br /&gt;
== Фильтрация очередей ==&lt;br /&gt;
&lt;br /&gt;
По умолчанию используется выражение:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
.*&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Оно включает все доступные очереди.&lt;br /&gt;
&lt;br /&gt;
Пример мониторинга только очередей с префиксом &amp;lt;code&amp;gt;orders.&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
^orders\.&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Пример выбора нескольких отдельных очередей:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
^orders\.created$&lt;br /&gt;
^orders\.processed$&lt;br /&gt;
^payments$&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
При большом количестве очередей рекомендуется ограничивать список: каждая очередь создаёт отдельную сущность и набор временных рядов.&lt;br /&gt;
&lt;br /&gt;
== Наборы функций ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| Cluster&lt;br /&gt;
| Общие показатели кластера: сообщения, соединения, каналы, очереди, обменники, потребители и скорость обработки сообщений.&lt;br /&gt;
|-&lt;br /&gt;
| Node&lt;br /&gt;
| Ресурсы узлов: память, диск, файловые дескрипторы, сокеты, сетевые разделения, время работы и сборка мусора.&lt;br /&gt;
|-&lt;br /&gt;
| Queue&lt;br /&gt;
| Размер и состояние очередей, память, потребители, публикация, доставка, повторная доставка и сообщения без маршрута.&lt;br /&gt;
|-&lt;br /&gt;
| Virtual Host&lt;br /&gt;
| Сообщения и сетевой трафик виртуальных хостов.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Для базового контроля рекомендуется включить &amp;lt;code&amp;gt;Cluster&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;Node&amp;lt;/code&amp;gt;. Набор &amp;lt;code&amp;gt;Queue&amp;lt;/code&amp;gt; следует включать с учётом количества очередей.&lt;br /&gt;
&lt;br /&gt;
== Основные метрики ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Группа&lt;br /&gt;
! Метрики&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| Кластер&lt;br /&gt;
| &amp;lt;code&amp;gt;rabbitmq.cluster.messages&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.cluster.messages_ready&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.cluster.messages_unacknowledged&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.cluster.connections&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.cluster.consumers&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.cluster.publish.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.cluster.deliver_get.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Состояние очередей и общий поток сообщений в кластере.&lt;br /&gt;
|-&lt;br /&gt;
| Узлы&lt;br /&gt;
| &amp;lt;code&amp;gt;rabbitmq.node.mem_used&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.node.mem_limit&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.node.disk_free&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.node.fd_used&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.node.sockets_used&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.node.partitions&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.node.uptime&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование ресурсов и состояние отдельных узлов.&lt;br /&gt;
|-&lt;br /&gt;
| Очереди&lt;br /&gt;
| &amp;lt;code&amp;gt;rabbitmq.queue.messages&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.queue.messages_ready&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.queue.messages_unacknowledged&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.queue.consumers&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.queue.publish.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.queue.redeliver.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.queue.drop_unroutable.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Размер очередей, потребители и движение сообщений.&lt;br /&gt;
|-&lt;br /&gt;
| Виртуальные хосты&lt;br /&gt;
| &amp;lt;code&amp;gt;rabbitmq.vhost.messages&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.vhost.messages_ready&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.vhost.messages_unacknowledged&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.vhost.recv_oct.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;rabbitmq.vhost.send_oct.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество сообщений и сетевой трафик виртуальных хостов.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Сущности и топология ==&lt;br /&gt;
&lt;br /&gt;
Расширение создаёт следующие сущности:&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;&#039;Cluster&#039;&#039;&#039; — кластер RabbitMQ;&lt;br /&gt;
* &#039;&#039;&#039;Node&#039;&#039;&#039; — узел кластера;&lt;br /&gt;
* &#039;&#039;&#039;Virtual Host&#039;&#039;&#039; — виртуальный хост;&lt;br /&gt;
* &#039;&#039;&#039;Queue&#039;&#039;&#039; — очередь RabbitMQ.&lt;br /&gt;
&lt;br /&gt;
Между сущностями создаются связи:&lt;br /&gt;
&lt;br /&gt;
* Node работает в Cluster;&lt;br /&gt;
* Virtual Host относится к Cluster;&lt;br /&gt;
* Queue работает на Node;&lt;br /&gt;
* Queue относится к Virtual Host.&lt;br /&gt;
&lt;br /&gt;
При наличии подходящего IP-адреса узел RabbitMQ связывается с соответствующим хостом Ключ-АСТРОМ.&lt;br /&gt;
&lt;br /&gt;
== Обзорная панель ==&lt;br /&gt;
&lt;br /&gt;
В состав расширения входит готовая обзорная панель RabbitMQ. Она отображает:&lt;br /&gt;
&lt;br /&gt;
* количество кластеров, узлов, виртуальных хостов и очередей;&lt;br /&gt;
* готовые и неподтверждённые сообщения;&lt;br /&gt;
* публикацию и доставку сообщений;&lt;br /&gt;
* соединения и потребителей;&lt;br /&gt;
* использование памяти и дискового пространства;&lt;br /&gt;
* состояние отдельных очередей.&lt;br /&gt;
&lt;br /&gt;
Расширение также добавляет страницы сущностей для кластеров, узлов, виртуальных хостов и очередей.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После активации конфигурации убедитесь, что:&lt;br /&gt;
&lt;br /&gt;
* проверка подключения завершается успешно;&lt;br /&gt;
* выбранный адрес Management API доступен с EEC или контролируемого хоста;&lt;br /&gt;
* пользователь получает ответы от &amp;lt;code&amp;gt;/api/overview&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;/api/nodes&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;/api/vhosts&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;/api/queues&amp;lt;/code&amp;gt;;&lt;br /&gt;
* появляются метрики &amp;lt;code&amp;gt;rabbitmq.cluster.*&amp;lt;/code&amp;gt;;&lt;br /&gt;
* создаётся сущность RabbitMQ Cluster;&lt;br /&gt;
* при включённых наборах появляются Node, Virtual Host и Queue;&lt;br /&gt;
* данные отображаются на обзорной панели.&lt;br /&gt;
&lt;br /&gt;
Если кластерные метрики поступают, но очереди отсутствуют, проверьте права пользователя на виртуальные хосты и выражения в поле «Queues to monitor».&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 2.1.5&lt;br /&gt;
|&lt;br /&gt;
* Добавлен сбор данных через RabbitMQ Management HTTP API.&lt;br /&gt;
* Добавлены наборы Cluster, Node, Queue и Virtual Host.&lt;br /&gt;
* Добавлены резервные адреса узлов и поддержка Credential Vault.&lt;br /&gt;
* Добавлены сущности RabbitMQ и связи между ними.&lt;br /&gt;
* Добавлена готовая обзорная панель.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6952</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6952"/>
		<updated>2026-09-28T23:54:27Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
*[[OpenTelemetry Collector]]&lt;br /&gt;
*[[OpenTelemetry Span Metrics Gateway]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=OpenTelemetry_Span_Metrics_Gateway&amp;diff=6951</id>
		<title>OpenTelemetry Span Metrics Gateway</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=OpenTelemetry_Span_Metrics_Gateway&amp;diff=6951"/>
		<updated>2026-09-28T23:54:01Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= OpenTelemetry Span Metrics Gateway =  Расширение принимает трассировки по протоколу OTLP/HTTP, формирует из спанов метрики количества вызовов и продолжительности и при необходимости пересылает исходные трассировки в кластер Ключ-АСТРОМ.  Расширение выполняется удалённ...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= OpenTelemetry Span Metrics Gateway =&lt;br /&gt;
&lt;br /&gt;
Расширение принимает трассировки по протоколу OTLP/HTTP, формирует из спанов метрики количества вызовов и продолжительности и при необходимости пересылает исходные трассировки в кластер Ключ-АСТРОМ.&lt;br /&gt;
&lt;br /&gt;
Расширение выполняется удалённо на сервере EEC.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Идентификатор расширения:&#039;&#039;&#039; &amp;lt;code&amp;gt;ru.ruscomtech.otel-span-metrics-gateway&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Возможности ==&lt;br /&gt;
&lt;br /&gt;
* приём трассировок через OTLP/HTTP;&lt;br /&gt;
* поддержка бинарного формата protobuf;&lt;br /&gt;
* поддержка сжатия gzip;&lt;br /&gt;
* создание метрик количества и продолжительности спанов;&lt;br /&gt;
* добавление атрибутов спанов в измерения метрик;&lt;br /&gt;
* ограничение количества временных рядов;&lt;br /&gt;
* защита входящего endpoint с помощью Bearer-токена;&lt;br /&gt;
* пересылка исходных трассировок в кластер Ключ-АСТРОМ;&lt;br /&gt;
* контроль отклонённых запросов и ошибок пересылки.&lt;br /&gt;
&lt;br /&gt;
== Схема работы ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
Приложение или OpenTelemetry Collector&lt;br /&gt;
        |&lt;br /&gt;
        | OTLP/HTTP protobuf&lt;br /&gt;
        v&lt;br /&gt;
OpenTelemetry Span Metrics Gateway на EEC&lt;br /&gt;
        |&lt;br /&gt;
        +-- метрики спанов --&amp;gt; Ключ-АСТРОМ&lt;br /&gt;
        |&lt;br /&gt;
        +-- исходные трассировки --&amp;gt; OTLP API Ключ-АСТРОМ&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Шлюз принимает трассировки по следующим путям:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;/v1/traces&amp;lt;/code&amp;gt; — стандартный путь OTLP/HTTP;&lt;br /&gt;
* &amp;lt;code&amp;gt;/otlp/v1/traces&amp;lt;/code&amp;gt; — дополнительный поддерживаемый путь.&lt;br /&gt;
&lt;br /&gt;
OTLP/gRPC и OTLP/JSON не поддерживаются.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
* На выбранном сервере EEC должен быть свободен TCP-порт для приёма OTLP-запросов.&lt;br /&gt;
* Приложения или OpenTelemetry Collector должны иметь сетевой доступ к серверу EEC.&lt;br /&gt;
* Экспорт трассировок должен использовать протокол &amp;lt;code&amp;gt;http/protobuf&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Для пересылки трассировок в кластер необходим токен с разрешением &amp;lt;code&amp;gt;openTelemetryTrace.ingest&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Межсетевой экран должен разрешать подключения к настроенному порту шлюза.&lt;br /&gt;
&lt;br /&gt;
Стандартный порт OTLP/HTTP — &amp;lt;code&amp;gt;4318&amp;lt;/code&amp;gt;. Если он уже используется другим сервисом, укажите свободный порт.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Скачайте пакет расширения.&lt;br /&gt;
# В интерфейсе Ключ-АСТРОМ откройте раздел управления расширениями.&lt;br /&gt;
# Загрузите архив расширения.&lt;br /&gt;
# Откройте расширение &amp;lt;code&amp;gt;ru.ruscomtech.otel-span-metrics-gateway&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Добавьте конфигурацию мониторинга.&lt;br /&gt;
# Выберите группу EEC, на которой должен работать OTLP-шлюз.&lt;br /&gt;
# Добавьте конечную точку шлюза и заполните параметры.&lt;br /&gt;
# Сохраните и активируйте конфигурацию.&lt;br /&gt;
&lt;br /&gt;
Для одной конфигурации можно создать только одну конечную точку шлюза.&lt;br /&gt;
&lt;br /&gt;
== Настройка шлюза ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Значение по умолчанию&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Адрес прослушивания&lt;br /&gt;
| &amp;lt;code&amp;gt;0.0.0.0&amp;lt;/code&amp;gt;&lt;br /&gt;
| IP-адрес интерфейса EEC. Значение &amp;lt;code&amp;gt;0.0.0.0&amp;lt;/code&amp;gt; разрешает подключения на всех интерфейсах.&lt;br /&gt;
|-&lt;br /&gt;
| Порт прослушивания&lt;br /&gt;
| &amp;lt;code&amp;gt;4318&amp;lt;/code&amp;gt;&lt;br /&gt;
| TCP-порт для входящих запросов OTLP/HTTP.&lt;br /&gt;
|-&lt;br /&gt;
| Пересылать трейсы в кластер&lt;br /&gt;
| Включено&lt;br /&gt;
| При включении шлюз создаёт метрики и пересылает исходные трассировки. При выключении создаются только метрики.&lt;br /&gt;
|-&lt;br /&gt;
| URL для OTLP-трейсов кластера&lt;br /&gt;
| —&lt;br /&gt;
| Полный адрес OTLP API, заканчивающийся на &amp;lt;code&amp;gt;/v1/traces&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| API-токен кластера&lt;br /&gt;
| —&lt;br /&gt;
| Токен с разрешением &amp;lt;code&amp;gt;openTelemetryTrace.ingest&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Проверять TLS-сертификат&lt;br /&gt;
| Включено&lt;br /&gt;
| Проверка сертификата при пересылке трассировок. Отключать рекомендуется только при тестировании.&lt;br /&gt;
|-&lt;br /&gt;
| Bearer-токен приёмника&lt;br /&gt;
| —&lt;br /&gt;
| Необязательный токен для защиты входящего OTLP endpoint.&lt;br /&gt;
|-&lt;br /&gt;
| Атрибуты спана для dimensions&lt;br /&gt;
| &amp;lt;code&amp;gt;peer.service,net.peer.ip&amp;lt;/code&amp;gt;&lt;br /&gt;
| Атрибуты спана, которые необходимо добавить в измерения метрик.&lt;br /&gt;
|-&lt;br /&gt;
| Максимальное количество временных рядов&lt;br /&gt;
| &amp;lt;code&amp;gt;2000&amp;lt;/code&amp;gt;&lt;br /&gt;
| Ограничение количества уникальных комбинаций измерений за один интервал отправки.&lt;br /&gt;
|-&lt;br /&gt;
| Максимальный размер запроса&lt;br /&gt;
| &amp;lt;code&amp;gt;8 MiB&amp;lt;/code&amp;gt;&lt;br /&gt;
| Максимальный размер OTLP-запроса после распаковки.&lt;br /&gt;
|-&lt;br /&gt;
| Рабочие потоки&lt;br /&gt;
| &amp;lt;code&amp;gt;4&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество запросов, которые могут обрабатываться параллельно.&lt;br /&gt;
|-&lt;br /&gt;
| Размер очереди запросов&lt;br /&gt;
| &amp;lt;code&amp;gt;16&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество запросов, ожидающих свободный рабочий поток.&lt;br /&gt;
|-&lt;br /&gt;
| Интервал отправки метрик&lt;br /&gt;
| &amp;lt;code&amp;gt;15 секунд&amp;lt;/code&amp;gt;&lt;br /&gt;
| Период агрегации и отправки метрик в Ключ-АСТРОМ.&lt;br /&gt;
|-&lt;br /&gt;
| Тайм-аут пересылки трассировок&lt;br /&gt;
| &amp;lt;code&amp;gt;10 секунд&amp;lt;/code&amp;gt;&lt;br /&gt;
| Максимальное время ожидания ответа от OTLP API.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Пример URL для пересылки трассировок через Environment ActiveGate:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
https://activegate.example.local:9999/e/ENVIRONMENT_ID/api/v2/otlp/v1/traces&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Если пересылка трассировок отключена, URL и API-токен заполнять не требуется.&lt;br /&gt;
&lt;br /&gt;
== Настройка отправителя OTLP ==&lt;br /&gt;
&lt;br /&gt;
Пример переменных окружения приложения или OpenTelemetry Collector:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://eec.example.local:4318/v1/traces&lt;br /&gt;
OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Если в конфигурации шлюза задан Bearer-токен:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
OTEL_EXPORTER_OTLP_TRACES_HEADERS=&amp;quot;Authorization=Bearer &amp;lt;token&amp;gt;&amp;quot;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Значение токена на стороне отправителя должно совпадать со значением поля «Bearer-токен приёмника».&lt;br /&gt;
&lt;br /&gt;
=== Пример конфигурации OpenTelemetry Collector ===&lt;br /&gt;
&lt;br /&gt;
OpenTelemetry Collector может принимать трассировки от приложений и передавать их в шлюз, работающий на сервере EEC.&lt;br /&gt;
&lt;br /&gt;
Пример файла &amp;lt;code&amp;gt;config.yaml&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
receivers:&lt;br /&gt;
  otlp:&lt;br /&gt;
    protocols:&lt;br /&gt;
      grpc:&lt;br /&gt;
        endpoint: 0.0.0.0:4317&lt;br /&gt;
      http:&lt;br /&gt;
        endpoint: 0.0.0.0:4318&lt;br /&gt;
&lt;br /&gt;
processors:&lt;br /&gt;
  batch:&lt;br /&gt;
&lt;br /&gt;
exporters:&lt;br /&gt;
  otlp_http/span_metrics_gateway:&lt;br /&gt;
    traces_endpoint: http://eec.example.local:4318&lt;br /&gt;
    encoding: proto&lt;br /&gt;
    compression: gzip&lt;br /&gt;
    headers:&lt;br /&gt;
      Authorization: &amp;quot;Bearer &amp;amp;lt;receiver-token&amp;amp;gt;&amp;quot;&lt;br /&gt;
    timeout: 10s&lt;br /&gt;
&lt;br /&gt;
service:&lt;br /&gt;
  pipelines:&lt;br /&gt;
    traces:&lt;br /&gt;
      receivers:&lt;br /&gt;
        - otlp&lt;br /&gt;
      processors:&lt;br /&gt;
        - batch&lt;br /&gt;
      exporters:&lt;br /&gt;
        - otlp_http/span_metrics_gateway&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Замените:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;eec.example.local&amp;lt;/code&amp;gt; — адресом сервера EEC, на котором работает расширение;&lt;br /&gt;
* &amp;lt;code&amp;gt;4318&amp;lt;/code&amp;gt; — портом, указанным в конфигурации шлюза;&lt;br /&gt;
* &amp;lt;code&amp;gt;&amp;amp;lt;receiver-token&amp;amp;gt;&amp;lt;/code&amp;gt; — значением поля «Bearer-токен приёмника».&lt;br /&gt;
&lt;br /&gt;
Если Bearer-токен в расширении не настроен, удалите из конфигурации блок:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
headers:&lt;br /&gt;
  Authorization: &amp;quot;Bearer &amp;amp;lt;receiver-token&amp;amp;gt;&amp;quot;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
В старых версиях OpenTelemetry Collector компонент экспортёра может называться &amp;lt;code&amp;gt;otlphttp&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
exporters:&lt;br /&gt;
  otlphttp/span_metrics_gateway:&lt;br /&gt;
    traces_endpoint: http://eec.example.local:4318&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
После изменения конфигурации перезапустите OpenTelemetry Collector и проверьте появление метрики &amp;lt;code&amp;gt;otel.span.gateway.requests&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Важно:&#039;&#039;&#039; расширение добавляет в измерения только атрибуты спанов. Resource attributes, например &amp;lt;code&amp;gt;service.name&amp;lt;/code&amp;gt;, автоматически не используются.&lt;br /&gt;
&lt;br /&gt;
Если необходимо группировать метрики по имени сервиса, в OpenTelemetry Collector Contrib можно скопировать &amp;lt;code&amp;gt;service.name&amp;lt;/code&amp;gt; из resource attributes в атрибут спана:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
processors:&lt;br /&gt;
  transform/span_dimensions:&lt;br /&gt;
    error_mode: ignore&lt;br /&gt;
    trace_statements:&lt;br /&gt;
      - context: span&lt;br /&gt;
        statements:&lt;br /&gt;
          - set(attributes[&amp;quot;service.name&amp;quot;], resource.attributes[&amp;quot;service.name&amp;quot;])&lt;br /&gt;
            where resource.attributes[&amp;quot;service.name&amp;quot;] != nil&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Затем добавьте процессор в трассировочный pipeline:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
service:&lt;br /&gt;
  pipelines:&lt;br /&gt;
    traces:&lt;br /&gt;
      receivers:&lt;br /&gt;
        - otlp&lt;br /&gt;
      processors:&lt;br /&gt;
        - transform/span_dimensions&lt;br /&gt;
        - batch&lt;br /&gt;
      exporters:&lt;br /&gt;
        - otlp_http/span_metrics_gateway&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
В конфигурации расширения добавьте &amp;lt;code&amp;gt;service.name&amp;lt;/code&amp;gt; в поле «Атрибуты спана для dimensions».&lt;br /&gt;
&lt;br /&gt;
== Режимы работы ==&lt;br /&gt;
&lt;br /&gt;
=== Метрики и трассировки ===&lt;br /&gt;
&lt;br /&gt;
При включённой пересылке шлюз:&lt;br /&gt;
&lt;br /&gt;
# принимает OTLP-запрос;&lt;br /&gt;
# декодирует спаны;&lt;br /&gt;
# пересылает исходный запрос в OTLP API;&lt;br /&gt;
# после успешной пересылки учитывает спаны в метриках.&lt;br /&gt;
&lt;br /&gt;
Если кластер возвращает ошибку или недоступен, увеличивается метрика &amp;lt;code&amp;gt;otel.span.gateway.forward_errors&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Только метрики ===&lt;br /&gt;
&lt;br /&gt;
При выключенной пересылке шлюз создаёт метрики из принятых спанов, но не отправляет исходные трассировки в кластер.&lt;br /&gt;
&lt;br /&gt;
== Настройка измерений ==&lt;br /&gt;
&lt;br /&gt;
Измерение &amp;lt;code&amp;gt;span.name&amp;lt;/code&amp;gt; добавляется автоматически.&lt;br /&gt;
&lt;br /&gt;
В поле «Атрибуты спана для dimensions» можно:&lt;br /&gt;
&lt;br /&gt;
* перечислить необходимые атрибуты через запятую;&lt;br /&gt;
* указать &amp;lt;code&amp;gt;*&amp;lt;/code&amp;gt; для автоматического добавления допустимых атрибутов спана;&lt;br /&gt;
* оставить поле пустым, если дополнительные измерения не нужны.&lt;br /&gt;
&lt;br /&gt;
Пример:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
peer.service,net.peer.ip,http.request.method&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Resource attributes в измерения метрик не добавляются.&lt;br /&gt;
&lt;br /&gt;
Использование &amp;lt;code&amp;gt;*&amp;lt;/code&amp;gt; может значительно увеличить кардинальность метрик. Для рабочих сред рекомендуется перечислять только необходимые атрибуты.&lt;br /&gt;
&lt;br /&gt;
Если количество уникальных комбинаций измерений превышает установленный предел, оставшиеся спаны объединяются в ряд:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
otel.metric.overflow=true&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Количество таких спанов отображается в метрике &amp;lt;code&amp;gt;otel.span.gateway.overflow_spans&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Собираемые метрики ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;otel.span.calls&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество успешно обработанных спанов. Метрика разделяется по имени спана и настроенным атрибутам.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;otel.span.duration&amp;lt;/code&amp;gt;&lt;br /&gt;
| Продолжительность обработанных спанов в миллисекундах.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;otel.span.gateway.requests&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество успешно обработанных OTLP-запросов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;otel.span.gateway.spans&amp;lt;/code&amp;gt;&lt;br /&gt;
| Общее количество спанов в обработанных запросах.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;otel.span.gateway.rejected_requests&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество отклонённых запросов с измерением &amp;lt;code&amp;gt;reason&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;otel.span.gateway.forward_errors&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество ошибок пересылки трассировок в кластер.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;otel.span.gateway.active_series&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество активных временных рядов в текущем интервале агрегации.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;otel.span.gateway.overflow_spans&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество спанов, объединённых в overflow-ряд из-за ограничения кардинальности.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Все метрики входят в набор функций &amp;lt;code&amp;gt;default&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
Проверьте состояние HTTP-приёмника:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl http://eec.example.local:4318/healthz&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Исправный шлюз возвращает:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
ok&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
После отправки трассировок проверьте:&lt;br /&gt;
&lt;br /&gt;
* состояние конфигурации расширения;&lt;br /&gt;
* появление метрики &amp;lt;code&amp;gt;otel.span.gateway.requests&amp;lt;/code&amp;gt;;&lt;br /&gt;
* появление метрик &amp;lt;code&amp;gt;otel.span.calls&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;otel.span.duration&amp;lt;/code&amp;gt;;&lt;br /&gt;
* отсутствие постоянного роста &amp;lt;code&amp;gt;otel.span.gateway.rejected_requests&amp;lt;/code&amp;gt;;&lt;br /&gt;
* отсутствие ошибок &amp;lt;code&amp;gt;otel.span.gateway.forward_errors&amp;lt;/code&amp;gt;;&lt;br /&gt;
* значение &amp;lt;code&amp;gt;otel.span.gateway.overflow_spans&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Код ответа &amp;lt;code&amp;gt;401&amp;lt;/code&amp;gt; указывает на ошибку Bearer-токена, &amp;lt;code&amp;gt;413&amp;lt;/code&amp;gt; — на превышение размера запроса, &amp;lt;code&amp;gt;415&amp;lt;/code&amp;gt; — на неподдерживаемый формат, а &amp;lt;code&amp;gt;503&amp;lt;/code&amp;gt; — на переполнение очереди шлюза.&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 0.1.19&lt;br /&gt;
|&lt;br /&gt;
* Используется идентификатор &amp;lt;code&amp;gt;ru.ruscomtech.otel-span-metrics-gateway&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Добавлен шлюз для преобразования OTLP-спанов в метрики количества вызовов и продолжительности.&lt;br /&gt;
* Поддержаны режимы «метрики и трассировки» и «только метрики».&lt;br /&gt;
* Добавлены ограничения размера запросов, очереди обработки и количества временных рядов.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6902</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6902"/>
		<updated>2026-09-25T20:01:34Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
*[[OpenTelemetry Collector]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=OpenTelemetry_Collector&amp;diff=6901</id>
		<title>OpenTelemetry Collector</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=OpenTelemetry_Collector&amp;diff=6901"/>
		<updated>2026-09-25T20:01:11Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= OpenTelemetry Collector =  Расширение предназначено для контроля состояния OpenTelemetry Collector по его внутренним метрикам. Данные собираются с Prometheus endpoint коллектора.  Расширение позволяет контролировать:  * приём и отправку метрик, трассировок и журналов; * ошибки приём...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= OpenTelemetry Collector =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для контроля состояния OpenTelemetry Collector по его внутренним метрикам. Данные собираются с Prometheus endpoint коллектора.&lt;br /&gt;
&lt;br /&gt;
Расширение позволяет контролировать:&lt;br /&gt;
&lt;br /&gt;
* приём и отправку метрик, трассировок и журналов;&lt;br /&gt;
* ошибки приёма и отправки данных;&lt;br /&gt;
* заполнение очередей экспортёров;&lt;br /&gt;
* загрузку процессора и использование памяти;&lt;br /&gt;
* работу пакетной обработки;&lt;br /&gt;
* время работы экземпляров коллектора.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Пакет расширения:&#039;&#039;&#039; [https://distrib.ruscomtech.ru/f/43057 OTel Collector 1.0.5]&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Идентификатор расширения:&#039;&#039;&#039; &amp;lt;code&amp;gt;ru.ruscomtech.extension.otel-collector&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
* OpenTelemetry Collector должен публиковать внутренние метрики в формате Prometheus.&lt;br /&gt;
* Prometheus endpoint должен быть доступен с сервера EEC, на котором будет выполняться сбор.&lt;br /&gt;
* Между EEC и OpenTelemetry Collector должен быть разрешён сетевой доступ к порту endpoint.&lt;br /&gt;
* Метрики должны содержать атрибуты &amp;lt;code&amp;gt;service_name&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;service_instance_id&amp;lt;/code&amp;gt;, используемые для создания сущностей.&lt;br /&gt;
&lt;br /&gt;
== Настройка OpenTelemetry Collector ==&lt;br /&gt;
&lt;br /&gt;
По умолчанию внутренние метрики коллектора обычно доступны по адресу:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://127.0.0.1:8888/metrics&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для удалённого сбора endpoint необходимо опубликовать на сетевом интерфейсе, доступном серверу EEC.&lt;br /&gt;
&lt;br /&gt;
Пример конфигурации для актуальных версий OpenTelemetry Collector:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
service:&lt;br /&gt;
  telemetry:&lt;br /&gt;
    resource:&lt;br /&gt;
      service.name: otel-collector&lt;br /&gt;
    metrics:&lt;br /&gt;
      readers:&lt;br /&gt;
        - pull:&lt;br /&gt;
            exporter:&lt;br /&gt;
              prometheus:&lt;br /&gt;
                host: 0.0.0.0&lt;br /&gt;
                port: 8888&lt;br /&gt;
                without_type_suffix: true&lt;br /&gt;
                without_units: true&lt;br /&gt;
                with_resource_constant_labels:&lt;br /&gt;
                  included:&lt;br /&gt;
                    - service.name&lt;br /&gt;
                    - service.instance.id&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Параметры &amp;lt;code&amp;gt;without_type_suffix&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;without_units&amp;lt;/code&amp;gt; сохраняют имена метрик в формате, ожидаемом расширением.&lt;br /&gt;
&lt;br /&gt;
При использовании адреса &amp;lt;code&amp;gt;0.0.0.0&amp;lt;/code&amp;gt; рекомендуется ограничить доступ к порту &amp;lt;code&amp;gt;8888&amp;lt;/code&amp;gt; средствами межсетевого экрана.&lt;br /&gt;
&lt;br /&gt;
Проверьте доступность endpoint с сервера EEC:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl http://collector.example.local:8888/metrics&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
В ответе должны присутствовать метрики с префиксом &amp;lt;code&amp;gt;otelcol_&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Установка и настройка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Скачайте пакет расширения.&lt;br /&gt;
# В интерфейсе Ключ-АСТРОМ откройте раздел управления расширениями.&lt;br /&gt;
# Загрузите архив расширения.&lt;br /&gt;
# Откройте расширение &amp;lt;code&amp;gt;ru.ruscomtech.extension.otel-collector&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Добавьте конфигурацию мониторинга.&lt;br /&gt;
# Выберите удалённый сбор данных.&lt;br /&gt;
# Укажите адрес Prometheus endpoint, например:&lt;br /&gt;
#: &amp;lt;pre&amp;gt;http://collector.example.local:8888/metrics&amp;lt;/pre&amp;gt;&lt;br /&gt;
# Выберите группу EEC, с которой доступен OpenTelemetry Collector.&lt;br /&gt;
# При необходимости настройте аутентификацию, тайм-аут и количество повторных попыток.&lt;br /&gt;
# Сохраните и активируйте конфигурацию.&lt;br /&gt;
&lt;br /&gt;
Отдельные наборы функций в расширении не предусмотрены: после активации собираются все объявленные метрики.&lt;br /&gt;
&lt;br /&gt;
== Собираемые данные ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Группа&lt;br /&gt;
! Основные метрики&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| Приём данных&lt;br /&gt;
| &amp;lt;code&amp;gt;otelcol_receiver_accepted_metric_points.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_receiver_accepted_spans.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_receiver_refused_metric_points.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_receiver_refused_spans.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество принятых и отклонённых метрик и трассировок.&lt;br /&gt;
|-&lt;br /&gt;
| Отправка данных&lt;br /&gt;
| &amp;lt;code&amp;gt;otelcol_exporter_sent_metric_points.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_exporter_sent_spans.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_exporter_send_failed_metric_points.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_exporter_send_failed_spans.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Успешная отправка данных и ошибки экспортёров.&lt;br /&gt;
|-&lt;br /&gt;
| Журналы&lt;br /&gt;
| &amp;lt;code&amp;gt;otelcol_exporter_sent_log_records.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_exporter_send_failed_log_records.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество отправленных и неотправленных записей журналов.&lt;br /&gt;
|-&lt;br /&gt;
| Очереди экспортёров&lt;br /&gt;
| &amp;lt;code&amp;gt;otelcol_exporter_queue_size&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_exporter_queue_capacity&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущий размер и максимальная ёмкость очереди.&lt;br /&gt;
|-&lt;br /&gt;
| Ресурсы процесса&lt;br /&gt;
| &amp;lt;code&amp;gt;otelcol_process_cpu_seconds.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_process_memory_rss&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_process_runtime_heap_alloc_bytes&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_process_uptime.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Загрузка процессора, использование памяти и время работы коллектора.&lt;br /&gt;
|-&lt;br /&gt;
| Пакетная обработка&lt;br /&gt;
| &amp;lt;code&amp;gt;otelcol_processor_batch_batch_send_size&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_processor_batch_size_trigger_send.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_processor_batch_timeout_trigger_send.count&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;otelcol_processor_batch_metadata_cardinality&amp;lt;/code&amp;gt;&lt;br /&gt;
| Размеры пакетов, причины их отправки и кардинальность метаданных.&lt;br /&gt;
|-&lt;br /&gt;
| Дополнительные показатели&lt;br /&gt;
| &amp;lt;code&amp;gt;otelcol_fileconsumer_open_files&amp;lt;/code&amp;gt;&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;code&amp;gt;promhttp_metric_handler_errors_total.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество открытых файлов и ошибки обработчика Prometheus.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Наличие конкретных метрик зависит от состава и конфигурации OpenTelemetry Collector.&lt;br /&gt;
&lt;br /&gt;
== Сущности и топология ==&lt;br /&gt;
&lt;br /&gt;
Расширение создаёт следующие типы сущностей:&lt;br /&gt;
&lt;br /&gt;
* &#039;&#039;&#039;Collector Service&#039;&#039;&#039; — служба OpenTelemetry Collector, определяемая по &amp;lt;code&amp;gt;service_name&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &#039;&#039;&#039;Collector Instance&#039;&#039;&#039; — отдельный экземпляр службы, определяемый по сочетанию &amp;lt;code&amp;gt;service_name&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;service_instance_id&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Экземпляр Collector Instance связывается с соответствующей сущностью Collector Service отношением «дочерняя сущность».&lt;br /&gt;
&lt;br /&gt;
== Обзорная панель ==&lt;br /&gt;
&lt;br /&gt;
В состав расширения входит готовая обзорная панель. Она показывает обнаруженные службы и экземпляры OpenTelemetry Collector, а также ошибки отправки метрик и трассировок.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После активации конфигурации убедитесь, что:&lt;br /&gt;
&lt;br /&gt;
* конфигурация расширения имеет состояние без ошибок;&lt;br /&gt;
* с сервера EEC открывается указанный Prometheus endpoint;&lt;br /&gt;
* в ответе присутствуют метрики &amp;lt;code&amp;gt;otelcol_*&amp;lt;/code&amp;gt;;&lt;br /&gt;
* в Ключ-АСТРОМ появляются сущности Collector Service и Collector Instance;&lt;br /&gt;
* метрики отображаются на обзорной панели расширения.&lt;br /&gt;
&lt;br /&gt;
Если метрики поступают, но сущности не создаются, проверьте наличие измерений &amp;lt;code&amp;gt;service_name&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;service_instance_id&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
| 1.0.5&lt;br /&gt;
|&lt;br /&gt;
* Добавлен сбор внутренних метрик OpenTelemetry Collector через Prometheus endpoint.&lt;br /&gt;
* Добавлен контроль приёма, обработки и экспорта телеметрии.&lt;br /&gt;
* Добавлены метрики очередей, процессора, памяти и пакетной обработки.&lt;br /&gt;
* Добавлены сущности Collector Service и Collector Instance.&lt;br /&gt;
* Добавлена готовая обзорная панель.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6900</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6900"/>
		<updated>2026-09-25T19:55:23Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix]]&lt;br /&gt;
*[[Nutanix]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=Nutanix&amp;diff=6899</id>
		<title>Nutanix</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=Nutanix&amp;diff=6899"/>
		<updated>2026-09-25T19:54:57Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= Nutanix =  Расширение предназначено для удалённого мониторинга инфраструктуры Nutanix через API Prism Central. Оно собирает показатели кластеров, гипервизоров, виртуальных машин, дисков, сетей и контейнеров хранения, а также формирует связанные сущности в Ключ-АСТ...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Nutanix =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для удалённого мониторинга инфраструктуры Nutanix через API Prism Central. Оно собирает показатели кластеров, гипервизоров, виртуальных машин, дисков, сетей и контейнеров хранения, а также формирует связанные сущности в Ключ-АСТРОМ.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Значение&lt;br /&gt;
&lt;br /&gt;
|-&lt;br /&gt;
| Идентификатор&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.nutanix&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Источник данных&lt;br /&gt;
| Nutanix Prism Central API&lt;br /&gt;
|-&lt;br /&gt;
| Режим выполнения&lt;br /&gt;
| Удалённый, через АктивныйШлюз&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Возможности расширения ==&lt;br /&gt;
&lt;br /&gt;
* Мониторинг кластеров Nutanix.&lt;br /&gt;
* Контроль загрузки процессора и памяти гипервизоров.&lt;br /&gt;
* Мониторинг хостов и виртуальных машин.&lt;br /&gt;
* Сбор IOPS, пропускной способности и задержек.&lt;br /&gt;
* Контроль физических и виртуальных дисков.&lt;br /&gt;
* Мониторинг контейнеров хранения.&lt;br /&gt;
* Получение статистики сетей.&lt;br /&gt;
* Импорт оповещений и событий Nutanix.&lt;br /&gt;
* Преобразование категорий Nutanix в теги сущностей.&lt;br /&gt;
* Фильтрация кластеров, виртуальных машин и контейнеров хранения.&lt;br /&gt;
* Связывание виртуальных машин и гипервизоров с контролируемыми хостами.&lt;br /&gt;
* Готовая обзорная панель.&lt;br /&gt;
* Готовые шаблоны обнаружения аномалий.&lt;br /&gt;
&lt;br /&gt;
== Совместимость ==&lt;br /&gt;
&lt;br /&gt;
Версия &amp;lt;code&amp;gt;3.5.3&amp;lt;/code&amp;gt; использует API Prism Central версии 4.&lt;br /&gt;
&lt;br /&gt;
Рекомендуемая конфигурация:&lt;br /&gt;
&lt;br /&gt;
* Nutanix AOS &amp;lt;code&amp;gt;7.x&amp;lt;/code&amp;gt;;&lt;br /&gt;
* Prism Central &amp;lt;code&amp;gt;2023.4+&amp;lt;/code&amp;gt;;&lt;br /&gt;
* доступ к Prism Central API версии 4;&lt;br /&gt;
* HTTPS-порт Prism Central &amp;lt;code&amp;gt;9440&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Мониторинг через Prism Element API в версии расширения &amp;lt;code&amp;gt;3.x&amp;lt;/code&amp;gt; не поддерживается. Если среда не предоставляет API версии 4, необходимо использовать расширение Nutanix версии &amp;lt;code&amp;gt;2.x&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Одна конфигурация расширения поддерживает подключение только к одному Prism Central. Для нескольких экземпляров Prism Central создайте отдельные конфигурации.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
Для работы расширения необходимы:&lt;br /&gt;
&lt;br /&gt;
* АктивныйШлюз с включённым выполнением расширений.&lt;br /&gt;
* Сетевой доступ от АктивногоШлюза к Prism Central.&lt;br /&gt;
* Учётная запись Nutanix с ролью &amp;lt;code&amp;gt;Prism Viewer&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Доступ к API Prism Central версии 4.&lt;br /&gt;
* Разрешение HTTPS-соединений к порту &amp;lt;code&amp;gt;9440&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Вместо роли &amp;lt;code&amp;gt;Prism Viewer&amp;lt;/code&amp;gt; можно попробовать назначить следующие ограниченные роли:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;Cluster Viewer&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;Monitoring Viewer&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;Network Shared Resources Viewer&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;Storage Viewer&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;Virtual Machine Viewer&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Доступность всех данных при использовании ограниченных ролей зависит от версии Prism Central. Если часть API недоступна, используйте роль &amp;lt;code&amp;gt;Prism Viewer&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Откройте раздел управления расширениями Ключ-АСТРОМ.&lt;br /&gt;
# Загрузите подписанный пакет &amp;lt;code&amp;gt;ru.ruscomtech.extension.nutanix-3.5.3.zip&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Установите расширение.&lt;br /&gt;
# Добавьте конфигурацию мониторинга.&lt;br /&gt;
# Выберите группу АктивныхШлюзов.&lt;br /&gt;
# Настройте подключение к Prism Central.&lt;br /&gt;
# Выберите необходимые наборы метрик.&lt;br /&gt;
# Сохраните и включите конфигурацию.&lt;br /&gt;
&lt;br /&gt;
== Конфигурация подключения ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| URL&lt;br /&gt;
| Адрес Prism Central. Рекомендуемый формат: &amp;lt;code&amp;gt;prism-central.example.local:9440&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Use credential vault&lt;br /&gt;
| Использование учётных данных из хранилища секретов.&lt;br /&gt;
|-&lt;br /&gt;
| Select vault credentials&lt;br /&gt;
| Запись хранилища с именем пользователя и паролем.&lt;br /&gt;
|-&lt;br /&gt;
| User name&lt;br /&gt;
| Пользователь Prism Central с правами просмотра.&lt;br /&gt;
|-&lt;br /&gt;
| Password&lt;br /&gt;
| Пароль пользователя.&lt;br /&gt;
|-&lt;br /&gt;
| Proxy&lt;br /&gt;
| Необязательный прокси-сервер для подключения к Prism Central API.&lt;br /&gt;
|-&lt;br /&gt;
| Import Nutanix Alerts&lt;br /&gt;
| Импорт оповещений Nutanix.&lt;br /&gt;
|-&lt;br /&gt;
| Import Nutanix Events&lt;br /&gt;
| Импорт событий Nutanix.&lt;br /&gt;
|-&lt;br /&gt;
| Import Nutanix Categories as Entity Tags&lt;br /&gt;
| Добавление категорий Nutanix как тегов сущностей.&lt;br /&gt;
|-&lt;br /&gt;
| Access Token&lt;br /&gt;
| Токен Ключ-АСТРОМ, необходимый для импорта оповещений, событий и категорий.&lt;br /&gt;
|-&lt;br /&gt;
| Filter Mode&lt;br /&gt;
| Режим применения фильтров: &amp;lt;code&amp;gt;allow&amp;lt;/code&amp;gt; или &amp;lt;code&amp;gt;deny&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Cluster Filter&lt;br /&gt;
| Регулярные выражения для фильтрации кластеров.&lt;br /&gt;
|-&lt;br /&gt;
| VM Filter&lt;br /&gt;
| Регулярные выражения для фильтрации виртуальных машин.&lt;br /&gt;
|-&lt;br /&gt;
| Storage Container Filter&lt;br /&gt;
| Регулярные выражения для фильтрации контейнеров хранения.&lt;br /&gt;
|-&lt;br /&gt;
| Log level&lt;br /&gt;
| Уровень журналирования: &amp;lt;code&amp;gt;INFO&amp;lt;/code&amp;gt; или &amp;lt;code&amp;gt;DEBUG&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Frequency&lt;br /&gt;
| Интервал сбора в минутах. По умолчанию — одна минута.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Протокол в поле URL можно не указывать. Если порт отсутствует, расширение автоматически использует &amp;lt;code&amp;gt;9440&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Пример:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
prism-central.example.local:9440&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Версия &amp;lt;code&amp;gt;3.5.3&amp;lt;/code&amp;gt; не выполняет проверку сертификата Prism Central. Подключение должно выполняться только через доверенную внутреннюю сеть.&lt;br /&gt;
&lt;br /&gt;
== Настройка прокси ==&lt;br /&gt;
&lt;br /&gt;
Прокси требуется только в том случае, если АктивныйШлюз не может напрямую подключиться к Prism Central.&lt;br /&gt;
&lt;br /&gt;
Пример адреса:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://proxy.example.local:8080&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
При необходимости укажите имя пользователя и пароль прокси.&lt;br /&gt;
&lt;br /&gt;
== Импорт оповещений, событий и категорий ==&lt;br /&gt;
&lt;br /&gt;
Импорт является необязательным. Для сбора обычных метрик токен Ключ-АСТРОМ не требуется.&lt;br /&gt;
&lt;br /&gt;
Если необходимо импортировать оповещения, события или категории:&lt;br /&gt;
&lt;br /&gt;
# Включите REST-интерфейс АктивногоШлюза, установив &amp;lt;code&amp;gt;restInterface=true&amp;lt;/code&amp;gt; в файле &amp;lt;code&amp;gt;custom.properties&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Создайте токен доступа Ключ-АСТРОМ.&lt;br /&gt;
# Предоставьте токену права чтения сущностей и управления тегами сущностей.&lt;br /&gt;
# Укажите токен в поле &amp;lt;code&amp;gt;Access Token&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Включите необходимые параметры импорта.&lt;br /&gt;
&lt;br /&gt;
Оповещения и события передаются как записи журналов. На их основе расширение создаёт метрики количества событий для кластеров, хостов, виртуальных машин, дисков и контейнеров хранения.&lt;br /&gt;
&lt;br /&gt;
Категории Nutanix добавляются как теги соответствующих сущностей Ключ-АСТРОМ.&lt;br /&gt;
&lt;br /&gt;
== Фильтрация сущностей ==&lt;br /&gt;
&lt;br /&gt;
Фильтры принимают регулярные выражения. Можно настроить до десяти выражений для каждого типа сущности.&lt;br /&gt;
&lt;br /&gt;
Режим &amp;lt;code&amp;gt;allow&amp;lt;/code&amp;gt; включает сущности, имя которых соответствует хотя бы одному выражению.&lt;br /&gt;
&lt;br /&gt;
Режим &amp;lt;code&amp;gt;deny&amp;lt;/code&amp;gt; исключает сущности, имя которых соответствует хотя бы одному выражению.&lt;br /&gt;
&lt;br /&gt;
Пример выбора объектов, имена которых заканчиваются на &amp;lt;code&amp;gt;-test&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
^.*-test$&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Фильтр кластера также применяется к входящим в него сущностям. Фильтр виртуальных машин распространяется на их виртуальные диски, а фильтр контейнеров хранения — на связанные виртуальные диски.&lt;br /&gt;
&lt;br /&gt;
== Наборы метрик ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Область&lt;br /&gt;
! Наборы&lt;br /&gt;
|-&lt;br /&gt;
| Кластеры&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_cluster_stats&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;nutanix_cluster_controller&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;nutanix_cluster_io&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;nutanix_cluster_storage&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Хосты&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_host_stats&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;nutanix_host_controller&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;nutanix_host_io&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;nutanix_host_storage&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Виртуальные машины&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_vm_stats&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;nutanix_vm_hypervisor&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;nutanix_vm_controller_storage&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Физические диски&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_disk_stats&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;nutanix_disk_io&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;nutanix_disk_storage&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Контейнеры хранения&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_pool_stats&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;nutanix_pool_io&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;nutanix_pool_storage&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Сети&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_network_stats&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Виртуальные диски&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_virtual_disk_stats&amp;lt;/code&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
В крупных средах рекомендуется включать только необходимые наборы. Если сбор не укладывается в заданный интервал, увеличьте значение &amp;lt;code&amp;gt;Frequency&amp;lt;/code&amp;gt; или разделите объекты между несколькими конфигурациями с помощью фильтров.&lt;br /&gt;
&lt;br /&gt;
== Основные метрики ==&lt;br /&gt;
&lt;br /&gt;
=== Кластеры ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_cluster_cpu_hypervisor_usage_percent&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование процессора гипервизорами кластера.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_cluster_memory_hypervisor_usage_percent&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование памяти гипервизорами кластера.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_cluster_health_check_score&amp;lt;/code&amp;gt;&lt;br /&gt;
| Оценка состояния кластера по результатам NCC.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_cluster_controller_iops&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество операций ввода-вывода контроллера.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_cluster_controller_avg_io_latency&amp;lt;/code&amp;gt;&lt;br /&gt;
| Средняя задержка операций ввода-вывода.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_cluster_storage_capacity&amp;lt;/code&amp;gt;&lt;br /&gt;
| Общая ёмкость хранилища кластера.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_cluster_storage_free&amp;lt;/code&amp;gt;&lt;br /&gt;
| Свободное пространство кластера.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_cluster_storage_usage&amp;lt;/code&amp;gt;&lt;br /&gt;
| Используемое пространство кластера.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Хосты и виртуальные машины ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_host_cpu_usage_percent&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование процессора хоста.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_host_hypervisor_memory_usage_percent&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование памяти хоста.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_host_health_check_score&amp;lt;/code&amp;gt;&lt;br /&gt;
| Оценка состояния хоста.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_host_controller_storage_iops&amp;lt;/code&amp;gt;&lt;br /&gt;
| IOPS контроллера хранения хоста.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_vm_cpu_usage_percent&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование процессора виртуальной машиной.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_vm_memory_usage_percent&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование памяти виртуальной машиной.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_vm_hypervisor_cpu_ready_time_percent&amp;lt;/code&amp;gt;&lt;br /&gt;
| Время ожидания процессора гипервизора.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_vm_controller_storage_latency&amp;lt;/code&amp;gt;&lt;br /&gt;
| Задержка операций хранения виртуальной машины.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Хранилище и сети ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_disk_io_iops&amp;lt;/code&amp;gt;&lt;br /&gt;
| IOPS физического диска.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_disk_io_latency&amp;lt;/code&amp;gt;&lt;br /&gt;
| Задержка физического диска.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_disk_storage_free&amp;lt;/code&amp;gt;&lt;br /&gt;
| Свободное пространство физического диска.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_pool_storage_free_space_physical&amp;lt;/code&amp;gt;&lt;br /&gt;
| Свободное физическое пространство контейнера хранения.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_pool_io_controller_latency&amp;lt;/code&amp;gt;&lt;br /&gt;
| Задержка контроллера контейнера хранения.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_virtual_disk_usage&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование виртуального диска.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_network_free_ips&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество свободных IP-адресов сети.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix_network_assigned_ips&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество назначенных IP-адресов.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Значение показателя состояния NCC интерпретируется следующим образом:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Значение&lt;br /&gt;
! Состояние&lt;br /&gt;
|-&lt;br /&gt;
|100&lt;br /&gt;
|Норма&lt;br /&gt;
|-&lt;br /&gt;
|98&lt;br /&gt;
|Информация&lt;br /&gt;
|-&lt;br /&gt;
|74&lt;br /&gt;
|Предупреждение&lt;br /&gt;
|-&lt;br /&gt;
|24&lt;br /&gt;
|Критическое состояние&lt;br /&gt;
|-&lt;br /&gt;
|13&lt;br /&gt;
|Ошибка&lt;br /&gt;
|-&lt;br /&gt;
|-1&lt;br /&gt;
|Неизвестно&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Создаваемые сущности ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Тип&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix:cluster&amp;lt;/code&amp;gt;&lt;br /&gt;
| Кластер Nutanix.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix:host&amp;lt;/code&amp;gt;&lt;br /&gt;
| Хост гипервизора.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix:vm&amp;lt;/code&amp;gt;&lt;br /&gt;
| Виртуальная машина.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix:disk&amp;lt;/code&amp;gt;&lt;br /&gt;
| Физический диск.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix:virtual_disk&amp;lt;/code&amp;gt;&lt;br /&gt;
| Виртуальный диск.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix:storage_container&amp;lt;/code&amp;gt;&lt;br /&gt;
| Контейнер хранения.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix:network&amp;lt;/code&amp;gt;&lt;br /&gt;
| Сеть Nutanix.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;nutanix:project&amp;lt;/code&amp;gt;&lt;br /&gt;
| Проект Nutanix.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Расширение формирует связи между кластерами, хостами, виртуальными машинами, дисками, контейнерами хранения, сетями и проектами.&lt;br /&gt;
&lt;br /&gt;
Если внутри виртуальной машины установлен ЕдиныйАгент, сущность Nutanix VM связывается с контролируемым хостом по IP-адресу. Аналогичная связь создаётся для хоста гипервизора.&lt;br /&gt;
&lt;br /&gt;
== Шаблоны обнаружения аномалий ==&lt;br /&gt;
&lt;br /&gt;
Расширение содержит следующие шаблоны:&lt;br /&gt;
&lt;br /&gt;
* высокая загрузка процессора кластера;&lt;br /&gt;
* критическая загрузка процессора кластера;&lt;br /&gt;
* высокая загрузка памяти кластера;&lt;br /&gt;
* критическая загрузка памяти кластера;&lt;br /&gt;
* высокая загрузка процессора хоста;&lt;br /&gt;
* критическая загрузка процессора хоста.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
# Проверьте доступность &amp;lt;code&amp;gt;https://&amp;amp;lt;prism-central&amp;amp;gt;:9440&amp;lt;/code&amp;gt; с АктивногоШлюза.&lt;br /&gt;
# Убедитесь, что учётная запись может просматривать кластеры и виртуальные машины.&lt;br /&gt;
# Проверьте состояние конфигурации расширения.&lt;br /&gt;
# Откройте обзорную панель Nutanix.&lt;br /&gt;
# Проверьте появление сущностей кластера, хостов и виртуальных машин.&lt;br /&gt;
# Убедитесь, что поступают метрики с префиксом &amp;lt;code&amp;gt;nutanix_&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Устранение неполадок ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Проблема&lt;br /&gt;
! Решение&lt;br /&gt;
|-&lt;br /&gt;
| Ошибка подключения&lt;br /&gt;
| Проверьте адрес Prism Central, порт &amp;lt;code&amp;gt;9440&amp;lt;/code&amp;gt;, DNS и правила межсетевого экрана.&lt;br /&gt;
|-&lt;br /&gt;
| Ошибка аутентификации&lt;br /&gt;
| Проверьте имя пользователя, пароль и назначенные роли.&lt;br /&gt;
|-&lt;br /&gt;
| Часть объектов отсутствует&lt;br /&gt;
| Проверьте режим и регулярные выражения фильтрации.&lt;br /&gt;
|-&lt;br /&gt;
| Сбор не завершается за интервал&lt;br /&gt;
| Увеличьте &amp;lt;code&amp;gt;Frequency&amp;lt;/code&amp;gt;, сократите число наборов метрик или разделите объекты между конфигурациями.&lt;br /&gt;
|-&lt;br /&gt;
| Оповещения и события не импортируются&lt;br /&gt;
| Проверьте &amp;lt;code&amp;gt;restInterface=true&amp;lt;/code&amp;gt;, токен доступа и включённые параметры импорта.&lt;br /&gt;
|-&lt;br /&gt;
| Категории не преобразуются в теги&lt;br /&gt;
| Проверьте права токена на чтение сущностей и управление тегами.&lt;br /&gt;
|-&lt;br /&gt;
| Нет связи между VM и контролируемым хостом&lt;br /&gt;
| Проверьте наличие ЕдиныйАгента и совпадение IP-адресов.&lt;br /&gt;
|-&lt;br /&gt;
| Среда не поддерживает API версии 4&lt;br /&gt;
| Используйте расширение Nutanix версии &amp;lt;code&amp;gt;2.x&amp;lt;/code&amp;gt;.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|3.5.3&lt;br /&gt;
|&lt;br /&gt;
* Для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.313.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Улучшена производительность сбора метрик физических дисков, виртуальных машин и виртуальных дисков.&lt;br /&gt;
* Снижена вероятность пропусков данных и превышения времени сбора в крупных средах.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6898</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6898"/>
		<updated>2026-09-25T19:49:56Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Keycloak]]&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_Keycloak&amp;diff=6897</id>
		<title>Мониторинг Keycloak</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_Keycloak&amp;diff=6897"/>
		<updated>2026-09-25T19:49:10Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= Мониторинг Keycloak =  Расширение предназначено для мониторинга Keycloak через endpoint метрик Prometheus. Оно собирает показатели JVM, HTTP-сервера, пула подключений к базе данных, кэшей, транзакций, а также необязательные метрики аутентификации и работы с токенами.  {| clas...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Мониторинг Keycloak =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для мониторинга Keycloak через endpoint метрик Prometheus. Оно собирает показатели JVM, HTTP-сервера, пула подключений к базе данных, кэшей, транзакций, а также необязательные метрики аутентификации и работы с токенами.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Значение&lt;br /&gt;
|-&lt;br /&gt;
| Версия расширения&lt;br /&gt;
| &amp;lt;code&amp;gt;2.3.0&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Идентификатор&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus-keycloak&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Минимальная версия Ключ-АСТРОМ&lt;br /&gt;
| &amp;lt;code&amp;gt;1.309.0&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Минимальная версия EEC&lt;br /&gt;
| &amp;lt;code&amp;gt;1.253.0&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Источник данных&lt;br /&gt;
| Prometheus&lt;br /&gt;
|-&lt;br /&gt;
| Количество поддерживаемых метрик&lt;br /&gt;
| 297&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Возможности расширения ==&lt;br /&gt;
&lt;br /&gt;
* Мониторинг экземпляров Keycloak через Prometheus.&lt;br /&gt;
* Сбор показателей JVM, памяти, сборки мусора и потоков.&lt;br /&gt;
* Контроль HTTP-запросов и ошибок.&lt;br /&gt;
* Мониторинг Netty и рабочих пулов.&lt;br /&gt;
* Контроль пула подключений Agroal.&lt;br /&gt;
* Мониторинг Infinispan-кэшей и состояния кластера.&lt;br /&gt;
* Сбор статистики транзакций и блокировок.&lt;br /&gt;
* Контроль операций входа, регистрации и обновления токенов при использовании Aerogear SPI.&lt;br /&gt;
* Создание сущности экземпляра Keycloak.&lt;br /&gt;
* Связывание экземпляра с контролируемым Java-процессом.&lt;br /&gt;
* Готовая обзорная панель Keycloak.&lt;br /&gt;
&lt;br /&gt;
== Варианты сбора ==&lt;br /&gt;
&lt;br /&gt;
Расширение поддерживает локальный и удалённый сбор.&lt;br /&gt;
&lt;br /&gt;
=== Локальный сбор ===&lt;br /&gt;
&lt;br /&gt;
Расширение выполняется ЕдинымАгентом на сервере Keycloak. В качестве endpoint используется локальный адрес:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://localhost:9000/metrics&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для локального сбора на хосте должен быть включён EEC.&lt;br /&gt;
&lt;br /&gt;
=== Удалённый сбор ===&lt;br /&gt;
&lt;br /&gt;
Расширение выполняется на группе АктивныхШлюзов и подключается к Keycloak по сети:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://keycloak.example.local:9000/metrics&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
АктивномуШлюзу должны быть доступны адрес и порт интерфейса управления Keycloak.&lt;br /&gt;
&lt;br /&gt;
== Подготовка Keycloak ==&lt;br /&gt;
&lt;br /&gt;
=== Встроенные метрики ===&lt;br /&gt;
&lt;br /&gt;
В современных версиях Keycloak метрики включаются параметром запуска:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
bin/kc.sh start --metrics-enabled=true&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Или переменной окружения:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
KC_METRICS_ENABLED=true&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
После перезапуска Keycloak метрики должны быть доступны по адресу:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://&amp;amp;lt;host&amp;amp;gt;:9000/metrics&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Порт &amp;lt;code&amp;gt;9000&amp;lt;/code&amp;gt; используется интерфейсом управления по умолчанию. Если порт или относительный путь изменены в конфигурации Keycloak, укажите фактический адрес endpoint.&lt;br /&gt;
&lt;br /&gt;
Проверить доступность можно следующим запросом:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl http://localhost:9000/metrics&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Ответ должен содержать метрики в текстовом формате Prometheus.&lt;br /&gt;
&lt;br /&gt;
Не рекомендуется публиковать интерфейс управления Keycloak во внешней сети. Ограничьте доступ к нему сервером ЕдиныйАгента или АктивногоШлюза.&lt;br /&gt;
&lt;br /&gt;
=== Метрики Aerogear SPI ===&lt;br /&gt;
&lt;br /&gt;
Встроенного endpoint достаточно для мониторинга JVM, HTTP, Netty, Agroal, кэшей и системных показателей.&lt;br /&gt;
&lt;br /&gt;
Для получения расширенных метрик входов, регистраций, пользовательских событий и токенов необходимо отдельно установить Keycloak Metrics SPI от Aerogear.&lt;br /&gt;
&lt;br /&gt;
JAR-файл SPI размещается в каталоге:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
/opt/keycloak/providers/&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
После установки необходимо пересобрать или перезапустить Keycloak в соответствии со способом его установки.&lt;br /&gt;
&lt;br /&gt;
Endpoint Aerogear для дистрибутива Quarkus имеет следующий формат:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://keycloak.example.local:8080/realms/master/metrics&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Указанный endpoint возвращает метрики всех realm независимо от realm, содержащегося в URL.&lt;br /&gt;
&lt;br /&gt;
Для сбора пользовательских и административных событий добавьте обработчик &amp;lt;code&amp;gt;metrics-listener&amp;lt;/code&amp;gt; в настройках событий Keycloak:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
Manage → Events → Config → Event Listeners → metrics-listener&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aerogear SPI является необязательным. Без него основные встроенные метрики Keycloak продолжают собираться.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Откройте раздел управления расширениями Ключ-АСТРОМ.&lt;br /&gt;
# Загрузите подписанный пакет &amp;lt;code&amp;gt;ru.ruscomtech.extension.prometheus-keycloak-2.3.0.zip&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Установите расширение.&lt;br /&gt;
# Добавьте конфигурацию мониторинга.&lt;br /&gt;
# Выберите локальный запуск на ЕдинымАгенте или удалённый запуск на группе АктивныхШлюзов.&lt;br /&gt;
# Добавьте Prometheus endpoint.&lt;br /&gt;
# Выберите необходимые наборы метрик.&lt;br /&gt;
# Сохраните и включите конфигурацию.&lt;br /&gt;
&lt;br /&gt;
== Конфигурация endpoint ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Endpoint name&lt;br /&gt;
| Уникальное имя подключения.&lt;br /&gt;
|-&lt;br /&gt;
| URL&lt;br /&gt;
| Полный URL Prometheus endpoint, включая протокол, порт и путь.&lt;br /&gt;
|-&lt;br /&gt;
| Authentication&lt;br /&gt;
| Параметры аутентификации, если endpoint защищён.&lt;br /&gt;
|-&lt;br /&gt;
| SSL&lt;br /&gt;
| Проверка сертификата при использовании HTTPS.&lt;br /&gt;
|-&lt;br /&gt;
| Feature sets&lt;br /&gt;
| Наборы метрик, которые необходимо собирать.&lt;br /&gt;
|-&lt;br /&gt;
| Security context&lt;br /&gt;
| Необязательное значение контекста безопасности для создаваемой сущности.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Для встроенных метрик укажите:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://keycloak.example.local:9000/metrics&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Для необязательных метрик Aerogear добавьте отдельный endpoint:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
http://keycloak.example.local:8080/realms/master/metrics&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Если для разных endpoint создаются отдельные конфигурации, выбирайте только соответствующие им наборы метрик.&lt;br /&gt;
&lt;br /&gt;
== Наборы метрик ==&lt;br /&gt;
&lt;br /&gt;
=== Основные показатели Keycloak ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Наборы&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;JVM&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;System&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Memory pool&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Buffer pool&amp;lt;/code&amp;gt;&lt;br /&gt;
| JVM, процессор, память, потоки, сборка мусора и буферы.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;HTTP Server&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Netty&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Worker Pool&amp;lt;/code&amp;gt;&lt;br /&gt;
| HTTP-запросы, ошибки, сетевые буферы и рабочие потоки.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Agroal&amp;lt;/code&amp;gt;&lt;br /&gt;
| Пул подключений Keycloak к базе данных.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Transactions&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Lock manager&amp;lt;/code&amp;gt;&lt;br /&gt;
| Транзакции и внутренние блокировки.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Кэши и кластер ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Наборы&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Cache container stats&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Cache&amp;lt;/code&amp;gt;&lt;br /&gt;
| Состояние контейнеров кэша и количество кэшей.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Statistics&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Hit statistics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Попадания, промахи и эффективность кэша.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Evictions&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Passivations&amp;lt;/code&amp;gt;&lt;br /&gt;
| Вытеснение и пассивация записей.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Remove statistics&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Store statistics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Удаление и сохранение записей.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Local container&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование памяти локальным контейнером.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Aerogear SPI ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Наборы&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Aerogear - Requests&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Aerogear - Responses&amp;lt;/code&amp;gt;&lt;br /&gt;
| Продолжительность запросов, ответы и ошибки.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Aerogear - User actions&amp;lt;/code&amp;gt;&lt;br /&gt;
| Входы, неуспешные попытки, регистрации и события пользователей.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Aerogear - Token&amp;lt;/code&amp;gt;&lt;br /&gt;
| Выдача и обновление токенов и связанные ошибки.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Aerogear - Process&amp;lt;/code&amp;gt;&lt;br /&gt;
| Процессор, память и файловые дескрипторы процесса.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Aerogear - JVM GC&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Aerogear - JVM threads&amp;lt;/code&amp;gt;&lt;br /&gt;
| Сборка мусора и потоки JVM.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Aerogear - JVM memory&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Aerogear - JVM classes&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Aerogear - JVM buffer&amp;lt;/code&amp;gt;&lt;br /&gt;
| Память, классы и буферы JVM.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Не включайте наборы Aerogear, если соответствующий SPI не установлен: эти метрики не будут присутствовать на стандартном endpoint Keycloak.&lt;br /&gt;
&lt;br /&gt;
== Основные метрики ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;process_cpu_usage&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование процессора процессом Keycloak.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;jvm_memory_used_bytes&amp;lt;/code&amp;gt;&lt;br /&gt;
| Используемая память JVM.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;jvm_threads_live_threads&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество активных потоков JVM.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;jvm_gc_pause_seconds&amp;lt;/code&amp;gt;&lt;br /&gt;
| Продолжительность пауз сборщика мусора.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;http_server_active_requests&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество активных HTTP-запросов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;http_server_errors_total.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество ошибок HTTP-сервера.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;worker_pool_queue_size&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество задач, ожидающих выполнения.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;agroal_active&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество активных подключений к базе данных.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;agroal_available&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество доступных подключений.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;vendor_cluster_size&amp;lt;/code&amp;gt;&lt;br /&gt;
| Размер кластера Keycloak.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;vendor_statistics_hit_ratio&amp;lt;/code&amp;gt;&lt;br /&gt;
| Доля успешных обращений к кэшу.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;vendor_statistics_evictions&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество вытеснений из кэша.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;keycloak_logins.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество успешных входов через Aerogear SPI.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;keycloak_failed_login_attempts.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество неуспешных попыток входа.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;keycloak_refresh_tokens.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество успешных обновлений токена.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;keycloak_refresh_tokens_errors.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество ошибок обновления токена.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Полный пакет содержит 297 определений метрик. Фактический набор зависит от версии Keycloak, включённых функций и содержимого Prometheus endpoint.&lt;br /&gt;
&lt;br /&gt;
== Метки Prometheus ==&lt;br /&gt;
&lt;br /&gt;
Метки Prometheus автоматически преобразуются в измерения метрик Ключ-АСТРОМ.&lt;br /&gt;
&lt;br /&gt;
Перед включением Aerogear оцените количество возможных значений следующих меток:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;realm&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;client_id&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;provider&amp;lt;/code&amp;gt;;&lt;br /&gt;
* тип пользовательского события;&lt;br /&gt;
* имя кэша;&lt;br /&gt;
* состояние потока JVM.&lt;br /&gt;
&lt;br /&gt;
Большое количество realm, клиентов или событий может значительно увеличить количество временных рядов.&lt;br /&gt;
&lt;br /&gt;
== Создаваемые сущности ==&lt;br /&gt;
&lt;br /&gt;
Расширение создаёт сущность:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
prometheus:keycloak&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Имя сущности формируется из имени хоста или адреса endpoint. В свойства сущности добавляются сведения о JVM, IP-адрес, порт и контекст безопасности.&lt;br /&gt;
&lt;br /&gt;
Если адрес и порт совпадают с контролируемым Java-процессом, создаётся связь между экземпляром Keycloak и соответствующим экземпляром процесса.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
# Откройте URL endpoint из браузера или с помощью &amp;lt;code&amp;gt;curl&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Убедитесь, что ответ содержит метрики Prometheus.&lt;br /&gt;
# Проверьте состояние конфигурации расширения.&lt;br /&gt;
# Откройте обзорную панель Keycloak.&lt;br /&gt;
# Проверьте появление сущности &amp;lt;code&amp;gt;prometheus:keycloak&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Убедитесь, что выбранные метрики поступают в Ключ-АСТРОМ.&lt;br /&gt;
&lt;br /&gt;
== Устранение неполадок ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Проблема&lt;br /&gt;
! Решение&lt;br /&gt;
|-&lt;br /&gt;
| Endpoint возвращает &amp;lt;code&amp;gt;404&amp;lt;/code&amp;gt;&lt;br /&gt;
| Проверьте порт и путь. Встроенные метрики обычно доступны на порту управления по пути &amp;lt;code&amp;gt;/metrics&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Соединение отклонено&lt;br /&gt;
| Проверьте сетевой доступ, привязку интерфейса управления и правила межсетевого экрана.&lt;br /&gt;
|-&lt;br /&gt;
| Метрики отсутствуют&lt;br /&gt;
| Убедитесь, что Keycloak запущен с параметром &amp;lt;code&amp;gt;--metrics-enabled=true&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Не собираются входы и токены&lt;br /&gt;
| Установите Aerogear SPI, включите &amp;lt;code&amp;gt;metrics-listener&amp;lt;/code&amp;gt; и настройте endpoint &amp;lt;code&amp;gt;/realms/&amp;amp;lt;realm&amp;amp;gt;/metrics&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Собирается только часть метрик&lt;br /&gt;
| Проверьте выбранные наборы и наличие соответствующих метрик непосредственно в ответе endpoint.&lt;br /&gt;
|-&lt;br /&gt;
| Не создаётся связь с процессом&lt;br /&gt;
| Проверьте совпадение IP-адреса и порта сущности с контролируемым Java-процессом.&lt;br /&gt;
|-&lt;br /&gt;
| Создаётся слишком много временных рядов&lt;br /&gt;
| Ограничьте наборы метрик и количество высококардинальных меток.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|2.3.0&lt;br /&gt;
|&lt;br /&gt;
* Ключ-АСТРОМ &amp;lt;code&amp;gt;1.309.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Добавлен контекст безопасности для сущности экземпляра Keycloak.&lt;br /&gt;
* Добавлены страницы анализа для нового интерфейса мониторинга инфраструктуры.&lt;br /&gt;
* Добавлена готовая обзорная панель Keycloak.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6896</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6896"/>
		<updated>2026-09-25T19:44:20Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Apache ActiveMQ]]&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_Apache_ActiveMQ&amp;diff=6895</id>
		<title>Мониторинг Apache ActiveMQ</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_Apache_ActiveMQ&amp;diff=6895"/>
		<updated>2026-09-25T19:43:35Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= Мониторинг Apache ActiveMQ =  Расширение предназначено для мониторинга брокеров Apache ActiveMQ Classic через JMX. Оно собирает показатели брокеров, очередей и топиков непосредственно из Java-процесса, контролируемого ЕдинымАгентом.  Расширение предназначено для Apache Active...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Мониторинг Apache ActiveMQ =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для мониторинга брокеров Apache ActiveMQ Classic через JMX. Оно собирает показатели брокеров, очередей и топиков непосредственно из Java-процесса, контролируемого ЕдинымАгентом.&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для Apache ActiveMQ Classic. Apache ActiveMQ Artemis использует другую структуру MBean и данным расширением не поддерживается.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Значение&lt;br /&gt;
|-&lt;br /&gt;
| Версия расширения&lt;br /&gt;
| &amp;lt;code&amp;gt;1.2.0&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Идентификатор&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.jmx-activemq&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Минимальная версия Ключ-АСТРОМ&lt;br /&gt;
| &amp;lt;code&amp;gt;1.309.0&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Минимальная версия EEC&lt;br /&gt;
| &amp;lt;code&amp;gt;1.273.0&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Источник данных&lt;br /&gt;
| JMX&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Возможности расширения ==&lt;br /&gt;
&lt;br /&gt;
* Мониторинг брокеров Apache ActiveMQ Classic.&lt;br /&gt;
* Контроль очередей и топиков.&lt;br /&gt;
* Сбор количества поставленных, извлечённых, отправленных и просроченных сообщений.&lt;br /&gt;
* Контроль размера очередей и сообщений в обработке.&lt;br /&gt;
* Мониторинг подключений, производителей и потребителей.&lt;br /&gt;
* Контроль использования памяти, постоянного и временного хранилища.&lt;br /&gt;
* Получение состояния работоспособности брокера.&lt;br /&gt;
* Создание связанных сущностей брокеров, очередей и топиков.&lt;br /&gt;
* Связывание брокера с хостом и экземпляром Java-процесса.&lt;br /&gt;
* Готовые обзорные панели и страницы анализа сущностей.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
Для работы расширения необходимы:&lt;br /&gt;
&lt;br /&gt;
* ЕдиныйАгент на сервере, где запущен брокер ActiveMQ.&lt;br /&gt;
* Мониторинг Java-процесса брокера.&lt;br /&gt;
* Включённая функция &amp;lt;code&amp;gt;Java Metric Extensions 2.0 (JMX)&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Включённый JMX в конфигурации ActiveMQ.&lt;br /&gt;
* Ключ-АСТРОМ версии &amp;lt;code&amp;gt;1.309.0&amp;lt;/code&amp;gt; или новее.&lt;br /&gt;
&lt;br /&gt;
Для корректного изменения состояния метрики &amp;lt;code&amp;gt;activeMQ.BrokerHealthStatus&amp;lt;/code&amp;gt; рекомендуется использовать ЕдиныйАгент версии &amp;lt;code&amp;gt;1.313&amp;lt;/code&amp;gt; или новее. В более ранних версиях состояние этой метрики может не обновляться.&lt;br /&gt;
&lt;br /&gt;
Удалённый JMX endpoint, отдельный JMX-порт и учётные данные в конфигурации расширения не требуются: сбор выполняется внутри контролируемого Java-процесса.&lt;br /&gt;
&lt;br /&gt;
== Подготовка ActiveMQ ==&lt;br /&gt;
&lt;br /&gt;
Убедитесь, что в конфигурации брокера включён JMX:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;amp;lt;broker useJmx=&amp;quot;true&amp;quot; brokerName=&amp;quot;broker1&amp;quot;&amp;amp;gt;&lt;br /&gt;
    &amp;amp;lt;managementContext&amp;amp;gt;&lt;br /&gt;
        &amp;amp;lt;managementContext createConnector=&amp;quot;false&amp;quot;/&amp;amp;gt;&lt;br /&gt;
    &amp;amp;lt;/managementContext&amp;amp;gt;&lt;br /&gt;
&amp;amp;lt;/broker&amp;amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Параметр &amp;lt;code&amp;gt;brokerName&amp;lt;/code&amp;gt; должен содержать уникальное имя брокера.&lt;br /&gt;
&lt;br /&gt;
Значение &amp;lt;code&amp;gt;createConnector=&amp;quot;false&amp;quot;&amp;lt;/code&amp;gt; оставляет MBean в локальном сервере управления Java. Создавать удалённый JMX-коннектор для работы расширения не требуется.&lt;br /&gt;
&lt;br /&gt;
После изменения конфигурации перезапустите брокер.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Установите ЕдиныйАгент на сервер ActiveMQ.&lt;br /&gt;
# Убедитесь, что Java-процесс брокера обнаружен и контролируется.&lt;br /&gt;
# Включите функцию &amp;lt;code&amp;gt;Java Metric Extensions 2.0 (JMX)&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Откройте раздел управления расширениями Ключ-АСТРОМ.&lt;br /&gt;
# Загрузите подписанный пакет &amp;lt;code&amp;gt;ru.ruscomtech.extension.jmx-activemq-1.2.0.zip&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Установите и активируйте расширение.&lt;br /&gt;
# Выберите необходимые наборы метрик.&lt;br /&gt;
# Сохраните конфигурацию.&lt;br /&gt;
&lt;br /&gt;
Перезапуск брокера после установки самого расширения обычно не требуется.&lt;br /&gt;
&lt;br /&gt;
== Конфигурация ==&lt;br /&gt;
&lt;br /&gt;
Расширение не содержит endpoint с адресом и портом. После установки необходимо выбрать наборы метрик, которые должны собираться из контролируемых процессов ActiveMQ.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;usage-metrics&amp;lt;/code&amp;gt;&lt;br /&gt;
| Показатели очередей и топиков: размер очереди, сообщения, потребители и время обработки.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;broker-connections&amp;lt;/code&amp;gt;&lt;br /&gt;
| Подключения, производители и потребители брокера.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;broker-limits&amp;lt;/code&amp;gt;&lt;br /&gt;
| Использование памяти, постоянного и временного хранилища.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;broker-health&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущее состояние работоспособности брокера.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Для полного мониторинга рекомендуется включить все четыре набора.&lt;br /&gt;
&lt;br /&gt;
Расширение поддерживает как современный формат MBean:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
org.apache.activemq:type=Broker,brokerName=*&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
так и формат, используемый старыми версиями ActiveMQ Classic 5:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
org.apache.activemq:Type=Broker,BrokerName=*&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Собираемые метрики ==&lt;br /&gt;
&lt;br /&gt;
=== Очереди и топики ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.QueueSize&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущее количество сообщений в очереди.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.AverageEnqueueTime&amp;lt;/code&amp;gt;&lt;br /&gt;
| Среднее время нахождения сообщения в очереди.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.AverageEnqueueTimeIncrease.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Изменение среднего времени нахождения сообщения в очереди.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.EnqueueCount.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество сообщений, добавленных в очередь или топик.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.DequeueCount.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество извлечённых сообщений.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.DispatchCount.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество сообщений, отправленных потребителям.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.ExpiredCount.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество сообщений с истёкшим сроком действия.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.InFlightCount.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество отправленных, но ещё не подтверждённых сообщений.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.ConsumerCount&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущее количество потребителей очереди.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Подключения брокера ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.CurrentConnectionsCount&amp;lt;/code&amp;gt;&lt;br /&gt;
| Текущее количество активных подключений.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.TotalConnectionsCount&amp;lt;/code&amp;gt;&lt;br /&gt;
| Общее количество подключений к брокеру.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.TotalProducerCount&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество производителей сообщений.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.TotalConsumerCount&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество потребителей сообщений.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Использование ресурсов ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.MemoryPercentUsage&amp;lt;/code&amp;gt;&lt;br /&gt;
| Процент использования памяти брокером.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.StorePercentUsage&amp;lt;/code&amp;gt;&lt;br /&gt;
| Процент использования постоянного хранилища.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.TempPercentUsage&amp;lt;/code&amp;gt;&lt;br /&gt;
| Процент использования временного хранилища.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Состояние брокера ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activeMQ.BrokerHealthStatus&amp;lt;/code&amp;gt;&lt;br /&gt;
| Состояние работоспособности брокера. Значение метрики постоянно равно &amp;lt;code&amp;gt;1&amp;lt;/code&amp;gt;, а фактическое состояние передаётся в измерении &amp;lt;code&amp;gt;status&amp;lt;/code&amp;gt;.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Создаваемые сущности ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Тип&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activemq:broker&amp;lt;/code&amp;gt;&lt;br /&gt;
| Брокер Apache ActiveMQ.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activemq:queue&amp;lt;/code&amp;gt;&lt;br /&gt;
| Очередь брокера.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;activemq:topic&amp;lt;/code&amp;gt;&lt;br /&gt;
| Топик брокера.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Очереди и топики связываются с родительским брокером. Брокер связывается с соответствующим хостом и экземпляром Java-процесса.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После активации расширения:&lt;br /&gt;
&lt;br /&gt;
# Откройте контролируемый Java-процесс ActiveMQ.&lt;br /&gt;
# Проверьте состояние расширения JMX.&lt;br /&gt;
# Убедитесь, что доступны MBean домена &amp;lt;code&amp;gt;org.apache.activemq&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Откройте обзорную панель Apache ActiveMQ.&lt;br /&gt;
# Проверьте появление сущностей брокера, очередей и топиков.&lt;br /&gt;
# Убедитесь, что поступают метрики с префиксом &amp;lt;code&amp;gt;activeMQ.&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Устранение неполадок ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Проблема&lt;br /&gt;
! Решение&lt;br /&gt;
|-&lt;br /&gt;
| Брокер не обнаружен&lt;br /&gt;
| Проверьте установку ЕдиныйАгента и мониторинг Java-процесса брокера.&lt;br /&gt;
|-&lt;br /&gt;
| Метрики JMX отсутствуют&lt;br /&gt;
| Убедитесь, что включена функция &amp;lt;code&amp;gt;Java Metric Extensions 2.0 (JMX)&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| MBean ActiveMQ отсутствуют&lt;br /&gt;
| Проверьте параметр &amp;lt;code&amp;gt;useJmx=&amp;quot;true&amp;quot;&amp;lt;/code&amp;gt; и перезапустите брокер.&lt;br /&gt;
|-&lt;br /&gt;
| Собирается только часть метрик&lt;br /&gt;
| Проверьте, что в конфигурации включены необходимые наборы метрик.&lt;br /&gt;
|-&lt;br /&gt;
| Не создаются очереди или топики&lt;br /&gt;
| Проверьте наличие MBean с параметрами &amp;lt;code&amp;gt;destinationType&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;destinationName&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Состояние брокера не изменяется&lt;br /&gt;
| Обновите ЕдиныйАгент до версии &amp;lt;code&amp;gt;1.313&amp;lt;/code&amp;gt; или новее.&lt;br /&gt;
|-&lt;br /&gt;
| Не отображаются отдельные временные очереди&lt;br /&gt;
| Проверьте, что ActiveMQ не исключает их MBean с помощью параметра &amp;lt;code&amp;gt;suppressMBean&amp;lt;/code&amp;gt;.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|1.2.0&lt;br /&gt;
|&lt;br /&gt;
* Ключ-АСТРОМ &amp;lt;code&amp;gt;1.309.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Добавлен атрибут контекста безопасности для создаваемых сущностей.&lt;br /&gt;
* Добавлена обзорная панель для приложения работы с панелями.&lt;br /&gt;
* Обновлены страницы анализа брокеров, очередей и топиков.&lt;br /&gt;
* Добавлена поддержка представления сущностей и метрик в новом интерфейсе платформы.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6894</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6894"/>
		<updated>2026-09-25T19:39:12Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг IBM Informix]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_IBM_Informix&amp;diff=6893</id>
		<title>Мониторинг IBM Informix</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_IBM_Informix&amp;diff=6893"/>
		<updated>2026-09-25T19:38:29Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= Мониторинг IBM Informix =  Расширение предназначено для удалённого мониторинга экземпляров IBM Informix через JDBC. Оно выполняет запросы к системной базе данных &amp;lt;code&amp;gt;sysmaster&amp;lt;/code&amp;gt;, собирает показатели производительности и создаёт связанные сущности экземпляров, баз д...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Мониторинг IBM Informix =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для удалённого мониторинга экземпляров IBM Informix через JDBC. Оно выполняет запросы к системной базе данных &amp;lt;code&amp;gt;sysmaster&amp;lt;/code&amp;gt;, собирает показатели производительности и создаёт связанные сущности экземпляров, баз данных и dbspace в Ключ-АСТРОМ.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Значение&lt;br /&gt;
|-&lt;br /&gt;
| Идентификатор&lt;br /&gt;
| &amp;lt;code&amp;gt;ru.ruscomtech.extension.sql-informix&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Минимальная версия Ключ-АСТРОМ&lt;br /&gt;
| &amp;lt;code&amp;gt;1.310&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Поддерживаемая версия Informix&lt;br /&gt;
| &amp;lt;code&amp;gt;14.10+&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Версия JDBC-драйвера&lt;br /&gt;
| &amp;lt;code&amp;gt;4.5.x+&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Источник данных&lt;br /&gt;
| JDBC&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Возможности расширения ==&lt;br /&gt;
&lt;br /&gt;
* Удалённый сбор метрик без установки агента на сервер Informix.&lt;br /&gt;
* Мониторинг загрузки процессора и эффективности буферного кэша.&lt;br /&gt;
* Контроль последовательных сканирований и контрольных точек.&lt;br /&gt;
* Мониторинг разделяемой памяти экземпляра.&lt;br /&gt;
* Контроль ожиданий блокировок и превышения системных ограничений.&lt;br /&gt;
* Сбор количества подключений и блокировок по базам данных.&lt;br /&gt;
* Контроль свободного пространства и операций ввода-вывода по dbspace.&lt;br /&gt;
* Сбор статистики наиболее активно сканируемых таблиц.&lt;br /&gt;
* Создание сущностей экземпляров, баз данных и dbspace.&lt;br /&gt;
* Готовые обзорные панели IBM Informix.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
Для работы расширения необходимы:&lt;br /&gt;
&lt;br /&gt;
* АктивныйШлюз с поддержкой выполнения расширений.&lt;br /&gt;
* Сетевой доступ от АктивногоШлюза к серверу Informix.&lt;br /&gt;
* IBM Informix JDBC Driver версии &amp;lt;code&amp;gt;4.5.x&amp;lt;/code&amp;gt; или новее.&lt;br /&gt;
* Отдельная учётная запись Informix с правами только на чтение системных представлений.&lt;br /&gt;
* Доступ к системной базе данных &amp;lt;code&amp;gt;sysmaster&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Расширение не содержит JDBC-драйвер. Файл драйвера необходимо разместить в каталоге:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
remotepluginmodule/agent/conf/userdata/libs&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Драйвер должен быть установлен на каждом АктивномШлюзе, который может выполнять конфигурацию расширения. Учётная запись службы АктивногоШлюза должна иметь право чтения файла. После установки драйвера перезапустите службу АктивногоШлюза.&lt;br /&gt;
&lt;br /&gt;
== Права учётной записи ==&lt;br /&gt;
&lt;br /&gt;
Рекомендуется использовать отдельную учётную запись мониторинга без прав на изменение данных.&lt;br /&gt;
&lt;br /&gt;
Учётной записи необходимо предоставить право подключения к базе &amp;lt;code&amp;gt;sysmaster&amp;lt;/code&amp;gt; и чтения следующих системных представлений:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
syslocks&lt;br /&gt;
syssessions&lt;br /&gt;
sysdatabases&lt;br /&gt;
sysprofile&lt;br /&gt;
sysseglst&lt;br /&gt;
sysvpprof&lt;br /&gt;
sysdbspaces&lt;br /&gt;
syschunks&lt;br /&gt;
sysshmvals&lt;br /&gt;
syschktab&lt;br /&gt;
sysmchktab&lt;br /&gt;
sysdbstab&lt;br /&gt;
sysptprof&lt;br /&gt;
systabinfo&lt;br /&gt;
systables&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Способ создания пользователя и выдачи прав зависит от используемой схемы аутентификации Informix. Административные права для работы расширения не требуются.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Откройте раздел управления расширениями Ключ-АСТРОМ.&lt;br /&gt;
# Загрузите подписанный пакет &amp;lt;code&amp;gt;ru.ruscomtech.extension.sql-informix-2.0.1.zip&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Установите расширение.&lt;br /&gt;
# Откройте установленное расширение и выберите добавление конфигурации мониторинга.&lt;br /&gt;
# Выберите группу АктивныхШлюзов, с которой доступен сервер Informix.&lt;br /&gt;
# Добавьте endpoint для каждого контролируемого экземпляра.&lt;br /&gt;
# Сохраните и включите конфигурацию.&lt;br /&gt;
&lt;br /&gt;
== Конфигурация ==&lt;br /&gt;
&lt;br /&gt;
Для endpoint необходимо указать следующие параметры:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| Имя endpoint&lt;br /&gt;
| Произвольное уникальное имя подключения.&lt;br /&gt;
|-&lt;br /&gt;
| Host&lt;br /&gt;
| DNS-имя или IP-адрес сервера Informix.&lt;br /&gt;
|-&lt;br /&gt;
| Port&lt;br /&gt;
| Порт службы Informix.&lt;br /&gt;
|-&lt;br /&gt;
| Connection string&lt;br /&gt;
| JDBC-строка подключения к базе &amp;lt;code&amp;gt;sysmaster&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Username&lt;br /&gt;
| Пользователь с правами чтения системных представлений.&lt;br /&gt;
|-&lt;br /&gt;
| Password&lt;br /&gt;
| Пароль пользователя либо ссылка на учётные данные из хранилища секретов.&lt;br /&gt;
|-&lt;br /&gt;
| SSL&lt;br /&gt;
| Включается, если сервер Informix настроен на защищённое JDBC-подключение.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Адрес и порт необходимо заполнить отдельно, даже если они уже присутствуют в JDBC-строке.&lt;br /&gt;
&lt;br /&gt;
=== Строка подключения ===&lt;br /&gt;
&lt;br /&gt;
Строка подключения должна начинаться с &amp;lt;code&amp;gt;jdbc:informix-sqli://&amp;lt;/code&amp;gt; и вести к базе &amp;lt;code&amp;gt;sysmaster&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
jdbc:informix-sqli://informix.example.local:9088/sysmaster:INFORMIXSERVER=ol_informix1410&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Где:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;informix.example.local&amp;lt;/code&amp;gt; — адрес сервера Informix;&lt;br /&gt;
* &amp;lt;code&amp;gt;9088&amp;lt;/code&amp;gt; — порт Informix;&lt;br /&gt;
* &amp;lt;code&amp;gt;sysmaster&amp;lt;/code&amp;gt; — системная база данных, из которой собираются показатели;&lt;br /&gt;
* &amp;lt;code&amp;gt;ol_informix1410&amp;lt;/code&amp;gt; — значение параметра &amp;lt;code&amp;gt;INFORMIXSERVER&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Имя пользователя и пароль рекомендуется указывать в отдельных полях конфигурации, а не включать в JDBC-строку.&lt;br /&gt;
&lt;br /&gt;
В версии &amp;lt;code&amp;gt;2.0.1&amp;lt;/code&amp;gt; отдельная настройка интервала отсутствует. Запросы выполняются штатным циклом источника данных SQL, обычно один раз в минуту.&lt;br /&gt;
&lt;br /&gt;
== Собираемые данные ==&lt;br /&gt;
&lt;br /&gt;
=== Экземпляр Informix ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.cpu_user.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Процессорное время в пользовательском режиме.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.cpu_system.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Процессорное время в системном режиме.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.buffer_cache_hit_ratio_read&amp;lt;/code&amp;gt;&lt;br /&gt;
| Доля операций чтения, обслуженных из буферного кэша.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.buffer_cache_hit_ratio_write&amp;lt;/code&amp;gt;&lt;br /&gt;
| Доля операций записи, обслуженных через буферный кэш.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.scan.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество последовательных сканирований.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.checkpoint.count&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество выполненных контрольных точек.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.count_segments&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество сегментов разделяемой памяти.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.segment_size&amp;lt;/code&amp;gt;&lt;br /&gt;
| Размер сегментов разделяемой памяти.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.segment_blocks_used&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество используемых блоков разделяемой памяти.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.segment_blocks_free&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество свободных блоков разделяемой памяти.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.ovuser&amp;lt;/code&amp;gt;&lt;br /&gt;
| Попытки превышения максимального количества сеансов.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.ovlock&amp;lt;/code&amp;gt;&lt;br /&gt;
| Попытки превышения максимального количества блокировок.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.ovtrans&amp;lt;/code&amp;gt;&lt;br /&gt;
| Попытки превышения максимального количества транзакций.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.lockwts&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество ожиданий блокировок.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.instance.lruwrites&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество операций записи LRU.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Базы данных ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.database.sessions&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество активных сеансов базы данных.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.database.locks&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество блокировок базы данных.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.database.table_pages_used&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество страниц, используемых таблицей.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.database.table_scans&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество сканирований таблицы.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Статистика таблиц собирается для десяти наиболее активно сканируемых таблиц. Системные базы данных и системные таблицы из этой выборки исключаются.&lt;br /&gt;
&lt;br /&gt;
=== Dbspace ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.dbspace.percent_free&amp;lt;/code&amp;gt;&lt;br /&gt;
| Доля свободного пространства в dbspace.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.dbspace.chunks_read&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество операций чтения из chunk.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.dbspace.chunks_written&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество операций записи в chunk.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.dbspace.chunk_pages_read&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество прочитанных страниц chunk.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix.dbspace.chunk_pages_written&amp;lt;/code&amp;gt;&lt;br /&gt;
| Количество записанных страниц chunk.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Создаваемые сущности ==&lt;br /&gt;
&lt;br /&gt;
Расширение создаёт следующие типы сущностей:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Тип&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix:instance&amp;lt;/code&amp;gt;&lt;br /&gt;
| Экземпляр сервера Informix.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix:database&amp;lt;/code&amp;gt;&lt;br /&gt;
| База данных экземпляра.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;informix:dbspace&amp;lt;/code&amp;gt;&lt;br /&gt;
| Пространство хранения Informix.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Базы данных и dbspace связываются с соответствующим экземпляром Informix. Если в Ключ-АСТРОМ обнаружен хост с совпадающим IP-адресом, экземпляр также связывается с этим хостом.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После сохранения конфигурации:&lt;br /&gt;
&lt;br /&gt;
# Проверьте состояние конфигурации расширения.&lt;br /&gt;
# Убедитесь, что проверочный запрос &amp;lt;code&amp;gt;SELECT 1&amp;lt;/code&amp;gt; выполняется успешно.&lt;br /&gt;
# Откройте обзорную панель IBM Informix.&lt;br /&gt;
# Проверьте появление сущностей экземпляра, баз данных и dbspace.&lt;br /&gt;
# Убедитесь, что метрики с префиксом &amp;lt;code&amp;gt;informix.&amp;lt;/code&amp;gt; поступают в Ключ-АСТРОМ.&lt;br /&gt;
&lt;br /&gt;
== Устранение неполадок ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Ошибка&lt;br /&gt;
! Возможная причина и решение&lt;br /&gt;
|-&lt;br /&gt;
| JDBC-драйвер не найден&lt;br /&gt;
| Проверьте размещение JAR-файла, права на чтение и перезапустите службу АктивногоШлюза.&lt;br /&gt;
|-&lt;br /&gt;
| Строка подключения отклонена&lt;br /&gt;
| Убедитесь, что она начинается с &amp;lt;code&amp;gt;jdbc:informix-sqli://&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| Ошибка аутентификации&lt;br /&gt;
| Проверьте имя пользователя, пароль и способ аутентификации Informix.&lt;br /&gt;
|-&lt;br /&gt;
| Недостаточно прав&lt;br /&gt;
| Предоставьте пользователю доступ к &amp;lt;code&amp;gt;sysmaster&amp;lt;/code&amp;gt; и право чтения необходимых системных представлений.&lt;br /&gt;
|-&lt;br /&gt;
| Подключение работает, но метрики отсутствуют&lt;br /&gt;
| Проверьте, что JDBC-строка ведёт к базе &amp;lt;code&amp;gt;sysmaster&amp;lt;/code&amp;gt; и системные представления возвращают данные.&lt;br /&gt;
|-&lt;br /&gt;
| Не создаётся связь с хостом&lt;br /&gt;
| Проверьте наличие контролируемого хоста с IP-адресом, совпадающим с адресом endpoint.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== История изменений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|2.0.1&lt;br /&gt;
|&lt;br /&gt;
* Начало поддержки удалённого мониторинга IBM Informix.&lt;br /&gt;
* Адаптировано для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.310+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Добавлен сбор показателей экземпляров, баз данных, таблиц и dbspace.&lt;br /&gt;
* Добавлены сущности экземпляра, базы данных и dbspace и связи между ними.&lt;br /&gt;
* Добавлены готовые обзорные панели IBM Informix.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6892</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6892"/>
		<updated>2026-09-25T18:46:11Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6891</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6891"/>
		<updated>2026-09-25T18:45:00Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг устройств Cisco по SNMP]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг Microsoft Active Directory|Microsoft Active Directory]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2_Cisco_%D0%BF%D0%BE_SNMP&amp;diff=6890</id>
		<title>Мониторинг устройств Cisco по SNMP</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2_Cisco_%D0%BF%D0%BE_SNMP&amp;diff=6890"/>
		<updated>2026-09-25T18:44:29Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: « == Возможности расширения ==  Расширение предназначено для удалённого мониторинга сетевых устройств Cisco по протоколу SNMP.  &amp;#039;&amp;#039;&amp;#039;Идентификатор расширения:&amp;#039;&amp;#039;&amp;#039; &amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device&amp;lt;/code&amp;gt;  &amp;#039;&amp;#039;&amp;#039;Версия расширения:&amp;#039;&amp;#039;&amp;#039; &amp;lt;code&amp;gt;3.2.7&amp;lt;/code&amp;gt;  &amp;#039;&amp;#039;&amp;#039;Минимальная версия Ключ-АСТРОМ...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
== Возможности расширения ==&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для удалённого мониторинга сетевых устройств Cisco по протоколу SNMP.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Идентификатор расширения:&#039;&#039;&#039; &amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Версия расширения:&#039;&#039;&#039; &amp;lt;code&amp;gt;3.2.7&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Минимальная версия Ключ-АСТРОМ:&#039;&#039;&#039; &amp;lt;code&amp;gt;1.310.0&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Минимальная версия контроллера выполнения расширений:&#039;&#039;&#039; &amp;lt;code&amp;gt;1.307.0&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Расширение позволяет контролировать:&lt;br /&gt;
&lt;br /&gt;
* загрузку процессора и использование памяти;&lt;br /&gt;
* время работы устройства после перезапуска;&lt;br /&gt;
* состояние и загрузку сетевых интерфейсов;&lt;br /&gt;
* входящий и исходящий трафик;&lt;br /&gt;
* ошибки, отброшенные пакеты и ошибки CRC;&lt;br /&gt;
* использование полосы пропускания;&lt;br /&gt;
* состояние вентиляторов, датчиков и блоков питания;&lt;br /&gt;
* пулы памяти;&lt;br /&gt;
* состояние активного и резервного супервизоров;&lt;br /&gt;
* статистику TCP и UDP;&lt;br /&gt;
* состояние SNMP;&lt;br /&gt;
* соседние устройства, обнаруженные через LLDP;&lt;br /&gt;
* соседей и состояние протоколов BGP, OSPF и EIGRP;&lt;br /&gt;
* физические заменяемые компоненты устройства.&lt;br /&gt;
&lt;br /&gt;
Расширение также добавляет:&lt;br /&gt;
&lt;br /&gt;
* обзорную панель устройств Cisco;&lt;br /&gt;
* отдельные сущности сетевых устройств и интерфейсов;&lt;br /&gt;
* топологические связи между устройствами, интерфейсами и соседями;&lt;br /&gt;
* шаблоны оповещений о высокой загрузке входящей и исходящей полосы пропускания.&lt;br /&gt;
&lt;br /&gt;
== Поддерживаемые устройства ==&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для устройств Cisco, которые:&lt;br /&gt;
&lt;br /&gt;
* доступны по SNMP;&lt;br /&gt;
* поддерживают необходимые стандартные и Cisco MIB;&lt;br /&gt;
* возвращают используемые расширением OID.&lt;br /&gt;
&lt;br /&gt;
Набор доступных метрик зависит от модели устройства, версии программного обеспечения и поддерживаемых MIB. Если устройство не поддерживает определённый MIB, соответствующий набор функций следует отключить.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
Для работы расширения необходимы:&lt;br /&gt;
&lt;br /&gt;
* Ключ-АСТРОМ версии &amp;lt;code&amp;gt;1.310.0&amp;lt;/code&amp;gt; или новее;&lt;br /&gt;
* контроллер выполнения расширений версии &amp;lt;code&amp;gt;1.307.0&amp;lt;/code&amp;gt; или новее;&lt;br /&gt;
* шлюз, с которого доступны контролируемые устройства;&lt;br /&gt;
* разрешённый SNMP на устройствах Cisco;&lt;br /&gt;
* сетевой доступ от шлюза к UDP-порту &amp;lt;code&amp;gt;161&amp;lt;/code&amp;gt;;&lt;br /&gt;
* учётные данные SNMP с правами чтения.&lt;br /&gt;
&lt;br /&gt;
Поддерживаются:&lt;br /&gt;
&lt;br /&gt;
* SNMP v2c;&lt;br /&gt;
* SNMP v3.&lt;br /&gt;
&lt;br /&gt;
В целях безопасности рекомендуется использовать SNMP v3 с аутентификацией и шифрованием.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Откройте раздел управления расширениями в Ключ-АСТРОМ.&lt;br /&gt;
# Загрузите пакет &amp;lt;code&amp;gt;cisco 3.2.7.zip&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Убедитесь, что расширение &amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device&amp;lt;/code&amp;gt; успешно установлено.&lt;br /&gt;
# Создайте конфигурацию мониторинга.&lt;br /&gt;
# Выберите группу шлюзов, с которой доступны устройства Cisco.&lt;br /&gt;
# Добавьте устройства и параметры подключения SNMP.&lt;br /&gt;
# Выберите необходимые наборы функций.&lt;br /&gt;
# Настройте фильтры интерфейсов.&lt;br /&gt;
# Сохраните и включите конфигурацию.&lt;br /&gt;
&lt;br /&gt;
В одну конфигурацию можно добавить несколько устройств с одинаковыми параметрами мониторинга.&lt;br /&gt;
&lt;br /&gt;
== Настройка подключения ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
|Имя конфигурации&lt;br /&gt;
|Произвольное понятное имя конфигурации мониторинга.&lt;br /&gt;
|-&lt;br /&gt;
|Группа шлюзов&lt;br /&gt;
|Группа шлюзов, выполняющая SNMP-запросы.&lt;br /&gt;
|-&lt;br /&gt;
|Адрес устройства&lt;br /&gt;
|IP-адрес или DNS-имя устройства Cisco.&lt;br /&gt;
|-&lt;br /&gt;
|Порт&lt;br /&gt;
|Порт SNMP. По умолчанию используется UDP &amp;lt;code&amp;gt;161&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|Версия SNMP&lt;br /&gt;
|Версия протокола: SNMP v2c или SNMP v3.&lt;br /&gt;
|-&lt;br /&gt;
|Community&lt;br /&gt;
|Строка сообщества для SNMP v2c.&lt;br /&gt;
|-&lt;br /&gt;
|Имя пользователя&lt;br /&gt;
|Имя пользователя SNMP v3.&lt;br /&gt;
|-&lt;br /&gt;
|Уровень безопасности&lt;br /&gt;
|Для SNMP v3 поддерживаются &amp;lt;code&amp;gt;NoAuthNoPriv&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;authNoPriv&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;authPriv&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|Протокол аутентификации&lt;br /&gt;
|Алгоритм аутентификации SNMP v3, например SHA или SHA256.&lt;br /&gt;
|-&lt;br /&gt;
|Пароль аутентификации&lt;br /&gt;
|Пароль пользователя SNMP v3.&lt;br /&gt;
|-&lt;br /&gt;
|Протокол шифрования&lt;br /&gt;
|Алгоритм шифрования SNMP v3, например AES.&lt;br /&gt;
|-&lt;br /&gt;
|Пароль шифрования&lt;br /&gt;
|Пароль конфиденциальности SNMP v3.&lt;br /&gt;
|-&lt;br /&gt;
|Наборы функций&lt;br /&gt;
|Группы метрик, которые необходимо получать с устройства.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Дополнительные параметры ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
|Extension activation tag&lt;br /&gt;
|Тег, добавляемый к данным и сущностям конфигурации.&lt;br /&gt;
|-&lt;br /&gt;
|Pattern to filter capturing of Interfaces by Name&lt;br /&gt;
|Фильтр интерфейсов по имени.&lt;br /&gt;
|-&lt;br /&gt;
|Pattern to filter capturing of Interfaces by Admin Status&lt;br /&gt;
|Фильтр по административному состоянию интерфейса.&lt;br /&gt;
|-&lt;br /&gt;
|Pattern to filter capturing of Interfaces by Operational Status&lt;br /&gt;
|Фильтр по фактическому состоянию интерфейса.&lt;br /&gt;
|-&lt;br /&gt;
|Pattern to filter capturing of Interfaces by Alias&lt;br /&gt;
|Фильтр интерфейсов по значению Alias.&lt;br /&gt;
|-&lt;br /&gt;
|Pattern to filter capturing of Interfaces by Type&lt;br /&gt;
|Фильтр по типу интерфейса.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Если фильтры не указаны, расширение может собирать показатели всех интерфейсов устройства. На устройствах с большим количеством интерфейсов рекомендуется ограничивать сбор.&lt;br /&gt;
&lt;br /&gt;
Чтобы полностью исключить интерфейсы из сбора, можно указать в фильтре интерфейсов:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
$eq(!)&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Значения административного состояния интерфейса:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Значение&lt;br /&gt;
! Состояние&lt;br /&gt;
|-&lt;br /&gt;
|1&lt;br /&gt;
|Up&lt;br /&gt;
|-&lt;br /&gt;
|2&lt;br /&gt;
|Down&lt;br /&gt;
|-&lt;br /&gt;
|3&lt;br /&gt;
|Testing&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Значения рабочего состояния интерфейса:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Значение&lt;br /&gt;
! Состояние&lt;br /&gt;
|-&lt;br /&gt;
|1&lt;br /&gt;
|Up&lt;br /&gt;
|-&lt;br /&gt;
|2&lt;br /&gt;
|Down&lt;br /&gt;
|-&lt;br /&gt;
|3&lt;br /&gt;
|Testing&lt;br /&gt;
|-&lt;br /&gt;
|4&lt;br /&gt;
|Unknown&lt;br /&gt;
|-&lt;br /&gt;
|5&lt;br /&gt;
|Dormant&lt;br /&gt;
|-&lt;br /&gt;
|6&lt;br /&gt;
|Not present&lt;br /&gt;
|-&lt;br /&gt;
|7&lt;br /&gt;
|Lower layer down&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Наборы функций ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
|Default&lt;br /&gt;
|Основные сведения об устройстве, время работы, процессор и память.&lt;br /&gt;
|-&lt;br /&gt;
|Control Plane&lt;br /&gt;
|Загрузка процессора и память управляющей плоскости.&lt;br /&gt;
|-&lt;br /&gt;
|Interfaces&lt;br /&gt;
|Состояние, скорость, ошибки и отброшенные пакеты интерфейсов.&lt;br /&gt;
|-&lt;br /&gt;
|Interfaces 32-bit&lt;br /&gt;
|Счётчики трафика с разрядностью 32 бита.&lt;br /&gt;
|-&lt;br /&gt;
|Interfaces 64-bit&lt;br /&gt;
|Высокоразрядные счётчики трафика для скоростных интерфейсов.&lt;br /&gt;
|-&lt;br /&gt;
|Memory pools&lt;br /&gt;
|Использование 32- и 64-разрядных пулов памяти.&lt;br /&gt;
|-&lt;br /&gt;
|High availability&lt;br /&gt;
|Состояние активного супервизора и синхронизации.&lt;br /&gt;
|-&lt;br /&gt;
|Sensors&lt;br /&gt;
|Температура и состояние вентиляторов.&lt;br /&gt;
|-&lt;br /&gt;
|Sensors (Advanced)&lt;br /&gt;
|Дополнительные физические датчики устройства.&lt;br /&gt;
|-&lt;br /&gt;
|Power supply&lt;br /&gt;
|Состояние блоков питания.&lt;br /&gt;
|-&lt;br /&gt;
|FRUs&lt;br /&gt;
|Состояние заменяемых блоков питания и вентиляторных модулей.&lt;br /&gt;
|-&lt;br /&gt;
|Health&lt;br /&gt;
|Ошибки и состояние подсистемы SNMP.&lt;br /&gt;
|-&lt;br /&gt;
|Traffic&lt;br /&gt;
|Статистика TCP- и UDP-трафика.&lt;br /&gt;
|-&lt;br /&gt;
|Neighbor discovery&lt;br /&gt;
|Обнаружение соседних сетевых устройств по LLDP.&lt;br /&gt;
|-&lt;br /&gt;
|BGP&lt;br /&gt;
|Состояние соседей BGP из стандартного BGP4-MIB.&lt;br /&gt;
|-&lt;br /&gt;
|Cisco BGP&lt;br /&gt;
|Состояние и статистика соседей из CISCO-BGP4-MIB.&lt;br /&gt;
|-&lt;br /&gt;
|OSPF&lt;br /&gt;
|Состояние соседей OSPF.&lt;br /&gt;
|-&lt;br /&gt;
|EIGRP&lt;br /&gt;
|Время прохождения пакетов до соседей EIGRP.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Для высокоскоростных интерфейсов рекомендуется использовать набор &amp;lt;code&amp;gt;Interfaces 64-bit&amp;lt;/code&amp;gt;. Счётчики из набора &amp;lt;code&amp;gt;Interfaces 32-bit&amp;lt;/code&amp;gt; могут быстро переполняться.&lt;br /&gt;
&lt;br /&gt;
== Основные метрики ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.cpm.cpu.total.1min.rev&amp;lt;/code&amp;gt;&lt;br /&gt;
|Средняя загрузка процессора за одну минуту.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.cpm.cpu.memory.hc.used&amp;lt;/code&amp;gt;&lt;br /&gt;
|Использованная память процессора.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.sys.uptime&amp;lt;/code&amp;gt;&lt;br /&gt;
|Время работы устройства после перезапуска.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.if.hc.in.octets.count&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество байтов, полученных интерфейсом.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.if.hc.out.octets.count&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество байтов, переданных интерфейсом.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.if.in.errors.count&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество ошибок при приёме.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.if.out.errors.count&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество ошибок при передаче.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.if.in.crc_errors.count&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество входящих пакетов с ошибками CRC.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;func:ru.ruscomtech.extension.snmp-generic-cisco-device.if.bandwidth&amp;lt;/code&amp;gt;&lt;br /&gt;
|Общая загрузка полосы пропускания интерфейса.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.envmon.fan.state&amp;lt;/code&amp;gt;&lt;br /&gt;
|Состояние вентилятора.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.power_supply.state&amp;lt;/code&amp;gt;&lt;br /&gt;
|Состояние блока питания.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.cbgp.peer.state&amp;lt;/code&amp;gt;&lt;br /&gt;
|Состояние соседа Cisco BGP.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.ospf.nbr.state&amp;lt;/code&amp;gt;&lt;br /&gt;
|Состояние соседа OSPF.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.eigrp.peer.srtt&amp;lt;/code&amp;gt;&lt;br /&gt;
|Сглаженное время прохождения пакетов до соседа EIGRP.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Оповещения ==&lt;br /&gt;
&lt;br /&gt;
Расширение содержит следующие шаблоны оповещений:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Оповещение&lt;br /&gt;
! Условие по умолчанию&lt;br /&gt;
|-&lt;br /&gt;
|Высокая загрузка входящей полосы пропускания&lt;br /&gt;
|Загрузка выше 90% как минимум в трёх из пяти последовательных измерений.&lt;br /&gt;
|-&lt;br /&gt;
|Высокая загрузка исходящей полосы пропускания&lt;br /&gt;
|Загрузка выше 90% как минимум в трёх из пяти последовательных измерений.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Пороговые значения следует скорректировать с учётом характеристик сети.&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После сохранения конфигурации:&lt;br /&gt;
&lt;br /&gt;
# Проверьте состояние конфигурации расширения.&lt;br /&gt;
# Убедитесь, что устройство отвечает на SNMP-запросы со стороны выбранного шлюза.&lt;br /&gt;
# Проверьте поступление метрики &amp;lt;code&amp;gt;ru.ruscomtech.extension.snmp-generic-cisco-device.sys.uptime&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Откройте обзорную панель устройств Cisco.&lt;br /&gt;
# Проверьте создание сущности устройства и связанных сетевых интерфейсов.&lt;br /&gt;
&lt;br /&gt;
Для проверки SNMP v2c можно использовать команду:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
snmpwalk -v2c -c &amp;amp;lt;community&amp;amp;gt; &amp;amp;lt;адрес_устройства&amp;amp;gt; 1.3.6.1.2.1.1&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Устранение неполадок ==&lt;br /&gt;
&lt;br /&gt;
Если метрики не поступают, проверьте:&lt;br /&gt;
&lt;br /&gt;
* доступность UDP-порта &amp;lt;code&amp;gt;161&amp;lt;/code&amp;gt;;&lt;br /&gt;
* правильность версии SNMP;&lt;br /&gt;
* строку сообщества либо параметры SNMP v3;&lt;br /&gt;
* список разрешённых адресов на устройстве;&lt;br /&gt;
* доступность устройства со стороны выбранного шлюза;&lt;br /&gt;
* поддержку необходимых MIB и OID;&lt;br /&gt;
* применённые фильтры интерфейсов;&lt;br /&gt;
* включённые наборы функций.&lt;br /&gt;
&lt;br /&gt;
Ошибка тайм-аута обычно указывает на проблемы сетевой доступности, межсетевого экрана или параметров SNMP.&lt;br /&gt;
&lt;br /&gt;
Ошибки &amp;lt;code&amp;gt;noSuchObject&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;noSuchInstance&amp;lt;/code&amp;gt; обычно означают, что устройство не поддерживает запрашиваемый OID. Отключите соответствующий набор функций.&lt;br /&gt;
&lt;br /&gt;
== История версий ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|3.2.7&lt;br /&gt;
|&lt;br /&gt;
* Версия расширения для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.310.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Минимальная версия контроллера выполнения расширений повышена до &amp;lt;code&amp;gt;1.307.0&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Добавлен мониторинг соседей BGP, OSPF и EIGRP.&lt;br /&gt;
* Добавлено обнаружение соседних устройств через LLDP.&lt;br /&gt;
* Добавлен сбор состояния заменяемых компонентов и дополнительных датчиков.&lt;br /&gt;
* Добавлен сбор ошибок CRC сетевых интерфейсов.&lt;br /&gt;
* Обновлены обзорная панель, топология устройств и экраны анализа.&lt;br /&gt;
|-&lt;br /&gt;
|2.1.6&lt;br /&gt;
|&lt;br /&gt;
* Добавлены наборы мониторинга пулов памяти, BGP и высокой доступности.&lt;br /&gt;
* Добавлены фильтры интерфейсов по имени, типу, Alias и состоянию.&lt;br /&gt;
* Добавлен сбор 32- и 64-разрядных показателей памяти.&lt;br /&gt;
* Интервал показателей загрузки процессора приведён к одной минуте.&lt;br /&gt;
* Исправлено применение наборов функций и фильтров к метрикам устройств и интерфейсов, что уменьшило объём лишних данных.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6889</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6889"/>
		<updated>2026-09-25T18:38:14Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
* [[Мониторинг служб Microsoft Active Directory]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг Microsoft Active Directory|Microsoft Active Directory]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_%D1%81%D0%BB%D1%83%D0%B6%D0%B1_Microsoft_Active_Directory&amp;diff=6888</id>
		<title>Мониторинг служб Microsoft Active Directory</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_%D1%81%D0%BB%D1%83%D0%B6%D0%B1_Microsoft_Active_Directory&amp;diff=6888"/>
		<updated>2026-09-25T18:37:56Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «&amp;#039;&amp;#039;&amp;#039;Идентификатор расширения:&amp;#039;&amp;#039;&amp;#039; &amp;lt;code&amp;gt;ru.ruscomtech.extension.active-directory&amp;lt;/code&amp;gt;  &amp;#039;&amp;#039;&amp;#039;Примечание.&amp;#039;&amp;#039;&amp;#039; Это отдельное WMI-расширение для мониторинга служб Active Directory. Не следует путать его с расширенным мониторингом Microsoft Active Directory.  == Возможности расширен...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&#039;&#039;&#039;Идентификатор расширения:&#039;&#039;&#039; &amp;lt;code&amp;gt;ru.ruscomtech.extension.active-directory&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Примечание.&#039;&#039;&#039; Это отдельное WMI-расширение для мониторинга служб Active Directory. Не следует путать его с [[Мониторинг Microsoft Active Directory|расширенным мониторингом Microsoft Active Directory]].&lt;br /&gt;
&lt;br /&gt;
== Возможности расширения ==&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для мониторинга производительности служб Microsoft Active Directory с помощью WMI.&lt;br /&gt;
&lt;br /&gt;
Расширение обеспечивает сбор следующих данных:&lt;br /&gt;
&lt;br /&gt;
* загрузка процессора контроллера домена;&lt;br /&gt;
* производительность процессов DNS и LSASS;&lt;br /&gt;
* показатели DNS и динамических обновлений;&lt;br /&gt;
* показатели DHCPv4 и DHCPv6;&lt;br /&gt;
* производительность LDAP;&lt;br /&gt;
* показатели DFS Replication;&lt;br /&gt;
* операции базы данных Active Directory;&lt;br /&gt;
* показатели очередей ATQ;&lt;br /&gt;
* состояние репликации DRA;&lt;br /&gt;
* сетевые входы пользователей;&lt;br /&gt;
* показатели NTLM;&lt;br /&gt;
* операции и задержки базы данных ESENT.&lt;br /&gt;
&lt;br /&gt;
Расширение также добавляет:&lt;br /&gt;
&lt;br /&gt;
* готовую обзорную панель;&lt;br /&gt;
* сущности доменов и экземпляров Active Directory;&lt;br /&gt;
* отдельные сущности DNS, DHCP, DFS, LDAP, ATQ, DRA, NTLM и базы данных;&lt;br /&gt;
* связи экземпляров Active Directory с соответствующими хостами.&lt;br /&gt;
&lt;br /&gt;
Сбор выполняется с интервалом в одну минуту.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
Для работы расширения необходимы:&lt;br /&gt;
&lt;br /&gt;
* Ключ-АСТРОМ версии &amp;lt;code&amp;gt;1.282.0&amp;lt;/code&amp;gt; или новее;&lt;br /&gt;
* контроллер домена Microsoft Active Directory;&lt;br /&gt;
* доступ к WMI на контроллере домена;&lt;br /&gt;
* запущенные службы, соответствующие выбранным наборам функций;&lt;br /&gt;
* ЕдиныйАгент на контроллере домена для локального сбора либо Windows-шлюз для удалённого сбора;&lt;br /&gt;
* учётная запись с правами чтения необходимых пространств имён и классов WMI — при удалённом подключении.&lt;br /&gt;
&lt;br /&gt;
Microsoft Entra ID не поддерживается. Расширение предназначено для локальных развёртываний Active Directory.&lt;br /&gt;
&lt;br /&gt;
== Подготовка WMI ==&lt;br /&gt;
&lt;br /&gt;
При локальном сборе убедитесь, что на контроллере домена установлен ЕдиныйАгент и включено выполнение расширений.&lt;br /&gt;
&lt;br /&gt;
Для удалённого сбора необходимо:&lt;br /&gt;
&lt;br /&gt;
# Разрешить учётной записи удалённый доступ к WMI.&lt;br /&gt;
# Предоставить разрешение &amp;lt;code&amp;gt;Remote Enable&amp;lt;/code&amp;gt; для пространства имён WMI.&lt;br /&gt;
# Разрешить WMI, DCOM и RPC в межсетевом экране.&lt;br /&gt;
# Обеспечить сетевую доступность контроллера домена со стороны Windows-шлюза.&lt;br /&gt;
# Проверить доступ учётной записи к счётчикам производительности Windows.&lt;br /&gt;
&lt;br /&gt;
Рекомендуется использовать отдельную доменную учётную запись, предназначенную только для мониторинга.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# Откройте раздел управления расширениями в Ключ-АСТРОМ.&lt;br /&gt;
# Загрузите пакет &amp;lt;code&amp;gt;ad service 3.1.17.zip&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Убедитесь, что расширение &amp;lt;code&amp;gt;ru.ruscomtech.extension.active-directory&amp;lt;/code&amp;gt; успешно установлено.&lt;br /&gt;
# Создайте новую конфигурацию мониторинга.&lt;br /&gt;
# Выберите способ выполнения расширения.&lt;br /&gt;
# Укажите контроллеры домена и учётные данные, если используется удалённый сбор.&lt;br /&gt;
# Выберите необходимые наборы функций.&lt;br /&gt;
# Сохраните и включите конфигурацию.&lt;br /&gt;
&lt;br /&gt;
== Конфигурация ==&lt;br /&gt;
&lt;br /&gt;
Основные параметры конфигурации:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
|Имя конфигурации&lt;br /&gt;
|Произвольное понятное имя конфигурации мониторинга.&lt;br /&gt;
|-&lt;br /&gt;
|Расположение выполнения&lt;br /&gt;
|ЕдиныйАгент на контроллере домена либо группа Windows-шлюзов для удалённого сбора.&lt;br /&gt;
|-&lt;br /&gt;
|Адрес устройства&lt;br /&gt;
|Имя узла или IP-адрес контроллера домена. Для локального сбора отдельно не указывается.&lt;br /&gt;
|-&lt;br /&gt;
|Имя пользователя&lt;br /&gt;
|Учётная запись для подключения к WMI. Рекомендуемый формат: &amp;lt;code&amp;gt;DOMAIN\username&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|Пароль&lt;br /&gt;
|Пароль учётной записи WMI.&lt;br /&gt;
|-&lt;br /&gt;
|Наборы функций&lt;br /&gt;
|Группы метрик, которые необходимо собирать с контроллера домена.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
API-токен для работы этого расширения не требуется.&lt;br /&gt;
&lt;br /&gt;
== Наборы функций ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;host&amp;lt;/code&amp;gt;&lt;br /&gt;
|Использование процессора и количество логических процессоров.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;service-performance&amp;lt;/code&amp;gt;&lt;br /&gt;
|Использование процессора службами DNS и LSASS.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;dns&amp;lt;/code&amp;gt;&lt;br /&gt;
|Запросы, ответы, динамические обновления, память и передача зон DNS.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;dhcp&amp;lt;/code&amp;gt;&lt;br /&gt;
|Запросы DHCPv4 и показатели отказоустойчивости.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;dhcpv6&amp;lt;/code&amp;gt;&lt;br /&gt;
|Запросы, продления, освобождения и повторные привязки DHCPv6.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ldap&amp;lt;/code&amp;gt;&lt;br /&gt;
|Подключения, запросы, операции записи и активные потоки LDAP.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;dfsfolders&amp;lt;/code&amp;gt;&lt;br /&gt;
|Использование пространства и операции с реплицируемыми папками DFS.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;dfsconnections&amp;lt;/code&amp;gt;&lt;br /&gt;
|Переданные данные и файлы соединений DFS Replication.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;database-ad&amp;lt;/code&amp;gt;&lt;br /&gt;
|Добавление, изменение, удаление и повторное использование объектов базы данных Active Directory.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;esent-database-lsa&amp;lt;/code&amp;gt;&lt;br /&gt;
|Операции ввода-вывода и задержки базы данных ESENT.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;atq&amp;lt;/code&amp;gt;&lt;br /&gt;
|Очередь запросов, задержки и потоки ATQ.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;dra&amp;lt;/code&amp;gt;&lt;br /&gt;
|Запросы синхронизации Directory Replication Agent.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;network&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество и интенсивность сетевых входов.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ntlm&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество привязок NTLM в секунду.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Включайте только те наборы функций, для которых на контроллере домена установлены и запущены соответствующие службы. Например, если сервер не выполняет роль DHCP, наборы &amp;lt;code&amp;gt;dhcp&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;dhcpv6&amp;lt;/code&amp;gt; следует отключить.&lt;br /&gt;
&lt;br /&gt;
== Основные метрики ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.server.host.cpu.time.processor&amp;lt;/code&amp;gt;&lt;br /&gt;
|Использование процессора контроллера домена.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.service.cpu.time&amp;lt;/code&amp;gt;&lt;br /&gt;
|Использование процессора процессами DNS и LSASS.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.dns.server.totalquery.received.persec&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество запросов DNS в секунду.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.dns.server.recursive.queryfailure.persec&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество ошибок рекурсивных запросов DNS.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.dhcp.server.requests.persec&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество запросов DHCPv4 в секунду.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.ldap.server.ldapbindtime.binds.persec&amp;lt;/code&amp;gt;&lt;br /&gt;
|Время выполнения привязки LDAP.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.ldap.server.ldapclientsessions.total&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество клиентских сеансов LDAP.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.atq.server.atqoutstandingqueuedrequests.total&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество запросов в очереди ATQ.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.dra.server.drasynchrequestssuccessful.total&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество успешных запросов синхронизации.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.lsass.esent.database.io.reads.latency.avg.count&amp;lt;/code&amp;gt;&lt;br /&gt;
|Средняя задержка операций чтения базы данных ESENT.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Проверка работы ==&lt;br /&gt;
&lt;br /&gt;
После включения конфигурации:&lt;br /&gt;
&lt;br /&gt;
# Проверьте состояние конфигурации расширения.&lt;br /&gt;
# Убедитесь, что поступает метрика &amp;lt;code&amp;gt;active-directory.server.host.cpu.time.processor&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Откройте обзорную панель Active Directory.&lt;br /&gt;
# Проверьте создание сущностей домена и контроллеров домена.&lt;br /&gt;
# Убедитесь, что для установленных ролей поступают соответствующие показатели DNS, DHCP, LDAP и DFS.&lt;br /&gt;
&lt;br /&gt;
== Устранение неполадок ==&lt;br /&gt;
&lt;br /&gt;
Если метрики не поступают, проверьте:&lt;br /&gt;
&lt;br /&gt;
* правильность имени узла и учётных данных;&lt;br /&gt;
* разрешение удалённого доступа к WMI;&lt;br /&gt;
* настройки DCOM, RPC и межсетевого экрана;&lt;br /&gt;
* доступность необходимых классов WMI;&lt;br /&gt;
* наличие соответствующей роли Windows Server;&lt;br /&gt;
* состояние служб DNS, DHCP, DFS и Active Directory Domain Services;&lt;br /&gt;
* включённые наборы функций.&lt;br /&gt;
&lt;br /&gt;
Ошибка &amp;lt;code&amp;gt;Invalid class&amp;lt;/code&amp;gt; обычно означает, что соответствующая роль Windows Server не установлена. В этом случае отключите набор функций, использующий отсутствующий класс WMI.&lt;br /&gt;
&lt;br /&gt;
Ошибка &amp;lt;code&amp;gt;Access denied&amp;lt;/code&amp;gt; указывает на недостаточные права учётной записи.&lt;br /&gt;
&lt;br /&gt;
Ошибка &amp;lt;code&amp;gt;RPC server is unavailable&amp;lt;/code&amp;gt; указывает на проблемы сетевой доступности, DCOM, RPC или межсетевого экрана.&lt;br /&gt;
&lt;br /&gt;
== История версий ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|3.1.17&lt;br /&gt;
|&lt;br /&gt;
* Версия расширения для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.282.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Добавлен сбор показателей служб Active Directory через WMI.&lt;br /&gt;
* Добавлена готовая обзорная панель.&lt;br /&gt;
* Добавлены сущности доменов, контроллеров домена и связанных служб Active Directory.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6887</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6887"/>
		<updated>2026-09-25T18:22:29Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
* [[Мониторинг Microsoft Active Directory]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг Microsoft Active Directory|Microsoft Active Directory]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6714</id>
		<title>Расширения</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F&amp;diff=6714"/>
		<updated>2026-09-17T21:03:48Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: /* Расширения 2.0 */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;В зависимости от архитектуры вашего развертывания и целей, которых вы хотите достичь, вы можете выбрать один из следующих методов расширения:&lt;br /&gt;
&lt;br /&gt;
== ЕдиныйАгент SDK       ==&lt;br /&gt;
Пакет SDK для ЕдиногоАгента позволяет вручную настраивать приложения для расширения сквозной видимости платформ и технологий. С помощью SDK вы получаете полный доступ ко всем функциям анализа и мониторинга, включая автоматический анализ первопричин на основе искусственного интеллекта. Дополнительные сведения см. В разделе [[ЕдиныйАгент SDK]] .&lt;br /&gt;
&lt;br /&gt;
== Расширения Ключ-Астром    ==&lt;br /&gt;
*Если вы можете установить ЕдиныйАгент на хост, используйте расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;.&lt;br /&gt;
* Если вам нужно контролировать удаленную технологию, где установка ЕдиногоАгента невозможна, используйте расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;.&lt;br /&gt;
* Если вы просто хотите отслеживать приложение Java, которое предоставляет компоненты MBeans, используйте расширения &#039;&#039;&#039;JMX&#039;&#039;&#039;.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;ЕдиногоАгента&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений ЕдиногоАгента вы можете расширить мониторинг ЕдиногоАгента на любые обнаруженные ЕдинымАгентом процессы, которые предоставляют интерфейс (например, процессы, обслуживаемые по протоколу HTTP - базы данных, приложения и балансировщики нагрузки). Расширения работают в ЕдиномАгенте и полностью интегрируют мониторинг новых технологий в Ключ-Астром Smartscape и обнаружение проблем. Для разработки расширений ЕдиногоАгента вам потребуется некоторый опыт работы с Python. Дополнительные сведения см. в разделе [[Расширения ЕдиногоАгента]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;АктивногоШлюза&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений АктивногоШлюза вы можете распространить мониторинг Ключ-АСТРОМ на любую удаленную технологию, которая предоставляет интерфейс, где установка ЕдиногоАгента невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивногоШлюза (также известные как удаленные плагины) выполняются на АктивномШлюзе и могут получать метрики и топологию из удаленных источников, полностью интегрируя мониторинг новых технологий в Ключ-АСТРОМ Smartscape и обнаружение проблем. Для разработки расширений АктивногоШлюза вам потребуется некоторый опыт работы с Python. Для получения дополнительной информации см. [[Введение в расширения АктивногоШлюза]].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширения &#039;&#039;&#039;JMX/PMI&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
С помощью расширений JMX/PMI вы расширяете мониторинг Ключ-АСТРОМ на любое приложение на основе Java, открывающее MBeans. Кодирования не требуется, используйте наш мастер для настройки и развертывания расширения. Дополнительные сведения см. в разделе [[Как отслеживать показатели JMX в моих приложениях Java?]].&lt;br /&gt;
&lt;br /&gt;
* [[Расширения JMX]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Расширение &#039;&#039;&#039;SDK&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Расширение SDK - это универсальное решение, которое позволяет отслеживать любую настраиваемую технологию, предоставляющую интерфейс. Разработайте и разверните свои расширения. Ключ-АСТРОМ может беспрепятственно интегрировать ваши данные мониторинга с помощью специальных технологий в соответствующие аналитические представления, в полной мере используя все ваши любимые функции Ключ-АСТРОМ и анализ первопричин на основе искусственного интеллекта.&lt;br /&gt;
&lt;br /&gt;
=== Поддержка &amp;quot;из коробки&amp;quot; ===&lt;br /&gt;
&lt;br /&gt;
* [[Мониторинг Cassandra]]&lt;br /&gt;
&lt;br /&gt;
== Ключ-АСТРОМ OpenKit ==&lt;br /&gt;
Если у вашего бизнеса есть цифровые точки соприкосновения за пределами ваших приложений, вы можете использовать Ключ-АСТРОМ OpenKit для их инструментария, независимо от того, являются ли они традиционными полнофункциональными клиентскими приложениями, интеллектуальными приложениями IoT или даже навыками Alexa. Ключ-АСТРОМ OpenKit лучше всего подходит для клиент-серверных приложений, которые обмениваются данными через HTTP (например, многофункциональные клиентские приложения, встроенные устройства и терминалы). Для получения дополнительной информации см. [[Ключ-АСТРОМ OpenKit]] .&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Прием и анализ пользовательских метрик ==&lt;br /&gt;
Пользовательская метрика определяется как новый тип метрики, который предлагает предоставленный пользователем идентификатор метрики и единицу измерения. Семантика настраиваемых показателей определяется вами. После определения настраиваемой метрики ее можно сообщить для нескольких отслеживаемых компонентов.&lt;br /&gt;
&lt;br /&gt;
== [[Расширения 2.0]] ==&lt;br /&gt;
&lt;br /&gt;
* [[Ceph]]&lt;br /&gt;
*[[Apache Storm]]&lt;br /&gt;
*[[Custom Database Queries]]&lt;br /&gt;
*[[Microsoft Active Directory replication]]&lt;br /&gt;
*[[IBM MQ]]&lt;br /&gt;
*[[Microsoft SQL Server]]&lt;br /&gt;
*[[Filesystem monitoring]]&lt;br /&gt;
*[[Расширение PostgreSQL|PostgresDB]] &lt;br /&gt;
*[[SAP ABAP platform monitoring]]&lt;br /&gt;
*[[MySQL (remote monitoring)]]&lt;br /&gt;
*[[Расширение Redis|Redis]]&lt;br /&gt;
*[[IBM i]]&lt;br /&gt;
*[[Расширение Apache Kafka|Apache Kafka]]&lt;br /&gt;
*[[Мониторинг SSL-сертификатов]]&lt;br /&gt;
*[[Generic network device]]&lt;br /&gt;
*[[SNMP Autodiscovery]]&lt;br /&gt;
*[[Источник данных SNMP Traps]]&lt;br /&gt;
*[[Справочник по источнику данных SNMP]]&lt;br /&gt;
*[[Мониторинг F5 BIG-IP LTM Расширения 2.0|Мониторинг F5 BIG-IP LTM]]&lt;br /&gt;
*[[Мониторинг Microsoft Hyper-V]]&lt;br /&gt;
&lt;br /&gt;
*[[ClickHouse]]&lt;br /&gt;
*[[Cassandra]]&lt;br /&gt;
*[[DB Query]]&lt;br /&gt;
*[[KA-monitor]]&lt;br /&gt;
*[[Linux command extension]]&lt;br /&gt;
*[[MongoDB]]&lt;br /&gt;
*[[MS SQL]]&lt;br /&gt;
*[[Custom sessions monitor]]&lt;br /&gt;
*[[Zabbix]]&lt;br /&gt;
*[[Мониторинг Microsoft Active Directory|Microsoft Active Directory]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширенный пользовательский опыт и поведение]] ==&lt;br /&gt;
&lt;br /&gt;
== Лицензии ВИД Ключ-АСТРОМ ==&lt;br /&gt;
&lt;br /&gt;
* [[Блоки данных ИИ (DDU) для метрик|Лицензии ВИД для метрик]]&lt;br /&gt;
&lt;br /&gt;
== [[Расширение топологии - Пользовательская модель топологии]] ==&lt;br /&gt;
&lt;br /&gt;
== Разработка ==&lt;br /&gt;
&lt;br /&gt;
* Расширения АктивногоШлюза&lt;br /&gt;
** [[Введение]]&lt;br /&gt;
**[[Возможности]]&lt;br /&gt;
**[[Руководство]]&lt;br /&gt;
&lt;br /&gt;
* Расширения&lt;br /&gt;
** [[Развёртывание расширения]]&lt;br /&gt;
**[[Диаграммы]]&lt;br /&gt;
** [[Ключевые показатели производительности]]&lt;br /&gt;
** [[Оповещения о расширениях]]&lt;br /&gt;
** [[Групповые показатели]]&lt;br /&gt;
**[[Метрики состояний]]&lt;br /&gt;
** [[Пользовательская конфигурация плагина АктивныйШлюз]]&lt;br /&gt;
** [[Конфигурация расширения]]&lt;br /&gt;
** [[Топология]]&lt;br /&gt;
** [[Проблемы и события]]&lt;br /&gt;
** [[Пользовательские свойства]]&lt;br /&gt;
*[[Обновление до Python 3.8]]&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_Microsoft_Active_Directory&amp;diff=6713</id>
		<title>Мониторинг Microsoft Active Directory</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_Microsoft_Active_Directory&amp;diff=6713"/>
		<updated>2026-09-17T21:02:31Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= Расширение Microsoft Active Directory для Ключ-АСТРОМ =  Расширение предназначено для локального мониторинга контроллеров домена Microsoft Active Directory. Оно собирает показатели производительности и состояния через WMI и PowerShell, контролирует репликацию, службы Active Directory и...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Расширение Microsoft Active Directory для Ключ-АСТРОМ =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для локального мониторинга контроллеров домена Microsoft Active Directory. Оно собирает показатели производительности и состояния через WMI и PowerShell, контролирует репликацию, службы Active Directory и системные журналы Windows.&lt;br /&gt;
&lt;br /&gt;
Расширение устанавливается на контроллеры домена с ЕдинымАгентом. Удалённый мониторинг контроллеров домена не поддерживается.&lt;br /&gt;
&lt;br /&gt;
== Возможности расширения ==&lt;br /&gt;
&lt;br /&gt;
* Мониторинг DNS, DHCP, DFS, LDAP, ATQ, DRA, Kerberos и NTLM.&lt;br /&gt;
* Контроль состояния репликации Active Directory.&lt;br /&gt;
* Проверка согласованности держателей ролей FSMO.&lt;br /&gt;
* Контроль состояния SYSVOL.&lt;br /&gt;
* Определение расхождения системного времени.&lt;br /&gt;
* Мониторинг базы данных Active Directory и свободного места на диске.&lt;br /&gt;
* Сбор показателей сетевых адаптеров и системных служб.&lt;br /&gt;
* Сбор событий из журналов Windows.&lt;br /&gt;
* Создание сущностей Active Directory и связей между ними.&lt;br /&gt;
* Готовая обзорная панель.&lt;br /&gt;
* Готовые шаблоны оповещений.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
* Ключ-АСТРОМ версии &amp;lt;code&amp;gt;1.290.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* ЕдиныйАгент должен быть установлен на каждом контроллере домена, который требуется отслеживать.&lt;br /&gt;
* Локальное выполнение Python-расширений должно быть включено.&lt;br /&gt;
* Расширение должно выполняться с повышенными привилегиями.&lt;br /&gt;
* Поддерживаются локальные развёртывания Microsoft Active Directory.&lt;br /&gt;
* Microsoft Entra ID этим расширением не отслеживается.&lt;br /&gt;
* Расширение проверено для Windows Server 2016, 2019, 2022 и 2025.&lt;br /&gt;
&lt;br /&gt;
== Установка ==&lt;br /&gt;
&lt;br /&gt;
# Загрузите пакет расширения версии &amp;lt;code&amp;gt;5.1.1&amp;lt;/code&amp;gt; в раздел управления расширениями Ключ-АСТРОМ.&lt;br /&gt;
# Убедитесь, что ЕдиныйАгент установлен на контроллерах домена.&lt;br /&gt;
# Настройте выполнение расширения с повышенными привилегиями.&lt;br /&gt;
# Создайте конфигурацию мониторинга и выберите контроллеры домена.&lt;br /&gt;
# Включите необходимые функциональные наборы.&lt;br /&gt;
# Сохраните конфигурацию и проверьте её состояние.&lt;br /&gt;
&lt;br /&gt;
== Настройка привилегий ==&lt;br /&gt;
&lt;br /&gt;
Для получения данных из WMI, реестра Windows и PowerShell расширению требуются повышенные привилегии. Можно использовать один из двух вариантов.&lt;br /&gt;
&lt;br /&gt;
=== Выполнение от имени LOCAL SYSTEM ===&lt;br /&gt;
&lt;br /&gt;
Это рекомендуемый вариант.&lt;br /&gt;
&lt;br /&gt;
В файле &amp;lt;code&amp;gt;&amp;amp;lt;каталог_данных_ЕдиногоАгента&amp;amp;gt;\agent\config\extensionsuser.conf&amp;lt;/code&amp;gt; добавьте расширение в список компонентов, запускаемых с повышенными привилегиями:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
elevated_privileges_extensions=[ru.ruscomtech.extension.active-directory-python:*]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Если файл уже содержит настройки других расширений, не удаляйте существующие записи.&lt;br /&gt;
&lt;br /&gt;
После изменения конфигурации перезапустите ЕдиныйАгент.&lt;br /&gt;
&lt;br /&gt;
=== Выполнение от имени отдельного пользователя ===&lt;br /&gt;
&lt;br /&gt;
В конфигурации расширения включите параметр &amp;lt;code&amp;gt;Provide custom user account&amp;lt;/code&amp;gt; и укажите учётные данные в формате &amp;lt;code&amp;gt;domain\username&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Учётной записи необходимы:&lt;br /&gt;
&lt;br /&gt;
* право локального входа на контроллер домена;&lt;br /&gt;
* право &amp;lt;code&amp;gt;KEY_READ&amp;lt;/code&amp;gt; для раздела реестра &amp;lt;code&amp;gt;HKLM\SYSTEM\CurrentControlSet\Services\NTDS\Parameters&amp;lt;/code&amp;gt;;&lt;br /&gt;
* членство в группе &amp;lt;code&amp;gt;DHCP Users&amp;lt;/code&amp;gt;, если включён сбор статистики областей DHCP;&lt;br /&gt;
* доступ к используемым WMI-классам и командам PowerShell.&lt;br /&gt;
&lt;br /&gt;
Пароль указывается в секретном поле конфигурации.&lt;br /&gt;
&lt;br /&gt;
== Токен API ==&lt;br /&gt;
&lt;br /&gt;
Для автоматического создания правил мониторинга служб и сбора журналов создайте отдельный токен API со следующими правами:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;settings.read&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;settings.write&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Укажите токен в поле &amp;lt;code&amp;gt;API key&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Рекомендуется использовать отдельный токен только для этого расширения. Без токена основные метрики WMI и PowerShell могут собираться, но правила мониторинга служб и журналов автоматически созданы не будут.&lt;br /&gt;
&lt;br /&gt;
== Конфигурация ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Значение по умолчанию&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
|Provide custom user account&lt;br /&gt;
|Отключено&lt;br /&gt;
|Позволяет запускать проверки от имени указанного пользователя вместо &amp;lt;code&amp;gt;LOCAL SYSTEM&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|Username&lt;br /&gt;
|—&lt;br /&gt;
|Имя пользователя в формате &amp;lt;code&amp;gt;domain\username&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|Password&lt;br /&gt;
|—&lt;br /&gt;
|Пароль пользователя. Хранится как секрет.&lt;br /&gt;
|-&lt;br /&gt;
|API key&lt;br /&gt;
|—&lt;br /&gt;
|Токен с правами &amp;lt;code&amp;gt;settings.read&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;settings.write&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|Collection Frequency&lt;br /&gt;
|1 минута&lt;br /&gt;
|Интервал сбора данных. Для больших доменов рекомендуется увеличить его, чтобы все проверки успевали завершиться.&lt;br /&gt;
|-&lt;br /&gt;
|Log level&lt;br /&gt;
|INFO&lt;br /&gt;
|Уровень журналирования расширения. Значение &amp;lt;code&amp;gt;DEBUG&amp;lt;/code&amp;gt; следует использовать только при диагностике.&lt;br /&gt;
|-&lt;br /&gt;
|Enable Log Ingestion&lt;br /&gt;
|Включено&lt;br /&gt;
|Создаёт правила сбора журналов Active Directory и связанных системных журналов.&lt;br /&gt;
|-&lt;br /&gt;
|OS Service Monitoring&lt;br /&gt;
|Включено&lt;br /&gt;
|Создаёт правила контроля состояния выбранных служб Windows.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Мониторинг служб ==&lt;br /&gt;
&lt;br /&gt;
Расширение позволяет контролировать следующие службы:&lt;br /&gt;
&lt;br /&gt;
* Active Directory Web Services;&lt;br /&gt;
* DFS и DFS Replication;&lt;br /&gt;
* DNS Server и DNS Cache;&lt;br /&gt;
* Group Policy Service;&lt;br /&gt;
* Intersite Messaging;&lt;br /&gt;
* Key Distribution Center;&lt;br /&gt;
* NetLogon;&lt;br /&gt;
* Windows Time;&lt;br /&gt;
* Remote Procedure Call;&lt;br /&gt;
* Event System;&lt;br /&gt;
* Security Account Manager;&lt;br /&gt;
* Directory Services;&lt;br /&gt;
* Internet Information Services;&lt;br /&gt;
* SMTP;&lt;br /&gt;
* Active Directory Certificate Services и Online Responder.&lt;br /&gt;
&lt;br /&gt;
Отключите службы, которые не установлены на контроллере домена. Это уменьшит количество ошибок в журнале расширения.&lt;br /&gt;
&lt;br /&gt;
== Сбор журналов ==&lt;br /&gt;
&lt;br /&gt;
При включённом параметре &amp;lt;code&amp;gt;Enable Log Ingestion&amp;lt;/code&amp;gt; расширение создаёт правила для журналов:&lt;br /&gt;
&lt;br /&gt;
* Active Directory Web Services;&lt;br /&gt;
* DFS Replication;&lt;br /&gt;
* Directory Service;&lt;br /&gt;
* DNS Server;&lt;br /&gt;
* Windows Application Log;&lt;br /&gt;
* Windows System Log;&lt;br /&gt;
* Security.&lt;br /&gt;
&lt;br /&gt;
Также создаются фильтры для событий AD FS, Kerberos, DHCP, DNS, службы времени, центра сертификации и других компонентов Active Directory.&lt;br /&gt;
&lt;br /&gt;
== Функциональные наборы ==&lt;br /&gt;
&lt;br /&gt;
Включайте только те наборы, которые соответствуют ролям контроллера домена.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
|Host&lt;br /&gt;
|Использование процессора и ресурсов службами Active Directory.&lt;br /&gt;
|-&lt;br /&gt;
|DNS&lt;br /&gt;
|Запросы, ответы, ошибки, динамические обновления и использование памяти DNS.&lt;br /&gt;
|-&lt;br /&gt;
|DHCPv4 и DHCPv6&lt;br /&gt;
|Запросы, освобождения адресов, отклонения и показатели отказоустойчивости DHCP.&lt;br /&gt;
|-&lt;br /&gt;
|DHCPv4 Scopes и DHCPv6 Scopes&lt;br /&gt;
|Свободные, используемые и зарезервированные адреса в областях DHCP.&lt;br /&gt;
|-&lt;br /&gt;
|LDAP&lt;br /&gt;
|Время привязки, доступность LDAP, активные потоки, сеансы и операции.&lt;br /&gt;
|-&lt;br /&gt;
|DFS Folders и DFS Connections&lt;br /&gt;
|Состояние реплицируемых папок и соединений DFS.&lt;br /&gt;
|-&lt;br /&gt;
|Database&lt;br /&gt;
|Добавление, изменение, удаление и восстановление объектов каталога.&lt;br /&gt;
|-&lt;br /&gt;
|ESENT Database&lt;br /&gt;
|Операции чтения и записи базы данных и журнала ESENT.&lt;br /&gt;
|-&lt;br /&gt;
|Database Disk&lt;br /&gt;
|Объём диска и свободное место для базы данных Active Directory.&lt;br /&gt;
|-&lt;br /&gt;
|ATQ&lt;br /&gt;
|Очереди, задержки, потоки и средняя загрузка ATQ.&lt;br /&gt;
|-&lt;br /&gt;
|DRA&lt;br /&gt;
|Состояние запросов синхронизации Directory Replication Agent.&lt;br /&gt;
|-&lt;br /&gt;
|Network и Network Adapter&lt;br /&gt;
|Сетевые входы, состояние адаптеров и связанные показатели.&lt;br /&gt;
|-&lt;br /&gt;
|NTLM&lt;br /&gt;
|Количество привязок NTLM.&lt;br /&gt;
|-&lt;br /&gt;
|Domain Controller Overview&lt;br /&gt;
|Репликация, FSMO, SYSVOL, расхождение времени и общее состояние контроллера домена.&lt;br /&gt;
|-&lt;br /&gt;
|Replication Summary&lt;br /&gt;
|Ошибки и задержки репликации между источниками и получателями.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Основные метрики ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.replication.consistency.status&amp;lt;/code&amp;gt;&lt;br /&gt;
|Состояние согласованности репликации.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.replication.partner.count.total&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество партнёров репликации.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.replication.queue.count.total&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество операций в очереди репликации.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.replication.destination.errors&amp;lt;/code&amp;gt;&lt;br /&gt;
|Ошибки репликации на стороне получателя.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.replication.source.errors&amp;lt;/code&amp;gt;&lt;br /&gt;
|Ошибки репликации на стороне источника.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.timeskew.secs&amp;lt;/code&amp;gt;&lt;br /&gt;
|Расхождение системного времени в секундах.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.fsmo.check&amp;lt;/code&amp;gt;&lt;br /&gt;
|Результат проверки держателей ролей FSMO.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.sysvol.health&amp;lt;/code&amp;gt;&lt;br /&gt;
|Состояние SYSVOL.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.ldap.bind.availability&amp;lt;/code&amp;gt;&lt;br /&gt;
|Доступность операции привязки LDAP.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.database.diskfree&amp;lt;/code&amp;gt;&lt;br /&gt;
|Доля свободного места на диске с базой данных Active Directory.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.atq.server.average.thread.usage&amp;lt;/code&amp;gt;&lt;br /&gt;
|Средняя загрузка потоков ATQ.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Шаблоны оповещений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Оповещение&lt;br /&gt;
! Условие по умолчанию&lt;br /&gt;
|-&lt;br /&gt;
|Расхождение времени&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.timeskew.secs&amp;lt;/code&amp;gt; превышает 120 секунд.&lt;br /&gt;
|-&lt;br /&gt;
|Свободное место базы данных&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.database.diskfree&amp;lt;/code&amp;gt; ниже 15%.&lt;br /&gt;
|-&lt;br /&gt;
|Загрузка потоков ATQ&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.atq.server.average.thread.usage&amp;lt;/code&amp;gt; превышает 80%.&lt;br /&gt;
|-&lt;br /&gt;
|Согласованность репликации&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.replication.consistency.status&amp;lt;/code&amp;gt; ниже 1.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Пороговые значения можно изменить после установки расширения.&lt;br /&gt;
&lt;br /&gt;
== Проверка конфигурации ==&lt;br /&gt;
&lt;br /&gt;
После сохранения конфигурации:&lt;br /&gt;
&lt;br /&gt;
# Убедитесь, что состояние расширения отображается как успешное.&lt;br /&gt;
# Дождитесь не менее двух интервалов сбора.&lt;br /&gt;
# Откройте обзорную панель Microsoft Active Directory.&lt;br /&gt;
# Проверьте наличие метрик репликации, LDAP и состояния контроллеров домена.&lt;br /&gt;
# Если включён сбор журналов, убедитесь, что поступают события Windows.&lt;br /&gt;
# Проверьте создание правил мониторинга выбранных служб.&lt;br /&gt;
&lt;br /&gt;
== Диагностика ==&lt;br /&gt;
&lt;br /&gt;
=== Ошибка доступа к WMI или PowerShell ===&lt;br /&gt;
&lt;br /&gt;
Убедитесь, что расширение выполняется от имени &amp;lt;code&amp;gt;LOCAL SYSTEM&amp;lt;/code&amp;gt; или указанной учётной записи предоставлены необходимые права.&lt;br /&gt;
&lt;br /&gt;
=== Не собираются метрики DHCP, DNS или DFS ===&lt;br /&gt;
&lt;br /&gt;
Проверьте, что соответствующая роль установлена на сервере. Если роль не используется, отключите связанный функциональный набор.&lt;br /&gt;
&lt;br /&gt;
=== Не создаются правила мониторинга служб или журналов ===&lt;br /&gt;
&lt;br /&gt;
Проверьте токен API и наличие прав &amp;lt;code&amp;gt;settings.read&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;settings.write&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Дублируются метрики ===&lt;br /&gt;
&lt;br /&gt;
Отключите предыдущие расширения мониторинга Active Directory, если они установлены на тех же контроллерах домена.&lt;br /&gt;
&lt;br /&gt;
== История версий ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|5.1.1&lt;br /&gt;
|&lt;br /&gt;
* Версия расширения для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.290.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Добавлена возможность запуска проверок от имени отдельного привилегированного пользователя.&lt;br /&gt;
* Для токена API больше не требуется право &amp;lt;code&amp;gt;entities.read&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Исправлена обработка символов, не соответствующих UTF-8, в результатах WMI-запросов.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%9E%D0%B1%D1%81%D1%83%D0%B6%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5_%D1%83%D1%87%D0%B0%D1%81%D1%82%D0%BD%D0%B8%D0%BA%D0%B0:Azubarev&amp;diff=6712</id>
		<title>Обсуждение участника:Azubarev</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%9E%D0%B1%D1%81%D1%83%D0%B6%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5_%D1%83%D1%87%D0%B0%D1%81%D1%82%D0%BD%D0%B8%D0%BA%D0%B0:Azubarev&amp;diff=6712"/>
		<updated>2026-09-17T20:57:40Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: Новая страница: «= Расширение Microsoft Active Directory для Ключ-АСТРОМ =  Расширение предназначено для локального мониторинга контроллеров домена Microsoft Active Directory. Оно собирает показатели производительности и состояния через WMI и PowerShell, контролирует репликацию, службы Active Directory и...»&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Расширение Microsoft Active Directory для Ключ-АСТРОМ =&lt;br /&gt;
&lt;br /&gt;
Расширение предназначено для локального мониторинга контроллеров домена Microsoft Active Directory. Оно собирает показатели производительности и состояния через WMI и PowerShell, контролирует репликацию, службы Active Directory и системные журналы Windows.&lt;br /&gt;
&lt;br /&gt;
Расширение устанавливается на контроллеры домена с ЕдинымАгентом. Удалённый мониторинг контроллеров домена не поддерживается.&lt;br /&gt;
&lt;br /&gt;
== Возможности расширения ==&lt;br /&gt;
&lt;br /&gt;
* Мониторинг DNS, DHCP, DFS, LDAP, ATQ, DRA, Kerberos и NTLM.&lt;br /&gt;
* Контроль состояния репликации Active Directory.&lt;br /&gt;
* Проверка согласованности держателей ролей FSMO.&lt;br /&gt;
* Контроль состояния SYSVOL.&lt;br /&gt;
* Определение расхождения системного времени.&lt;br /&gt;
* Мониторинг базы данных Active Directory и свободного места на диске.&lt;br /&gt;
* Сбор показателей сетевых адаптеров и системных служб.&lt;br /&gt;
* Сбор событий из журналов Windows.&lt;br /&gt;
* Создание сущностей Active Directory и связей между ними.&lt;br /&gt;
* Готовая обзорная панель.&lt;br /&gt;
* Готовые шаблоны оповещений.&lt;br /&gt;
&lt;br /&gt;
== Требования ==&lt;br /&gt;
&lt;br /&gt;
* Ключ-АСТРОМ версии &amp;lt;code&amp;gt;1.290.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* ЕдиныйАгент должен быть установлен на каждом контроллере домена, который требуется отслеживать.&lt;br /&gt;
* Локальное выполнение Python-расширений должно быть включено.&lt;br /&gt;
* Расширение должно выполняться с повышенными привилегиями.&lt;br /&gt;
* Поддерживаются локальные развёртывания Microsoft Active Directory.&lt;br /&gt;
* Microsoft Entra ID этим расширением не отслеживается.&lt;br /&gt;
* Расширение проверено для Windows Server 2016, 2019, 2022 и 2025.&lt;br /&gt;
&lt;br /&gt;
== Установка ==&lt;br /&gt;
&lt;br /&gt;
# Загрузите пакет расширения версии &amp;lt;code&amp;gt;5.1.1&amp;lt;/code&amp;gt; в раздел управления расширениями Ключ-АСТРОМ.&lt;br /&gt;
# Убедитесь, что ЕдиныйАгент установлен на контроллерах домена.&lt;br /&gt;
# Настройте выполнение расширения с повышенными привилегиями.&lt;br /&gt;
# Создайте конфигурацию мониторинга и выберите контроллеры домена.&lt;br /&gt;
# Включите необходимые функциональные наборы.&lt;br /&gt;
# Сохраните конфигурацию и проверьте её состояние.&lt;br /&gt;
&lt;br /&gt;
== Настройка привилегий ==&lt;br /&gt;
&lt;br /&gt;
Для получения данных из WMI, реестра Windows и PowerShell расширению требуются повышенные привилегии. Можно использовать один из двух вариантов.&lt;br /&gt;
&lt;br /&gt;
=== Выполнение от имени LOCAL SYSTEM ===&lt;br /&gt;
&lt;br /&gt;
Это рекомендуемый вариант.&lt;br /&gt;
&lt;br /&gt;
В файле &amp;lt;code&amp;gt;&amp;amp;lt;каталог_данных_ЕдиногоАгента&amp;amp;gt;\agent\config\extensionsuser.conf&amp;lt;/code&amp;gt; добавьте расширение в список компонентов, запускаемых с повышенными привилегиями:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
elevated_privileges_extensions=[ru.ruscomtech.extension.active-directory-python:*]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Если файл уже содержит настройки других расширений, не удаляйте существующие записи.&lt;br /&gt;
&lt;br /&gt;
После изменения конфигурации перезапустите ЕдиныйАгент.&lt;br /&gt;
&lt;br /&gt;
=== Выполнение от имени отдельного пользователя ===&lt;br /&gt;
&lt;br /&gt;
В конфигурации расширения включите параметр &amp;lt;code&amp;gt;Provide custom user account&amp;lt;/code&amp;gt; и укажите учётные данные в формате &amp;lt;code&amp;gt;domain\username&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Учётной записи необходимы:&lt;br /&gt;
&lt;br /&gt;
* право локального входа на контроллер домена;&lt;br /&gt;
* право &amp;lt;code&amp;gt;KEY_READ&amp;lt;/code&amp;gt; для раздела реестра &amp;lt;code&amp;gt;HKLM\SYSTEM\CurrentControlSet\Services\NTDS\Parameters&amp;lt;/code&amp;gt;;&lt;br /&gt;
* членство в группе &amp;lt;code&amp;gt;DHCP Users&amp;lt;/code&amp;gt;, если включён сбор статистики областей DHCP;&lt;br /&gt;
* доступ к используемым WMI-классам и командам PowerShell.&lt;br /&gt;
&lt;br /&gt;
Пароль указывается в секретном поле конфигурации.&lt;br /&gt;
&lt;br /&gt;
== Токен API ==&lt;br /&gt;
&lt;br /&gt;
Для автоматического создания правил мониторинга служб и сбора журналов создайте отдельный токен API со следующими правами:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;settings.read&amp;lt;/code&amp;gt;;&lt;br /&gt;
* &amp;lt;code&amp;gt;settings.write&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Укажите токен в поле &amp;lt;code&amp;gt;API key&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Рекомендуется использовать отдельный токен только для этого расширения. Без токена основные метрики WMI и PowerShell могут собираться, но правила мониторинга служб и журналов автоматически созданы не будут.&lt;br /&gt;
&lt;br /&gt;
== Конфигурация ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Параметр&lt;br /&gt;
! Значение по умолчанию&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
|Provide custom user account&lt;br /&gt;
|Отключено&lt;br /&gt;
|Позволяет запускать проверки от имени указанного пользователя вместо &amp;lt;code&amp;gt;LOCAL SYSTEM&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|Username&lt;br /&gt;
|—&lt;br /&gt;
|Имя пользователя в формате &amp;lt;code&amp;gt;domain\username&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|Password&lt;br /&gt;
|—&lt;br /&gt;
|Пароль пользователя. Хранится как секрет.&lt;br /&gt;
|-&lt;br /&gt;
|API key&lt;br /&gt;
|—&lt;br /&gt;
|Токен с правами &amp;lt;code&amp;gt;settings.read&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;settings.write&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|Collection Frequency&lt;br /&gt;
|1 минута&lt;br /&gt;
|Интервал сбора данных. Для больших доменов рекомендуется увеличить его, чтобы все проверки успевали завершиться.&lt;br /&gt;
|-&lt;br /&gt;
|Log level&lt;br /&gt;
|INFO&lt;br /&gt;
|Уровень журналирования расширения. Значение &amp;lt;code&amp;gt;DEBUG&amp;lt;/code&amp;gt; следует использовать только при диагностике.&lt;br /&gt;
|-&lt;br /&gt;
|Enable Log Ingestion&lt;br /&gt;
|Включено&lt;br /&gt;
|Создаёт правила сбора журналов Active Directory и связанных системных журналов.&lt;br /&gt;
|-&lt;br /&gt;
|OS Service Monitoring&lt;br /&gt;
|Включено&lt;br /&gt;
|Создаёт правила контроля состояния выбранных служб Windows.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Мониторинг служб ==&lt;br /&gt;
&lt;br /&gt;
Расширение позволяет контролировать следующие службы:&lt;br /&gt;
&lt;br /&gt;
* Active Directory Web Services;&lt;br /&gt;
* DFS и DFS Replication;&lt;br /&gt;
* DNS Server и DNS Cache;&lt;br /&gt;
* Group Policy Service;&lt;br /&gt;
* Intersite Messaging;&lt;br /&gt;
* Key Distribution Center;&lt;br /&gt;
* NetLogon;&lt;br /&gt;
* Windows Time;&lt;br /&gt;
* Remote Procedure Call;&lt;br /&gt;
* Event System;&lt;br /&gt;
* Security Account Manager;&lt;br /&gt;
* Directory Services;&lt;br /&gt;
* Internet Information Services;&lt;br /&gt;
* SMTP;&lt;br /&gt;
* Active Directory Certificate Services и Online Responder.&lt;br /&gt;
&lt;br /&gt;
Отключите службы, которые не установлены на контроллере домена. Это уменьшит количество ошибок в журнале расширения.&lt;br /&gt;
&lt;br /&gt;
== Сбор журналов ==&lt;br /&gt;
&lt;br /&gt;
При включённом параметре &amp;lt;code&amp;gt;Enable Log Ingestion&amp;lt;/code&amp;gt; расширение создаёт правила для журналов:&lt;br /&gt;
&lt;br /&gt;
* Active Directory Web Services;&lt;br /&gt;
* DFS Replication;&lt;br /&gt;
* Directory Service;&lt;br /&gt;
* DNS Server;&lt;br /&gt;
* Windows Application Log;&lt;br /&gt;
* Windows System Log;&lt;br /&gt;
* Security.&lt;br /&gt;
&lt;br /&gt;
Также создаются фильтры для событий AD FS, Kerberos, DHCP, DNS, службы времени, центра сертификации и других компонентов Active Directory.&lt;br /&gt;
&lt;br /&gt;
== Функциональные наборы ==&lt;br /&gt;
&lt;br /&gt;
Включайте только те наборы, которые соответствуют ролям контроллера домена.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Набор&lt;br /&gt;
! Назначение&lt;br /&gt;
|-&lt;br /&gt;
|Host&lt;br /&gt;
|Использование процессора и ресурсов службами Active Directory.&lt;br /&gt;
|-&lt;br /&gt;
|DNS&lt;br /&gt;
|Запросы, ответы, ошибки, динамические обновления и использование памяти DNS.&lt;br /&gt;
|-&lt;br /&gt;
|DHCPv4 и DHCPv6&lt;br /&gt;
|Запросы, освобождения адресов, отклонения и показатели отказоустойчивости DHCP.&lt;br /&gt;
|-&lt;br /&gt;
|DHCPv4 Scopes и DHCPv6 Scopes&lt;br /&gt;
|Свободные, используемые и зарезервированные адреса в областях DHCP.&lt;br /&gt;
|-&lt;br /&gt;
|LDAP&lt;br /&gt;
|Время привязки, доступность LDAP, активные потоки, сеансы и операции.&lt;br /&gt;
|-&lt;br /&gt;
|DFS Folders и DFS Connections&lt;br /&gt;
|Состояние реплицируемых папок и соединений DFS.&lt;br /&gt;
|-&lt;br /&gt;
|Database&lt;br /&gt;
|Добавление, изменение, удаление и восстановление объектов каталога.&lt;br /&gt;
|-&lt;br /&gt;
|ESENT Database&lt;br /&gt;
|Операции чтения и записи базы данных и журнала ESENT.&lt;br /&gt;
|-&lt;br /&gt;
|Database Disk&lt;br /&gt;
|Объём диска и свободное место для базы данных Active Directory.&lt;br /&gt;
|-&lt;br /&gt;
|ATQ&lt;br /&gt;
|Очереди, задержки, потоки и средняя загрузка ATQ.&lt;br /&gt;
|-&lt;br /&gt;
|DRA&lt;br /&gt;
|Состояние запросов синхронизации Directory Replication Agent.&lt;br /&gt;
|-&lt;br /&gt;
|Network и Network Adapter&lt;br /&gt;
|Сетевые входы, состояние адаптеров и связанные показатели.&lt;br /&gt;
|-&lt;br /&gt;
|NTLM&lt;br /&gt;
|Количество привязок NTLM.&lt;br /&gt;
|-&lt;br /&gt;
|Domain Controller Overview&lt;br /&gt;
|Репликация, FSMO, SYSVOL, расхождение времени и общее состояние контроллера домена.&lt;br /&gt;
|-&lt;br /&gt;
|Replication Summary&lt;br /&gt;
|Ошибки и задержки репликации между источниками и получателями.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Основные метрики ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Метрика&lt;br /&gt;
! Описание&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.replication.consistency.status&amp;lt;/code&amp;gt;&lt;br /&gt;
|Состояние согласованности репликации.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.replication.partner.count.total&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество партнёров репликации.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.replication.queue.count.total&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество операций в очереди репликации.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.replication.destination.errors&amp;lt;/code&amp;gt;&lt;br /&gt;
|Ошибки репликации на стороне получателя.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.replication.source.errors&amp;lt;/code&amp;gt;&lt;br /&gt;
|Ошибки репликации на стороне источника.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.timeskew.secs&amp;lt;/code&amp;gt;&lt;br /&gt;
|Расхождение системного времени в секундах.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.fsmo.check&amp;lt;/code&amp;gt;&lt;br /&gt;
|Результат проверки держателей ролей FSMO.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.sysvol.health&amp;lt;/code&amp;gt;&lt;br /&gt;
|Состояние SYSVOL.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.ldap.bind.availability&amp;lt;/code&amp;gt;&lt;br /&gt;
|Доступность операции привязки LDAP.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.database.diskfree&amp;lt;/code&amp;gt;&lt;br /&gt;
|Доля свободного места на диске с базой данных Active Directory.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.atq.server.average.thread.usage&amp;lt;/code&amp;gt;&lt;br /&gt;
|Средняя загрузка потоков ATQ.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Шаблоны оповещений ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Оповещение&lt;br /&gt;
! Условие по умолчанию&lt;br /&gt;
|-&lt;br /&gt;
|Расхождение времени&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.timeskew.secs&amp;lt;/code&amp;gt; превышает 120 секунд.&lt;br /&gt;
|-&lt;br /&gt;
|Свободное место базы данных&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.database.diskfree&amp;lt;/code&amp;gt; ниже 15%.&lt;br /&gt;
|-&lt;br /&gt;
|Загрузка потоков ATQ&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.atq.server.average.thread.usage&amp;lt;/code&amp;gt; превышает 80%.&lt;br /&gt;
|-&lt;br /&gt;
|Согласованность репликации&lt;br /&gt;
|&amp;lt;code&amp;gt;active-directory.replication.consistency.status&amp;lt;/code&amp;gt; ниже 1.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Пороговые значения можно изменить после установки расширения.&lt;br /&gt;
&lt;br /&gt;
== Проверка конфигурации ==&lt;br /&gt;
&lt;br /&gt;
После сохранения конфигурации:&lt;br /&gt;
&lt;br /&gt;
# Убедитесь, что состояние расширения отображается как успешное.&lt;br /&gt;
# Дождитесь не менее двух интервалов сбора.&lt;br /&gt;
# Откройте обзорную панель Microsoft Active Directory.&lt;br /&gt;
# Проверьте наличие метрик репликации, LDAP и состояния контроллеров домена.&lt;br /&gt;
# Если включён сбор журналов, убедитесь, что поступают события Windows.&lt;br /&gt;
# Проверьте создание правил мониторинга выбранных служб.&lt;br /&gt;
&lt;br /&gt;
== Диагностика ==&lt;br /&gt;
&lt;br /&gt;
=== Ошибка доступа к WMI или PowerShell ===&lt;br /&gt;
&lt;br /&gt;
Убедитесь, что расширение выполняется от имени &amp;lt;code&amp;gt;LOCAL SYSTEM&amp;lt;/code&amp;gt; или указанной учётной записи предоставлены необходимые права.&lt;br /&gt;
&lt;br /&gt;
=== Не собираются метрики DHCP, DNS или DFS ===&lt;br /&gt;
&lt;br /&gt;
Проверьте, что соответствующая роль установлена на сервере. Если роль не используется, отключите связанный функциональный набор.&lt;br /&gt;
&lt;br /&gt;
=== Не создаются правила мониторинга служб или журналов ===&lt;br /&gt;
&lt;br /&gt;
Проверьте токен API и наличие прав &amp;lt;code&amp;gt;settings.read&amp;lt;/code&amp;gt; и &amp;lt;code&amp;gt;settings.write&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Дублируются метрики ===&lt;br /&gt;
&lt;br /&gt;
Отключите предыдущие расширения мониторинга Active Directory, если они установлены на тех же контроллерах домена.&lt;br /&gt;
&lt;br /&gt;
== История версий ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|5.1.1&lt;br /&gt;
|&lt;br /&gt;
* Версия расширения для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.290.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Добавлена возможность запуска проверок от имени отдельного привилегированного пользователя.&lt;br /&gt;
* Для токена API больше не требуется право &amp;lt;code&amp;gt;entities.read&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Исправлена обработка символов, не соответствующих UTF-8, в результатах WMI-запросов.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_SSL-%D1%81%D0%B5%D1%80%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D0%B2&amp;diff=6711</id>
		<title>Мониторинг SSL-сертификатов</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_SSL-%D1%81%D0%B5%D1%80%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D0%B2&amp;diff=6711"/>
		<updated>2026-09-17T20:47:28Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&#039;&#039;&#039;&#039;&#039;[[Расширения]] / [[Расширения#.D0.A0.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F%202.0|Расширения 2.0]] / Мониторинг SSL-сертификатов&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
== Обзор ==&lt;br /&gt;
Расширение SSL Certificate Monitor можно развернуть на АктивномШлюзе или на любом хосте с установленным ЕдинымАгентом.&lt;br /&gt;
&lt;br /&gt;
Оба типа развертываний имеют настраиваемые интервалы оповещений, что позволяет выявлять проблемы низкой степени серьезности для сертификатов в определяемом пользователем окне продления, а также оповещения высокой степени серьезности при скором приближении даты истечения срока действия.&lt;br /&gt;
&lt;br /&gt;
При развертывании на АктивномШлюзе расширение можно настроить для выполнения проверок сертификатов, указав определенные домены для проверки.&lt;br /&gt;
&lt;br /&gt;
При развертывании на ЕдиномАгенте расширение попытается автоматически обнаружить сертификат, используя данные, предоставленные ЕдиномуАгенту.&lt;br /&gt;
&lt;br /&gt;
Поддерживаемая версия кластера для запуска расширения &amp;gt; 1.272&lt;br /&gt;
&lt;br /&gt;
== Начало ==&lt;br /&gt;
&lt;br /&gt;
==== Мониторинг удаленно ====&lt;br /&gt;
Целью развертывания удаленного мониторинга является включение мониторинга сертификатов по URL-адресу. Этот тип мониторинга требует, чтобы АктивныйШлюз, на котором работает расширение, имел доступ к предоставленным URL-адресам. Могут потребоваться корректировки правил сети и брандмауэра. При выборе этой модели развертывания обнаружение сертификатов отключается, и для включения мониторинга сертификатов необходимо предоставить список URL-адресов.&lt;br /&gt;
&lt;br /&gt;
Выберите « Удаленный мониторинг без ЕдиногоАнента», чтобы выбрать этот тип установки, и выберите группу АктивногоШлюза, в которой вы хотите, чтобы расширение запускалось.&lt;br /&gt;
&lt;br /&gt;
==== Мониторинг локально ====&lt;br /&gt;
Для автоматического обнаружения сертификатов с помощью ЕдиногоАгента требуется локальный мониторинг. Расширение будет установлено на выбранных хостах. В настоящее время хосты можно выбирать по имени, группе хостов, зоне управления или тегу (с помощью конфигурации &#039;&#039;среды&#039;&#039; ).&lt;br /&gt;
&lt;br /&gt;
После выбора варианта развертывания приступайте к настройке расширения.&lt;br /&gt;
&lt;br /&gt;
== Подробности ==&lt;br /&gt;
&lt;br /&gt;
=== Конфигурация ===&lt;br /&gt;
&lt;br /&gt;
==== общие настройки ====&lt;br /&gt;
Срок действия сертификата неизбежен: самый высокий уровень оповещения, указывающий на то, что срок действия сертификата приближается. Превышение этого порога вызывает проблему серьезности &amp;lt;code&amp;gt;AVAILABILITY&amp;lt;/code&amp;gt;. Сертификаты с истекшим сроком действия также будут выдаваться на этом уровне оповещения.&lt;br /&gt;
&lt;br /&gt;
Скоро истечет: начальный уровень оповещения. Превышение этого порога вызывает проблему серьезности &amp;lt;code&amp;gt;ERROR&amp;lt;/code&amp;gt;. Дата сертификата &amp;lt;code&amp;gt;not_valid_after&amp;lt;/code&amp;gt;требует внимания, но срок его действия еще не близок.&lt;br /&gt;
&lt;br /&gt;
Интервал между обнаружением сертификата и проверкой метаданных (часы): частота, с которой расширение будет обновлять обнаруженные сертификаты и обрабатывать доступные данные. Во время первоначальной настройки и тестирования может подойти меньшее значение. После полной настройки расширения рекомендуется интервал в 8 часов.&lt;br /&gt;
&lt;br /&gt;
Помимо определения частоты обнаружения сертификатов и обновления метаданных, интервал проверки определяет, как разрешаются проблемы. Все проблемы с сертификатами останутся открытыми до тех пор, пока проверка сертификата не подтвердит, что проблема решена. Интервал в 24 часа приведет к тому, что проблема с сертификатом будет оставаться открытой как минимум 24 часа. Проблема не будет решена до тех пор, пока следующая проверка не определит, решена ли проблема.&lt;br /&gt;
&lt;br /&gt;
Экраны унифицированного анализа и метрика состояния сертификата. Экраны унифицированного анализа содержат метаданные обо всех обнаруженных сертификатах. Для этой функции требуется сбор данных с использованием метрики статуса сертификата ( &amp;lt;code&amp;gt;certificate.monitor.status&amp;lt;/code&amp;gt;). Для удобства работы рекомендуется  &#039;&#039;включить сбор метрик&#039;&#039; . Если этот параметр отключен, функциональность расширения ограничивается созданием оповещений и регистрацией событий. Этот вариант использует метрики ВИД.&lt;br /&gt;
&lt;br /&gt;
Годовое потребление метрик ВИД рассчитывается по следующей формуле:  &amp;lt;code&amp;gt;&amp;lt;# обнаруженных сертификатов&amp;gt; x &amp;lt;24 / интервал проверки сертификатов (часы)&amp;gt; x 365 x 0.001&amp;lt;/code&amp;gt;. например, один сертификат, проверяемый каждые 8 ​​часов, будет потреблять  &amp;lt;code&amp;gt;~3 (1 x (24/3) x 365 x 0.001)&amp;lt;/code&amp;gt; метрик ВИД в год.&lt;br /&gt;
&lt;br /&gt;
==== Настройка диапазона портов ====&lt;br /&gt;
Дополнительная функция для определения инклюзивных и монопольных диапазонов портов во время обнаружения сертификата.&lt;br /&gt;
&lt;br /&gt;
Включаемый диапазон портов : диапазон портов можно выразить через дефис. Отдельные порты или группы портов могут быть разделены точкой с запятой. т.е.&amp;lt;code&amp;gt;443;1024-2000;50000-51000&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Диапазон исключаемых портов : необязательный диапазон исключаемых портов. Этот параметр применяется после правила включения. Например, если порты &amp;lt;code&amp;gt;400-410&amp;lt;/code&amp;gt;включены &#039;&#039;,&#039;&#039; а порт &amp;lt;code&amp;gt;405&amp;lt;/code&amp;gt;исключен, результирующий набор портов будет &amp;lt;code&amp;gt;400-404&amp;lt;/code&amp;gt;и &amp;lt;code&amp;gt;406-410&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
==== Фильтрация процессов по типу технологии ====&lt;br /&gt;
Дополнительная настройка, позволяющая ограничить проверки сертификатов определенными типами технологий. Этот фильтр можно настроить так, чтобы он включал только перечисленные технологии или исключал перечисленные технологии из мониторинга.&lt;br /&gt;
&lt;br /&gt;
Добавить технологию : добавьте технологию в фильтр, определенный выше. Доступные типы технологий — это типы «Основной технологии», которые присутствуют в представлениях процессов. Некоторые процессы отображают несколько записей в разделе «Основная технология». Фильтр типа технологии использует &amp;lt;code&amp;gt;OR&amp;lt;/code&amp;gt;логику. Процесс, в котором в качестве основных технологий указаны «IIS, пул приложений IIS и .NET», будет отслеживаться, если в этот фильтр будет добавлена ​​какая-либо комбинация технологий.&lt;br /&gt;
&lt;br /&gt;
==== Добавить дополнительные домены SNI ====&lt;br /&gt;
Дополнительный параметр для настройки дополнительных доменов SNI (индикация имени сервера).&lt;br /&gt;
&lt;br /&gt;
Добавить домен : расширенный параметр, позволяющий предоставить список доменов для использования с &#039;&#039;указанием имени сервера&#039;&#039; . SNI — это расширение протокола TLS, который используется в HTTPS. Используйте этот параметр, чтобы указать доменное имя веб-сайта во время первоначального подтверждения TLS, а не при открытии соединения HTTPS после подтверждения.&lt;br /&gt;
&lt;br /&gt;
==== Записать статус сертификата ====&lt;br /&gt;
Интервал регистрации состояния сертификата : расширение будет регистрировать метаданные событий, когда сертификат находится в состоянии предупреждения. Кроме того, расширение также будет периодически регистрировать метаданные сертификатов в работоспособном состоянии. Цель этого параметра — предоставить возможность запрашивать метаданные сертификата независимо от состояния работоспособности сертификата.&lt;br /&gt;
&lt;br /&gt;
==== Проверка хостов по доменному имени ====&lt;br /&gt;
Необязательный список доменов для прямой проверки. Расширение попытается открыть соединение с предоставленными доменами. Для этой функции требуется, чтобы хост расширения мог установить соединение с доменом.  &#039;&#039;В настоящее время находится в ранней предварительной версии. Контролируйте домен только в одной локальной конфигурации мониторинга. В большинстве случаев рекомендуется развертывать это расширение удаленно (на АктивномШлюзе) для мониторинга на основе домена.&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Добавить домен : при необходимости укажите список доменов, которые расширение будет проверять напрямую.&lt;br /&gt;
&lt;br /&gt;
==== Включить отладку ====&lt;br /&gt;
Установите этот флажок, чтобы включить ведение журнала уровня отладки. &lt;br /&gt;
&lt;br /&gt;
== Информация о совместимости ==&lt;br /&gt;
Автоматическое обнаружение основано на отслеживаемых ЕдинымАгентом процессах, имеющих метаданные «прослушивающего порта». В случаях, когда информация о порте недоступна, автоматическое обнаружение не удастся. В будущих версиях поддержка будет расширена, чтобы охватить более широкий спектр сценариев.&lt;br /&gt;
&lt;br /&gt;
Поддержка автоматического обнаружения сертификатов на веб-серверах IIS в настоящее время находится на экспериментальной стадии.&lt;br /&gt;
&lt;br /&gt;
== Поиск неисправностей ==&lt;br /&gt;
&lt;br /&gt;
=== Сбои автоматического обнаружения ===&lt;br /&gt;
Большинство сбоев автоматического обнаружения связано с отсутствием метаданных «Порт» в процессах, контролируемых Ключ-АСТРОМ. Если автоматическое обнаружение не удалось, функция «Мониторинг по домену» будет охватывать некоторые сценарии. Эта функция позволяет отслеживать сертификаты по имени домена.&lt;br /&gt;
&lt;br /&gt;
В будущих версиях автоматическое обнаружение будет расширено, чтобы охватить более широкий спектр сценариев.&lt;br /&gt;
&lt;br /&gt;
== Содержание расширения ==&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|+&lt;br /&gt;
!Тип содержимого&lt;br /&gt;
!Количество включенных предметов&lt;br /&gt;
|-&lt;br /&gt;
|Screen Injections&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Screen Logs Cards&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Screen Chart Groups&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Screen Layout&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Generic Relationship&lt;br /&gt;
|4&lt;br /&gt;
|-&lt;br /&gt;
|Screen Properties&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Dashboards&lt;br /&gt;
|1&lt;br /&gt;
|-&lt;br /&gt;
|Screen Actions&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Screen Entities Lists&lt;br /&gt;
|5&lt;br /&gt;
|-&lt;br /&gt;
|List Screen Layout&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Metric Metadata&lt;br /&gt;
|1&lt;br /&gt;
|-&lt;br /&gt;
|Generic Type&lt;br /&gt;
|2&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Наборы функций ==&lt;br /&gt;
Ниже приведен полный список наборов функций, представленных в этой версии. Чтобы обеспечить хорошее соответствие вашим потребностям, отдельные метрики могут быть активированы и деактивированы вашим администратором во время настройки.&lt;br /&gt;
&lt;br /&gt;
Наборы функцийКоличество включенных показателей&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! colspan=&amp;quot;1&amp;quot; |Название метрики&lt;br /&gt;
! colspan=&amp;quot;1&amp;quot; |Ключ метрики&lt;br /&gt;
! colspan=&amp;quot;1&amp;quot; |Описание&lt;br /&gt;
! colspan=&amp;quot;1&amp;quot; |Единица&lt;br /&gt;
|-&lt;br /&gt;
|Certificate status&lt;br /&gt;
|certificate.monitor.status&lt;br /&gt;
|Статус обнаруженных сертификатов&lt;br /&gt;
|Количество&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== История версий ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|1.10.11&lt;br /&gt;
|&lt;br /&gt;
* Версия расширения для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.309.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Все операции с датой и временем переведены на единый формат с учётом часового пояса.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_SSL-%D1%81%D0%B5%D1%80%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D0%B2&amp;diff=6710</id>
		<title>Мониторинг SSL-сертификатов</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=%D0%9C%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3_SSL-%D1%81%D0%B5%D1%80%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D0%B2&amp;diff=6710"/>
		<updated>2026-09-17T20:46:55Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&#039;&#039;&#039;&#039;&#039;[[Расширения]] / [[Расширения#.D0.A0.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F%202.0|Расширения 2.0]] / Мониторинг SSL-сертификатов&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
== Обзор ==&lt;br /&gt;
Расширение SSL Certificate Monitor можно развернуть на АктивномШлюзе или на любом хосте с установленным ЕдинымАгентом.&lt;br /&gt;
&lt;br /&gt;
Оба типа развертываний имеют настраиваемые интервалы оповещений, что позволяет выявлять проблемы низкой степени серьезности для сертификатов в определяемом пользователем окне продления, а также оповещения высокой степени серьезности при скором приближении даты истечения срока действия.&lt;br /&gt;
&lt;br /&gt;
При развертывании на АктивномШлюзе расширение можно настроить для выполнения проверок сертификатов, указав определенные домены для проверки.&lt;br /&gt;
&lt;br /&gt;
При развертывании на ЕдиномАгенте расширение попытается автоматически обнаружить сертификат, используя данные, предоставленные ЕдиномуАгенту.&lt;br /&gt;
&lt;br /&gt;
Поддерживаемая версия кластера для запуска расширения &amp;gt; 1.272&lt;br /&gt;
&lt;br /&gt;
== Начало ==&lt;br /&gt;
&lt;br /&gt;
==== Мониторинг удаленно ====&lt;br /&gt;
Целью развертывания удаленного мониторинга является включение мониторинга сертификатов по URL-адресу. Этот тип мониторинга требует, чтобы АктивныйШлюз, на котором работает расширение, имел доступ к предоставленным URL-адресам. Могут потребоваться корректировки правил сети и брандмауэра. При выборе этой модели развертывания обнаружение сертификатов отключается, и для включения мониторинга сертификатов необходимо предоставить список URL-адресов.&lt;br /&gt;
&lt;br /&gt;
Выберите « Удаленный мониторинг без ЕдиногоАнента», чтобы выбрать этот тип установки, и выберите группу АктивногоШлюза, в которой вы хотите, чтобы расширение запускалось.&lt;br /&gt;
&lt;br /&gt;
==== Мониторинг локально ====&lt;br /&gt;
Для автоматического обнаружения сертификатов с помощью ЕдиногоАгента требуется локальный мониторинг. Расширение будет установлено на выбранных хостах. В настоящее время хосты можно выбирать по имени, группе хостов, зоне управления или тегу (с помощью конфигурации &#039;&#039;среды&#039;&#039; ).&lt;br /&gt;
&lt;br /&gt;
После выбора варианта развертывания приступайте к настройке расширения.&lt;br /&gt;
&lt;br /&gt;
== Подробности ==&lt;br /&gt;
&lt;br /&gt;
=== Конфигурация ===&lt;br /&gt;
&lt;br /&gt;
==== общие настройки ====&lt;br /&gt;
Срок действия сертификата неизбежен: самый высокий уровень оповещения, указывающий на то, что срок действия сертификата приближается. Превышение этого порога вызывает проблему серьезности &amp;lt;code&amp;gt;AVAILABILITY&amp;lt;/code&amp;gt;. Сертификаты с истекшим сроком действия также будут выдаваться на этом уровне оповещения.&lt;br /&gt;
&lt;br /&gt;
Скоро истечет: начальный уровень оповещения. Превышение этого порога вызывает проблему серьезности &amp;lt;code&amp;gt;ERROR&amp;lt;/code&amp;gt;. Дата сертификата &amp;lt;code&amp;gt;not_valid_after&amp;lt;/code&amp;gt;требует внимания, но срок его действия еще не близок.&lt;br /&gt;
&lt;br /&gt;
Интервал между обнаружением сертификата и проверкой метаданных (часы): частота, с которой расширение будет обновлять обнаруженные сертификаты и обрабатывать доступные данные. Во время первоначальной настройки и тестирования может подойти меньшее значение. После полной настройки расширения рекомендуется интервал в 8 часов.&lt;br /&gt;
&lt;br /&gt;
Помимо определения частоты обнаружения сертификатов и обновления метаданных, интервал проверки определяет, как разрешаются проблемы. Все проблемы с сертификатами останутся открытыми до тех пор, пока проверка сертификата не подтвердит, что проблема решена. Интервал в 24 часа приведет к тому, что проблема с сертификатом будет оставаться открытой как минимум 24 часа. Проблема не будет решена до тех пор, пока следующая проверка не определит, решена ли проблема.&lt;br /&gt;
&lt;br /&gt;
Экраны унифицированного анализа и метрика состояния сертификата. Экраны унифицированного анализа содержат метаданные обо всех обнаруженных сертификатах. Для этой функции требуется сбор данных с использованием метрики статуса сертификата ( &amp;lt;code&amp;gt;certificate.monitor.status&amp;lt;/code&amp;gt;). Для удобства работы рекомендуется  &#039;&#039;включить сбор метрик&#039;&#039; . Если этот параметр отключен, функциональность расширения ограничивается созданием оповещений и регистрацией событий. Этот вариант использует метрики ВИД.&lt;br /&gt;
&lt;br /&gt;
Годовое потребление метрик ВИД рассчитывается по следующей формуле:  &amp;lt;code&amp;gt;&amp;lt;# обнаруженных сертификатов&amp;gt; x &amp;lt;24 / интервал проверки сертификатов (часы)&amp;gt; x 365 x 0.001&amp;lt;/code&amp;gt;. например, один сертификат, проверяемый каждые 8 ​​часов, будет потреблять  &amp;lt;code&amp;gt;~3 (1 x (24/3) x 365 x 0.001)&amp;lt;/code&amp;gt; метрик ВИД в год.&lt;br /&gt;
&lt;br /&gt;
==== Настройка диапазона портов ====&lt;br /&gt;
Дополнительная функция для определения инклюзивных и монопольных диапазонов портов во время обнаружения сертификата.&lt;br /&gt;
&lt;br /&gt;
Включаемый диапазон портов : диапазон портов можно выразить через дефис. Отдельные порты или группы портов могут быть разделены точкой с запятой. т.е.&amp;lt;code&amp;gt;443;1024-2000;50000-51000&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Диапазон исключаемых портов : необязательный диапазон исключаемых портов. Этот параметр применяется после правила включения. Например, если порты &amp;lt;code&amp;gt;400-410&amp;lt;/code&amp;gt;включены &#039;&#039;,&#039;&#039; а порт &amp;lt;code&amp;gt;405&amp;lt;/code&amp;gt;исключен, результирующий набор портов будет &amp;lt;code&amp;gt;400-404&amp;lt;/code&amp;gt;и &amp;lt;code&amp;gt;406-410&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
==== Фильтрация процессов по типу технологии ====&lt;br /&gt;
Дополнительная настройка, позволяющая ограничить проверки сертификатов определенными типами технологий. Этот фильтр можно настроить так, чтобы он включал только перечисленные технологии или исключал перечисленные технологии из мониторинга.&lt;br /&gt;
&lt;br /&gt;
Добавить технологию : добавьте технологию в фильтр, определенный выше. Доступные типы технологий — это типы «Основной технологии», которые присутствуют в представлениях процессов. Некоторые процессы отображают несколько записей в разделе «Основная технология». Фильтр типа технологии использует &amp;lt;code&amp;gt;OR&amp;lt;/code&amp;gt;логику. Процесс, в котором в качестве основных технологий указаны «IIS, пул приложений IIS и .NET», будет отслеживаться, если в этот фильтр будет добавлена ​​какая-либо комбинация технологий.&lt;br /&gt;
&lt;br /&gt;
==== Добавить дополнительные домены SNI ====&lt;br /&gt;
Дополнительный параметр для настройки дополнительных доменов SNI (индикация имени сервера).&lt;br /&gt;
&lt;br /&gt;
Добавить домен : расширенный параметр, позволяющий предоставить список доменов для использования с &#039;&#039;указанием имени сервера&#039;&#039; . SNI — это расширение протокола TLS, который используется в HTTPS. Используйте этот параметр, чтобы указать доменное имя веб-сайта во время первоначального подтверждения TLS, а не при открытии соединения HTTPS после подтверждения.&lt;br /&gt;
&lt;br /&gt;
==== Записать статус сертификата ====&lt;br /&gt;
Интервал регистрации состояния сертификата : расширение будет регистрировать метаданные событий, когда сертификат находится в состоянии предупреждения. Кроме того, расширение также будет периодически регистрировать метаданные сертификатов в работоспособном состоянии. Цель этого параметра — предоставить возможность запрашивать метаданные сертификата независимо от состояния работоспособности сертификата.&lt;br /&gt;
&lt;br /&gt;
==== Проверка хостов по доменному имени ====&lt;br /&gt;
Необязательный список доменов для прямой проверки. Расширение попытается открыть соединение с предоставленными доменами. Для этой функции требуется, чтобы хост расширения мог установить соединение с доменом.  &#039;&#039;В настоящее время находится в ранней предварительной версии. Контролируйте домен только в одной локальной конфигурации мониторинга. В большинстве случаев рекомендуется развертывать это расширение удаленно (на АктивномШлюзе) для мониторинга на основе домена.&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
Добавить домен : при необходимости укажите список доменов, которые расширение будет проверять напрямую.&lt;br /&gt;
&lt;br /&gt;
==== Включить отладку ====&lt;br /&gt;
Установите этот флажок, чтобы включить ведение журнала уровня отладки. &lt;br /&gt;
&lt;br /&gt;
== Информация о совместимости ==&lt;br /&gt;
Автоматическое обнаружение основано на отслеживаемых ЕдинымАгентом процессах, имеющих метаданные «прослушивающего порта». В случаях, когда информация о порте недоступна, автоматическое обнаружение не удастся. В будущих версиях поддержка будет расширена, чтобы охватить более широкий спектр сценариев.&lt;br /&gt;
&lt;br /&gt;
Поддержка автоматического обнаружения сертификатов на веб-серверах IIS в настоящее время находится на экспериментальной стадии.&lt;br /&gt;
&lt;br /&gt;
== Поиск неисправностей ==&lt;br /&gt;
&lt;br /&gt;
=== Сбои автоматического обнаружения ===&lt;br /&gt;
Большинство сбоев автоматического обнаружения связано с отсутствием метаданных «Порт» в процессах, контролируемых Ключ-АСТРОМ. Если автоматическое обнаружение не удалось, функция «Мониторинг по домену» будет охватывать некоторые сценарии. Эта функция позволяет отслеживать сертификаты по имени домена.&lt;br /&gt;
&lt;br /&gt;
В будущих версиях автоматическое обнаружение будет расширено, чтобы охватить более широкий спектр сценариев.&lt;br /&gt;
&lt;br /&gt;
== Содержание расширения ==&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|+&lt;br /&gt;
!Тип содержимого&lt;br /&gt;
!Количество включенных предметов&lt;br /&gt;
|-&lt;br /&gt;
|Screen Injections&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Screen Logs Cards&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Screen Chart Groups&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Screen Layout&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Generic Relationship&lt;br /&gt;
|4&lt;br /&gt;
|-&lt;br /&gt;
|Screen Properties&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Dashboards&lt;br /&gt;
|1&lt;br /&gt;
|-&lt;br /&gt;
|Screen Actions&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Screen Entities Lists&lt;br /&gt;
|5&lt;br /&gt;
|-&lt;br /&gt;
|List Screen Layout&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Metric Metadata&lt;br /&gt;
|1&lt;br /&gt;
|-&lt;br /&gt;
|Generic Type&lt;br /&gt;
|2&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Наборы функций ==&lt;br /&gt;
Ниже приведен полный список наборов функций, представленных в этой версии. Чтобы обеспечить хорошее соответствие вашим потребностям, отдельные метрики могут быть активированы и деактивированы вашим администратором во время настройки.&lt;br /&gt;
&lt;br /&gt;
Наборы функцийКоличество включенных показателей&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! colspan=&amp;quot;1&amp;quot; |Название метрики&lt;br /&gt;
! colspan=&amp;quot;1&amp;quot; |Ключ метрики&lt;br /&gt;
! colspan=&amp;quot;1&amp;quot; |Описание&lt;br /&gt;
! colspan=&amp;quot;1&amp;quot; |Единица&lt;br /&gt;
|-&lt;br /&gt;
|Certificate status&lt;br /&gt;
|certificate.monitor.status&lt;br /&gt;
|Статус обнаруженных сертификатов&lt;br /&gt;
|Количество&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== История версий ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|1.10.11&lt;br /&gt;
|&lt;br /&gt;
* Адаптированная версия расширения для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.309.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Исправлена ошибка функции «Добавлять запись журнала для действующих сертификатов», вызванная смешением дат со сведениями о часовом поясе и без них.&lt;br /&gt;
* Все операции с датой и временем переведены на единый формат с учётом часового пояса.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=Generic_network_device&amp;diff=6709</id>
		<title>Generic network device</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=Generic_network_device&amp;diff=6709"/>
		<updated>2026-09-17T20:45:44Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&#039;&#039;&#039;&#039;&#039;[[Расширения]] / [[Расширения#.D0.A0.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F%202.0|Расширения 2.0]] / Generic network device&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
== Обзор ==&lt;br /&gt;
Это расширение использует протокол SNMP для предоставления комплексного решения для мониторинга сетевой инфраструктуры. Полная конфигурация предоставляется из коробки.&lt;br /&gt;
&lt;br /&gt;
== Это предназначено для пользователей, которые: ==&lt;br /&gt;
Хотят отслеживать состояние работоспособности и производительность своей базовой сетевой инфраструктуры и предоставлять унифицированный анализ для Ops, DevOps и ИТ-администраторов.&lt;br /&gt;
&lt;br /&gt;
== Это позволяет вам: ==&lt;br /&gt;
Отслеживать работоспособность и производительность сетевых устройств&lt;br /&gt;
&lt;br /&gt;
Настраивать оповещения для получения уведомлений об аномалиях трафика&lt;br /&gt;
&lt;br /&gt;
== Требования к совместимости ==&lt;br /&gt;
стандартные сетевые устройства, поддерживающие общие файлы MIB&lt;br /&gt;
&lt;br /&gt;
Поддерживаются только SNMPv2c и SNMPv3&lt;br /&gt;
&lt;br /&gt;
== Подробности ==&lt;br /&gt;
Это расширение создано на основе новой платформы Extension 2.0.&lt;br /&gt;
&lt;br /&gt;
== Пакет расширения содержит: ==&lt;br /&gt;
Конфигурация источника данных SNMP,&lt;br /&gt;
&lt;br /&gt;
шаблон панели мониторинга,&lt;br /&gt;
&lt;br /&gt;
шаблон экрана Unified Analysis,&lt;br /&gt;
&lt;br /&gt;
определение топологии и правила извлечения сущностей.&lt;br /&gt;
&lt;br /&gt;
== Начало работы ==&lt;br /&gt;
Просто активируйте расширение в своей среде с помощью встроенного концентратора продукта, укажите конфигурацию устройства, и все готово.&lt;br /&gt;
&lt;br /&gt;
Более подробную информацию можно найти в документации по расширению SNMP&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|+&lt;br /&gt;
!Тип контента&lt;br /&gt;
!Число включенных элементов&lt;br /&gt;
|-&lt;br /&gt;
|Вставки на экран&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Оповещения&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Карточки журналов экрана&lt;br /&gt;
|1&lt;br /&gt;
|-&lt;br /&gt;
|Макет экрана&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Запрос метрики&lt;br /&gt;
|11&lt;br /&gt;
|-&lt;br /&gt;
|Карточки сообщений экрана&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Группы диаграмм экрана&lt;br /&gt;
|5&lt;br /&gt;
|-&lt;br /&gt;
|Списки сущностей экрана&lt;br /&gt;
|1&lt;br /&gt;
|-&lt;br /&gt;
|Общие связи&lt;br /&gt;
|4&lt;br /&gt;
|-&lt;br /&gt;
|Панели мониторинга&lt;br /&gt;
|1&lt;br /&gt;
|-&lt;br /&gt;
|Метрические метаданные&lt;br /&gt;
|47&lt;br /&gt;
|-&lt;br /&gt;
|Свойства экрана&lt;br /&gt;
|3&lt;br /&gt;
|-&lt;br /&gt;
|Общий тип&lt;br /&gt;
|4&lt;br /&gt;
|}&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|+&lt;br /&gt;
| colspan=&amp;quot;3&amp;quot; |&#039;&#039;&#039;&#039;&#039;default&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|&#039;&#039;&#039;Metric name&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Description&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Unit&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|Time since the last re-start&lt;br /&gt;
|Время (в сотых долях секунды) с момента последней повторной инициализации управляющей части сети системы&lt;br /&gt;
|Unspecified&lt;br /&gt;
|-&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
|-&lt;br /&gt;
|Messages delivered&lt;br /&gt;
|Общее количество сообщений, доставленных от транспортной службы&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Messages passed&lt;br /&gt;
|Общее количество сообщений, переданных в транспортную службу&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Silently dropped PDUs&lt;br /&gt;
|Количество молча отброшенных PDU из-за слишком большого размера ответа&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Proxy dropped PDUs&lt;br /&gt;
|Количество молча отброшенных PDU по причинам, не связанным с таймаутом&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Unsupported SNMP version messages&lt;br /&gt;
|Общее количество сообщений, доставленных с неподдерживаемой версией SNMP&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Messages with bad community names&lt;br /&gt;
|Количество сообщений с неизвестным сообществом SNMP&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Messages not allowed in community&lt;br /&gt;
|Количество сообщений, не разрешенных для используемого сообщества SNMP&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|&#039;noSuchName&#039; errors&lt;br /&gt;
|Количество PDU, доставленных с ошибкой &amp;quot;noSuchName&amp;quot;&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|&#039;badValue&#039; errors&lt;br /&gt;
|Количество PDU, доставленных с ошибкой &amp;quot;badValue&amp;quot;&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Traps processed&lt;br /&gt;
|Общее количество SNMP Trap PDU, принятых и обработанных&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Traps generated&lt;br /&gt;
|Общее количество SNMP Trap PDU, сгенерированных&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
| colspan=&amp;quot;3&amp;quot; |&#039;&#039;&#039;&#039;&#039;Traffic&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|&#039;&#039;&#039;Metric name&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Description&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Unit&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|TCP active opens&lt;br /&gt;
|Количество переходов TCP-соединений из состояния CLOSED в состояние SYN-SENT&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP passive opens&lt;br /&gt;
|Количество переходов TCP-соединений из состояния CLOSED в состояние SYN-RCVD&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP failed attempts&lt;br /&gt;
|Количество переходов TCP-соединений из состояния SYN-SENT/SYN-RCVD в состояние CLOSED и из состояния SYN-RCVD в состояние LISTEN&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP resets&lt;br /&gt;
|Количество переходов TCP-соединений из состояния ESTABLISHED/CLOSE-WAIT в состояние CLOSED&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP connections&lt;br /&gt;
|Количество TCP-соединений в состоянии ESTABLISHED/CLOSE-WAIT&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP segments received&lt;br /&gt;
|Общее количество полученных сегментов (включая с ошибками)&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP segments sent&lt;br /&gt;
|Общее количество отправленных сегментов (исключая повторные передачи)&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP segments retransmitted&lt;br /&gt;
|Общее количество повторно переданных сегментов&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP segment errors&lt;br /&gt;
|Общее количество сегментов, полученных с ошибкой&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP segment resets&lt;br /&gt;
|Количество отправленных TCP-сегментов с установленным флагом RST&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|UDP datagrams delivered&lt;br /&gt;
|Общее количество доставленных UDP-дейтаграмм&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|UDP datagrams received without port&lt;br /&gt;
|Количество полученных UDP-дейтаграмм (нет приложения на целевом порту)&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|UDP datagram errors&lt;br /&gt;
|Количество полученных и недоставленных UDP-дейтаграмм (не связанных с отсутствием приложения на целевом порту)&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|UDP datagrams sent&lt;br /&gt;
|Общее количество отправленных UDP-дейтаграмм&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
| colspan=&amp;quot;3&amp;quot; |&#039;&#039;&#039;&#039;&#039;Interfaces&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|&#039;&#039;&#039;Metric name&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Description&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Unit&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
|-&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
|-&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
|-&lt;br /&gt;
|Last interface status change&lt;br /&gt;
|Значение &#039;sysUpTime&#039; на момент, когда интерфейс перешел в текущее состояние&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Interface speed&lt;br /&gt;
|Скорость сетевого интерфейса в Мегабитах в секунду&lt;br /&gt;
|MegaBitPerSecond&lt;br /&gt;
|-&lt;br /&gt;
|Inbound errors&lt;br /&gt;
|Количество входящих пакетов/единиц передачи с ошибками&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Inbound discards&lt;br /&gt;
|Количество отброшенных входящих пакетов&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Outbound errors&lt;br /&gt;
|Количество исходящих пакетов/единиц передачи с ошибками&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Outbound discards&lt;br /&gt;
|Количество отброшенных исходящих пакетов&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
| colspan=&amp;quot;3&amp;quot; |&#039;&#039;&#039;&#039;&#039;Interfaces 64-bit&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|&#039;&#039;&#039;Metric name&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Description&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Unit&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|Octets received (high capacity)&lt;br /&gt;
|Общее количество октетов, полученных на интерфейсе, включая фрейминг. Этот показатель использует 64-битный счетчик и должен использоваться для высокоскоростных устройств&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Octets transmitted (high capacity)&lt;br /&gt;
|Общее количество октетов, переданных через интерфейс, включая фрейминг. Этот показатель использует 64-битный счетчик и должен использоваться для высокоскоростных устройств&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
| colspan=&amp;quot;3&amp;quot; |&#039;&#039;&#039;&#039;&#039;Interfaces 32-bit&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|&#039;&#039;&#039;Metric name&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Description&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Unit&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|Octets received&lt;br /&gt;
|Общее количество октетов, полученных на интерфейсе, включая фрейминг&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Octets transmitted&lt;br /&gt;
|Общее количество октетов, переданных через интерфейс, включая фрейминг&lt;br /&gt;
|Count&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== История версий ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|2.3.3&lt;br /&gt;
|&lt;br /&gt;
* Версия расширения для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.309.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Исправлены правила топологии, которые в некоторых случаях создавали лишние сущности сетевых интерфейсов, не связанные с остальной топологией.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=Generic_network_device&amp;diff=6708</id>
		<title>Generic network device</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=Generic_network_device&amp;diff=6708"/>
		<updated>2026-09-17T20:45:20Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&#039;&#039;&#039;&#039;&#039;[[Расширения]] / [[Расширения#.D0.A0.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F%202.0|Расширения 2.0]] / Generic network device&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
== Обзор ==&lt;br /&gt;
Это расширение использует протокол SNMP для предоставления комплексного решения для мониторинга сетевой инфраструктуры. Полная конфигурация предоставляется из коробки.&lt;br /&gt;
&lt;br /&gt;
== Это предназначено для пользователей, которые: ==&lt;br /&gt;
Хотят отслеживать состояние работоспособности и производительность своей базовой сетевой инфраструктуры и предоставлять унифицированный анализ для Ops, DevOps и ИТ-администраторов.&lt;br /&gt;
&lt;br /&gt;
== Это позволяет вам: ==&lt;br /&gt;
Отслеживать работоспособность и производительность сетевых устройств&lt;br /&gt;
&lt;br /&gt;
Настраивать оповещения для получения уведомлений об аномалиях трафика&lt;br /&gt;
&lt;br /&gt;
== Требования к совместимости ==&lt;br /&gt;
стандартные сетевые устройства, поддерживающие общие файлы MIB&lt;br /&gt;
&lt;br /&gt;
Поддерживаются только SNMPv2c и SNMPv3&lt;br /&gt;
&lt;br /&gt;
== Подробности ==&lt;br /&gt;
Это расширение создано на основе новой платформы Extension 2.0.&lt;br /&gt;
&lt;br /&gt;
== Пакет расширения содержит: ==&lt;br /&gt;
Конфигурация источника данных SNMP,&lt;br /&gt;
&lt;br /&gt;
шаблон панели мониторинга,&lt;br /&gt;
&lt;br /&gt;
шаблон экрана Unified Analysis,&lt;br /&gt;
&lt;br /&gt;
определение топологии и правила извлечения сущностей.&lt;br /&gt;
&lt;br /&gt;
== Начало работы ==&lt;br /&gt;
Просто активируйте расширение в своей среде с помощью встроенного концентратора продукта, укажите конфигурацию устройства, и все готово.&lt;br /&gt;
&lt;br /&gt;
Более подробную информацию можно найти в документации по расширению SNMP&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|+&lt;br /&gt;
!Тип контента&lt;br /&gt;
!Число включенных элементов&lt;br /&gt;
|-&lt;br /&gt;
|Вставки на экран&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Оповещения&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Карточки журналов экрана&lt;br /&gt;
|1&lt;br /&gt;
|-&lt;br /&gt;
|Макет экрана&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Запрос метрики&lt;br /&gt;
|11&lt;br /&gt;
|-&lt;br /&gt;
|Карточки сообщений экрана&lt;br /&gt;
|2&lt;br /&gt;
|-&lt;br /&gt;
|Группы диаграмм экрана&lt;br /&gt;
|5&lt;br /&gt;
|-&lt;br /&gt;
|Списки сущностей экрана&lt;br /&gt;
|1&lt;br /&gt;
|-&lt;br /&gt;
|Общие связи&lt;br /&gt;
|4&lt;br /&gt;
|-&lt;br /&gt;
|Панели мониторинга&lt;br /&gt;
|1&lt;br /&gt;
|-&lt;br /&gt;
|Метрические метаданные&lt;br /&gt;
|47&lt;br /&gt;
|-&lt;br /&gt;
|Свойства экрана&lt;br /&gt;
|3&lt;br /&gt;
|-&lt;br /&gt;
|Общий тип&lt;br /&gt;
|4&lt;br /&gt;
|}&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
|+&lt;br /&gt;
| colspan=&amp;quot;3&amp;quot; |&#039;&#039;&#039;&#039;&#039;default&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|&#039;&#039;&#039;Metric name&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Description&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Unit&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|Time since the last re-start&lt;br /&gt;
|Время (в сотых долях секунды) с момента последней повторной инициализации управляющей части сети системы&lt;br /&gt;
|Unspecified&lt;br /&gt;
|-&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
|-&lt;br /&gt;
|Messages delivered&lt;br /&gt;
|Общее количество сообщений, доставленных от транспортной службы&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Messages passed&lt;br /&gt;
|Общее количество сообщений, переданных в транспортную службу&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Silently dropped PDUs&lt;br /&gt;
|Количество молча отброшенных PDU из-за слишком большого размера ответа&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Proxy dropped PDUs&lt;br /&gt;
|Количество молча отброшенных PDU по причинам, не связанным с таймаутом&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Unsupported SNMP version messages&lt;br /&gt;
|Общее количество сообщений, доставленных с неподдерживаемой версией SNMP&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Messages with bad community names&lt;br /&gt;
|Количество сообщений с неизвестным сообществом SNMP&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Messages not allowed in community&lt;br /&gt;
|Количество сообщений, не разрешенных для используемого сообщества SNMP&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|&#039;noSuchName&#039; errors&lt;br /&gt;
|Количество PDU, доставленных с ошибкой &amp;quot;noSuchName&amp;quot;&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|&#039;badValue&#039; errors&lt;br /&gt;
|Количество PDU, доставленных с ошибкой &amp;quot;badValue&amp;quot;&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Traps processed&lt;br /&gt;
|Общее количество SNMP Trap PDU, принятых и обработанных&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Traps generated&lt;br /&gt;
|Общее количество SNMP Trap PDU, сгенерированных&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
| colspan=&amp;quot;3&amp;quot; |&#039;&#039;&#039;&#039;&#039;Traffic&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|&#039;&#039;&#039;Metric name&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Description&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Unit&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|TCP active opens&lt;br /&gt;
|Количество переходов TCP-соединений из состояния CLOSED в состояние SYN-SENT&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP passive opens&lt;br /&gt;
|Количество переходов TCP-соединений из состояния CLOSED в состояние SYN-RCVD&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP failed attempts&lt;br /&gt;
|Количество переходов TCP-соединений из состояния SYN-SENT/SYN-RCVD в состояние CLOSED и из состояния SYN-RCVD в состояние LISTEN&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP resets&lt;br /&gt;
|Количество переходов TCP-соединений из состояния ESTABLISHED/CLOSE-WAIT в состояние CLOSED&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP connections&lt;br /&gt;
|Количество TCP-соединений в состоянии ESTABLISHED/CLOSE-WAIT&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP segments received&lt;br /&gt;
|Общее количество полученных сегментов (включая с ошибками)&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP segments sent&lt;br /&gt;
|Общее количество отправленных сегментов (исключая повторные передачи)&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP segments retransmitted&lt;br /&gt;
|Общее количество повторно переданных сегментов&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP segment errors&lt;br /&gt;
|Общее количество сегментов, полученных с ошибкой&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|TCP segment resets&lt;br /&gt;
|Количество отправленных TCP-сегментов с установленным флагом RST&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|UDP datagrams delivered&lt;br /&gt;
|Общее количество доставленных UDP-дейтаграмм&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|UDP datagrams received without port&lt;br /&gt;
|Количество полученных UDP-дейтаграмм (нет приложения на целевом порту)&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|UDP datagram errors&lt;br /&gt;
|Количество полученных и недоставленных UDP-дейтаграмм (не связанных с отсутствием приложения на целевом порту)&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|UDP datagrams sent&lt;br /&gt;
|Общее количество отправленных UDP-дейтаграмм&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
| colspan=&amp;quot;3&amp;quot; |&#039;&#039;&#039;&#039;&#039;Interfaces&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|&#039;&#039;&#039;Metric name&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Description&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Unit&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
|-&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
|-&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
| -&lt;br /&gt;
|-&lt;br /&gt;
|Last interface status change&lt;br /&gt;
|Значение &#039;sysUpTime&#039; на момент, когда интерфейс перешел в текущее состояние&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Interface speed&lt;br /&gt;
|Скорость сетевого интерфейса в Мегабитах в секунду&lt;br /&gt;
|MegaBitPerSecond&lt;br /&gt;
|-&lt;br /&gt;
|Inbound errors&lt;br /&gt;
|Количество входящих пакетов/единиц передачи с ошибками&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Inbound discards&lt;br /&gt;
|Количество отброшенных входящих пакетов&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Outbound errors&lt;br /&gt;
|Количество исходящих пакетов/единиц передачи с ошибками&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Outbound discards&lt;br /&gt;
|Количество отброшенных исходящих пакетов&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
| colspan=&amp;quot;3&amp;quot; |&#039;&#039;&#039;&#039;&#039;Interfaces 64-bit&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|&#039;&#039;&#039;Metric name&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Description&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Unit&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|Octets received (high capacity)&lt;br /&gt;
|Общее количество октетов, полученных на интерфейсе, включая фрейминг. Этот показатель использует 64-битный счетчик и должен использоваться для высокоскоростных устройств&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Octets transmitted (high capacity)&lt;br /&gt;
|Общее количество октетов, переданных через интерфейс, включая фрейминг. Этот показатель использует 64-битный счетчик и должен использоваться для высокоскоростных устройств&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|&lt;br /&gt;
|-&lt;br /&gt;
| colspan=&amp;quot;3&amp;quot; |&#039;&#039;&#039;&#039;&#039;Interfaces 32-bit&#039;&#039;&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|&#039;&#039;&#039;Metric name&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Description&#039;&#039;&#039;&lt;br /&gt;
|&#039;&#039;&#039;Unit&#039;&#039;&#039;&lt;br /&gt;
|-&lt;br /&gt;
|Octets received&lt;br /&gt;
|Общее количество октетов, полученных на интерфейсе, включая фрейминг&lt;br /&gt;
|Count&lt;br /&gt;
|-&lt;br /&gt;
|Octets transmitted&lt;br /&gt;
|Общее количество октетов, переданных через интерфейс, включая фрейминг&lt;br /&gt;
|Count&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== История версий ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|2.3.3&lt;br /&gt;
|&lt;br /&gt;
* Адаптированная версия расширения для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.309.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Исправлены правила топологии, которые в некоторых случаях создавали лишние сущности сетевых интерфейсов, не связанные с остальной топологией.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=Custom_sessions_monitor&amp;diff=6707</id>
		<title>Custom sessions monitor</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=Custom_sessions_monitor&amp;diff=6707"/>
		<updated>2026-09-17T20:43:56Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Расширение custom-sessions-monitor для Ключ-АСТРОМ =&lt;br /&gt;
Расширение &#039;&#039;&#039;custom-sessions-monitor&#039;&#039;&#039; предназначено для сбора статистики активных пользователей кластера Ключ-АСТРОМ. Оно подключается к &#039;&#039;&#039;Cluster API&#039;&#039;&#039; и передаёт метрики, позволяющие анализировать вовлечённость пользователей.&lt;br /&gt;
&lt;br /&gt;
== Возможности ==&lt;br /&gt;
&lt;br /&gt;
* Сбор метрик &#039;&#039;&#039;MAU&#039;&#039;&#039; (Monthly Active Users) и &#039;&#039;&#039;DAU&#039;&#039;&#039; (Daily Active Users).&lt;br /&gt;
* Настраиваемое расписание запуска: ежедневно или еженедельно с указанием дня недели и времени.&lt;br /&gt;
* Поддержка проверки или отключения проверки &#039;&#039;&#039;TLS/SSL&#039;&#039;&#039;-сертификата.&lt;br /&gt;
* Аутентификация через &#039;&#039;&#039;API&#039;&#039;&#039;-токен кластера.&lt;br /&gt;
* Автоматическая отправка собранных метрик в Ключ-АСТРОМ.&lt;br /&gt;
&lt;br /&gt;
== Конфигурация ==&lt;br /&gt;
Для настройки расширения используются следующие поля:&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!Поле&lt;br /&gt;
!Описание&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;cluster_url&amp;lt;/code&amp;gt;&lt;br /&gt;
|URL кластера, например &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://ka.example.local&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;cluster_token&amp;lt;/code&amp;gt;&lt;br /&gt;
|API-токен для доступа к &#039;&#039;&#039;Cluster API&#039;&#039;&#039;.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;ssl_verify&amp;lt;/code&amp;gt;&lt;br /&gt;
|Проверка &#039;&#039;&#039;TLS/SSL&#039;&#039;&#039;-сертификата: &amp;lt;code&amp;gt;true&amp;lt;/code&amp;gt; — проверять, &amp;lt;code&amp;gt;false&amp;lt;/code&amp;gt; — не проверять.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;use_weekly_schedule&amp;lt;/code&amp;gt;&lt;br /&gt;
|Включает фиксированное расписание запуска. Если &amp;lt;code&amp;gt;false&amp;lt;/code&amp;gt;, сбор выполняется не чаще одного раза в сутки по внутреннему интервалу.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;schedule_frequency&amp;lt;/code&amp;gt;&lt;br /&gt;
|Частота запуска: &amp;lt;code&amp;gt;daily&amp;lt;/code&amp;gt; или &amp;lt;code&amp;gt;weekly&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;schedule_day_of_week&amp;lt;/code&amp;gt;&lt;br /&gt;
|День недели для &amp;lt;code&amp;gt;weekly&amp;lt;/code&amp;gt;: &amp;lt;code&amp;gt;MON..SUN&amp;lt;/code&amp;gt; или &amp;lt;code&amp;gt;0..6&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;schedule_time&amp;lt;/code&amp;gt;&lt;br /&gt;
|Время запуска в формате &amp;lt;code&amp;gt;HH:MM&amp;lt;/code&amp;gt;, например &amp;lt;code&amp;gt;12:00&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;schedule_timezone_offset&amp;lt;/code&amp;gt;&lt;br /&gt;
|Часовой пояс расписания, например &amp;lt;code&amp;gt;+03:00&amp;lt;/code&amp;gt;.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Требования к токену кластера ==&lt;br /&gt;
&#039;&#039;&#039;Scope&#039;&#039;&#039; токена кластера должен включать:&lt;br /&gt;
&lt;br /&gt;
* Управление токенами кластера&lt;br /&gt;
* API поставщика сервисов&lt;br /&gt;
&lt;br /&gt;
== Метрики ==&lt;br /&gt;
Расширение отправляет следующие метрики:&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!Метрика&lt;br /&gt;
!Описание&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;custom.sessions_monitor.mau&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество уникальных пользователей за последние 30 дней (&#039;&#039;&#039;Monthly Active Users&#039;&#039;&#039;).&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;code&amp;gt;custom.sessions_monitor.dau&amp;lt;/code&amp;gt;&lt;br /&gt;
|Количество уникальных пользователей за последние 1 день (&#039;&#039;&#039;Daily Active Users&#039;&#039;&#039;).&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Работа расширения ==&lt;br /&gt;
&lt;br /&gt;
* Если &amp;lt;code&amp;gt;use_weekly_schedule&amp;lt;/code&amp;gt; установлен в &amp;lt;code&amp;gt;false&amp;lt;/code&amp;gt;, расширение выполняет сбор данных не чаще одного раза в сутки, руководствуясь внутренним интервалом.&lt;br /&gt;
* Если включено фиксированное расписание, сбор происходит в указанное время с учётом дня недели и часового пояса.&lt;br /&gt;
&lt;br /&gt;
== См. также ==&lt;br /&gt;
&lt;br /&gt;
* Мониторинг кластера Ключ-АСТРОМ&lt;br /&gt;
* API поставщика сервисов&lt;br /&gt;
&lt;br /&gt;
== История версий ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|0.1.0&lt;br /&gt;
|&lt;br /&gt;
* Начало поддержки расширения в Ключ-АСТРОМ &amp;lt;code&amp;gt;1.285+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Добавлен сбор количества активных пользователей за день и месяц по журналам аудита окружений.&lt;br /&gt;
* Добавлены настраиваемое расписание сбора и готовая обзорная панель.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
	<entry>
		<id>https://doc.ruscomtech.ru/index.php?title=SAP_ABAP_platform_monitoring&amp;diff=6706</id>
		<title>SAP ABAP platform monitoring</title>
		<link rel="alternate" type="text/html" href="https://doc.ruscomtech.ru/index.php?title=SAP_ABAP_platform_monitoring&amp;diff=6706"/>
		<updated>2026-09-17T20:42:27Z</updated>

		<summary type="html">&lt;p&gt;Azubarev: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&lt;br /&gt;
[https://doc.ruscomtech.ru/index.php/%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F Расширения] / [https://doc.ruscomtech.ru/index.php/%D0%A0%D0%B0%D1%81%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%B8%D1%8F#.D0.A0.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F_2.0 Расширения 2.0]/ SAP ABAP platform monitoring&lt;br /&gt;
&lt;br /&gt;
Узнайте, как контролировать вашу платформу SAP ABAP с помощью расширения SAP ABAP АктивногоШлюза.&lt;br /&gt;
&lt;br /&gt;
== Предварительные условия ==&lt;br /&gt;
&lt;br /&gt;
* SAP NetWeaver ABAP версии 7.31+&lt;br /&gt;
* Среда АктивногоШлюза&lt;br /&gt;
** Инструкции по установке Environment АктивногоШлюза см. в АктивныйШлюз КлючАстром.&lt;br /&gt;
* Коннектор SAP Java присутствует на хосте АктивногоШлюза (см. инструкции по настройке ниже)&lt;br /&gt;
* Конечная точка сервера приложений SAP с нагрузкой может потреблять до 0,5 ядер ЦП и 1,5 ГБ ОЗУ на АктивныйШлюз. Обязательно задайте размер АктивногоШлюза соответствующим образом, особенно если вы настраиваете несколько конечных точек, которые опрашивают один АктивныйШлюз.&lt;br /&gt;
* АктивныйШлюз требует удаленного доступа к серверу приложений SAP (AS ABAP) по протоколу RFC.&lt;br /&gt;
* Если конечная точка настроена на опрос всех кластерных экземпляров, АктивныйШлюз требует удаленного доступа ко всем экземплярам SAP AS.&lt;br /&gt;
* Учетная запись пользователя, имеющая разрешение на выполнение следующих функций мониторинга:&lt;br /&gt;
** Authorization Object:&amp;lt;code&amp;gt;S_RFC&amp;lt;/code&amp;gt;&lt;br /&gt;
*** Activity:&amp;lt;code&amp;gt;16&amp;lt;/code&amp;gt;&lt;br /&gt;
*** Имя RFC: &amp;lt;code&amp;gt;/SDF/GET_DUMP_LOG&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;GET_SYSTEM_TIME_REMOTE&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;SWNC_GET_WORKLOAD_SNAPSHOT&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;TH_SERVER_LIST&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;TH_USER_LIST&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;RFC_METADATA_GET&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;RFCPING&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;RFC_GET_FUNCTION_INTERFACE&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;DDIF_FIELDINFO_GET&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;RFC_READ_TABLE&amp;lt;/code&amp;gt;(запрос таблицы TBTCO при составлении отчетов о заданиях)&lt;br /&gt;
*** Тип RFC:&amp;lt;code&amp;gt;FUNC&amp;lt;/code&amp;gt;&lt;br /&gt;
** Authorization Object:&amp;lt;code&amp;gt;/SDF/E2E&amp;lt;/code&amp;gt;&lt;br /&gt;
*** Activity:&amp;lt;code&amp;gt;03&amp;lt;/code&amp;gt;&lt;br /&gt;
** Authorization Object:&amp;lt;code&amp;gt;S_RZL_ADM&amp;lt;/code&amp;gt;&lt;br /&gt;
*** Activity:&amp;lt;code&amp;gt;03&amp;lt;/code&amp;gt;&lt;br /&gt;
** Authorization Object:&amp;lt;code&amp;gt;S_TOOLS_EX&amp;lt;/code&amp;gt;&lt;br /&gt;
*** AUTH:&amp;lt;code&amp;gt;S_TOOLS_EX_A&amp;lt;/code&amp;gt;&lt;br /&gt;
** Authorization Object:&amp;lt;code&amp;gt;S_TCODE&amp;lt;/code&amp;gt;&lt;br /&gt;
*** TCD:&amp;lt;code&amp;gt;SM51&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Конфигурация SAP Java Connector ==&lt;br /&gt;
Настройте коннектор SAP Java на хосте АктивногоШлюза.&lt;br /&gt;
&lt;br /&gt;
# Загрузите 64-разрядную версию SAP Java Connector для АктивногоШлюза.&lt;br /&gt;
# Поместите &amp;lt;code&amp;gt;sapjco3.jar&amp;lt;/code&amp;gt;файл в &amp;lt;code&amp;gt;JCo&amp;lt;/code&amp;gt;папку, как указано ниже, при добавлении новой конечной точки мониторинга (шаг 7 установки расширения).&lt;br /&gt;
# В зависимости от операционной системы, работающей на хосте АктивногоШлюза, поместите в каталог &amp;lt;code&amp;gt;sapjco3.dll&amp;lt;/code&amp;gt;(Windows) или &amp;lt;code&amp;gt;libsapjco3.so&amp;lt;/code&amp;gt;(Linux) &amp;lt;code&amp;gt;JCo&amp;lt;/code&amp;gt;.&lt;br /&gt;
# Убедитесь, что учетной записи пользователя, выполняющей плагин, разрешено чтение из &amp;lt;code&amp;gt;JCo&amp;lt;/code&amp;gt;папки.&lt;br /&gt;
# &#039;&#039;только для Windows&#039;&#039; Убедитесь, что на хосте АктивногоШлюза под управлением Windows установлены распространяемые пакеты Visual C++ для Visual Studio 2013 установлены. От этого зависит SAP Java Connector.&lt;br /&gt;
&lt;br /&gt;
== Установка расширения ==&lt;br /&gt;
&lt;br /&gt;
# В меню Ключ-АСТРОМ перейдите в Hub .&lt;br /&gt;
# Найдите и выберите платформу SAP GUI и ABAP .&lt;br /&gt;
# Выберите «Загрузить» , чтобы получить ZIP-файл с расширением. Не переименовывайте файл.&lt;br /&gt;
# Разархивируйте ZIP-файл в &amp;lt;code&amp;gt;plugin_deployment&amp;lt;/code&amp;gt;каталог вашего хоста АктивногоШлюза. Если полученная структура каталогов не .\plugin_deployment\&amp;lt;EXTENSION-SPECIFIC-DIRECTORY&amp;gt;\  где &amp;lt;code&amp;gt;&amp;lt;EXTENSION-SPECIFIC-DIRECTORY&amp;gt;&amp;lt;/code&amp;gt;имя каталога, содержащего файлы данного расширения, внесите необходимые изменения.&lt;br /&gt;
# Если вы планируете отслеживать активность пользователей, создайте новое пользовательское приложение.&lt;br /&gt;
#* Перейдите в Ключ-Астром Hub &amp;gt; Общий интерфейс &amp;gt; Мониторинг пользовательского приложения .&lt;br /&gt;
#* Дайте приложению описательное имя, выберите значок, затем выберите &amp;lt;code&amp;gt;Monitor custom application&amp;lt;/code&amp;gt;.&lt;br /&gt;
#* Выберите Мастер инструментирования и запишите его, &amp;lt;code&amp;gt;Application ID&amp;lt;/code&amp;gt;созданный для вашего специального приложения. URL-адрес метки не используется, поскольку расширение отправляет данные обратно через АктивныйШлюз, на котором работает расширение.&lt;br /&gt;
# В Ключ-Астром выберите «Настройки» , «Добавить мониторинг новой технологии» , а затем «Добавить расширение АктивногоШлюза» .&lt;br /&gt;
# Выберите «Загрузить расширение» и загрузите ZIP-файл.&lt;br /&gt;
# Введите следующую информацию для подключения к вашему хосту SAP:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
!Параметр&lt;br /&gt;
!Подробности&lt;br /&gt;
|-&lt;br /&gt;
|Endpoint name&lt;br /&gt;
|Введите значимое имя конечной точки. Имя будет видно только на странице конфигурации.&lt;br /&gt;
|-&lt;br /&gt;
|Connect via message server&lt;br /&gt;
|Подключитесь к серверу приложений SAP через сервер сообщений. После сбора списка серверов приложений SAP расширение подключается напрямую к серверам. Если сервер сообщений не работает, данные о доступности серверов приложений SAP за сервером сообщений не будут собираться. Чтобы обнаружить и настроить оповещения для такого состояния, настройте настраиваемое событие оповещения об отсутствующих данных , которое будет предупреждать об этом состоянии &amp;lt;code&amp;gt;if data is missing&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|SAP application server address&lt;br /&gt;
|IP-адрес или имя хоста сервера приложений SAP. Не используется при подключении через сервер сообщений.&lt;br /&gt;
|-&lt;br /&gt;
|Instance ID&lt;br /&gt;
|Идентификатор экземпляра, к которому необходимо подключиться (это числовое двухзначное значение). Не используется при подключении через сервер сообщений.&lt;br /&gt;
|-&lt;br /&gt;
|System ID&lt;br /&gt;
|Идентификатор системы для подключения. Используется только при подключении через сервер сообщений.&lt;br /&gt;
|-&lt;br /&gt;
|Message server host name or address&lt;br /&gt;
|IP-адрес или имя хоста сервера сообщений. Используется только при подключении через сервер сообщений.&lt;br /&gt;
|-&lt;br /&gt;
|Message server port number&lt;br /&gt;
|Порт, который прослушивает сервер сообщений. Используется только при подключении через сервер сообщений.&lt;br /&gt;
|-&lt;br /&gt;
|Group/server&lt;br /&gt;
|Группа/сервер, настроенная на сервере сообщений. Используется только при подключении через сервер сообщений.&lt;br /&gt;
|-&lt;br /&gt;
|Keystore path&lt;br /&gt;
|Путь к хранилищам ключей, если это необходимо для соединения, определяется как SECUDIR.&lt;br /&gt;
|-&lt;br /&gt;
|Username&lt;br /&gt;
|Имя пользователя для учетной записи, подключающейся к серверу приложений SAP.&lt;br /&gt;
|-&lt;br /&gt;
|Password&lt;br /&gt;
|Пароль для учетной записи.&lt;br /&gt;
|-&lt;br /&gt;
|Client number&lt;br /&gt;
|Номер клиента, который будет использоваться для соединения.&lt;br /&gt;
|-&lt;br /&gt;
|Poll all clustered SAP instances&lt;br /&gt;
|Вместо создания одной конечной точки для каждого экземпляра SAP этот параметр опрашивает все кластеризованные экземпляры SAP одновременно.&lt;br /&gt;
|-&lt;br /&gt;
|Use &#039;SAP server&#039; as the application server name&lt;br /&gt;
|Вместо пользовательского устройства, использующего имя, возвращаемое экземпляром сервера приложений, используйте значение, введенное в адрес сервера приложений SAP . Невозможно при опросе всех кластерных серверов SAP.&lt;br /&gt;
|-&lt;br /&gt;
|Path to a JCo destination file&lt;br /&gt;
|&#039;&#039;необязательно&#039;&#039; Если для подключения к серверу SAP требуется определенный целевой файл, введите здесь путь. Это переопределит все вышеуказанные настройки, за исключением пути к хранилищу ключей.&lt;br /&gt;
|-&lt;br /&gt;
|SAP JCo folder&lt;br /&gt;
|Папка, содержащая &amp;lt;code&amp;gt;sapjco3.jar&amp;lt;/code&amp;gt;собственный файл Java Connector.&lt;br /&gt;
|-&lt;br /&gt;
|Task types to report on&lt;br /&gt;
|Типы задач, о которых нужно сообщить, разделены запятыми, остальные будут объединены. Возможные типы задач: NONE, DIALOG, UPDATE, SPOOL, BCKGRD, ENQUEUE, BUF.SYN, AUTOABA, UPDATE2, NATIVE_RFC, PLUGIN, AUTOTH, RPCTH, RFCVMC, DDLOGCLEANUP, DEL.THCALL, AUTOJAVA, LICENCESRV, AUTOCCMS, MSADM, SYS_STARTUP, BGRFCSDL, BGRFC, APC, OTHERS, DINOGUI, B.INPUT, HTTP, HTTPS, NNTP, SMTP, FTP, LCOM, HTTP/JSP, HTTPS/JSP, AUTO_RFC, WS-RFC, WS-HTTP, ESI, ALE, RFC и CPIC&lt;br /&gt;
|-&lt;br /&gt;
|Enable debug logging&lt;br /&gt;
|Выберите этот вариант только в том случае, если эксперт по продуктам Ключ-АСТРОМ попросит изучить проблему.&lt;br /&gt;
|-&lt;br /&gt;
|Report on application server metrics&lt;br /&gt;
|Отчет о метриках сервера приложений на пользовательское устройство.&lt;br /&gt;
|-&lt;br /&gt;
|Report on user sessions and actions based on Tcodes to a custom application&lt;br /&gt;
|Выберите этот параметр, чтобы создавать пользовательские сеансы и действия пользователей на основе T-кодов, выполняемых клиентом. Для использования этой функции необходимо создать собственное приложение, что делается в меню «Развертывание Ключ-АСТРОМ» .&lt;br /&gt;
|-&lt;br /&gt;
|Report on RFC usage metrics to the metric ingest API&lt;br /&gt;
|Расширение собирает метрики использования RFC, используя канал приема Ключ-АСТРОМ Metrics API v2 . Используйте проводник данных для доступа к собранным показателям. Имена метрик начинаются со &amp;lt;code&amp;gt;sap.rfc&amp;lt;/code&amp;gt;строки. Метрики не назначаются специальному устройству. Выберите, следует ли составлять отчет только о серверах, обменивающихся данными с сервером приложений SAP, или дополнительно разделить метрики на отдельные имена функций.&lt;br /&gt;
|-&lt;br /&gt;
|Report on job metrics to the metric ingest API&lt;br /&gt;
|Расширение собирает метрики заданий, используя канал приема Ключ-АСТРОМ Metrics API v2 . Используйте проводник данных для доступа к собранным показателям. Имена метрик начинаются со &amp;lt;code&amp;gt;sap.job&amp;lt;/code&amp;gt;строки. Метрики не назначаются специальному устройству.&lt;br /&gt;
|-&lt;br /&gt;
|API token with the access scope &#039;Ingest metrics&#039;&lt;br /&gt;
|Используется только в том случае, если включен мониторинг RFC. Используется расширением для отправки метрик, связанных с RFC, в Ключ-АСТРОМ.&lt;br /&gt;
|-&lt;br /&gt;
|Tenant or environment ID&lt;br /&gt;
|Используется только в том случае, если включен RFC или отчеты о сеансах пользователей. Идентификатор клиента для Ключ-АСТРОМ SaaS можно найти в URL-адресе. Например, если URL-адрес — &amp;lt;code&amp;gt;abc12345.live.astromkey.com&amp;lt;/code&amp;gt;, идентификатор клиента — &amp;lt;code&amp;gt;abc12345&amp;lt;/code&amp;gt;. Идентификатор среды для Ключ-АСТРОМ Managed можно найти в URL-адресе после &amp;lt;code&amp;gt;/e/&amp;lt;/code&amp;gt;. Например, если URL-адрес равен &amp;lt;code&amp;gt;my.astromkey.server/e/12345-abcde/&amp;lt;/code&amp;gt;, то идентификатор среды равен &amp;lt;code&amp;gt;12345-abcde&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
|The Application ID of the custom application&lt;br /&gt;
|Чтобы создать пользовательские сеансы, введите идентификатор приложения, который будет предложен после создания пользовательского приложения.&lt;br /&gt;
|-&lt;br /&gt;
|Inactivity time out (in minutes) when capturing user sessions&lt;br /&gt;
|Введите число от 5 до 30, по умолчанию — 30.&lt;br /&gt;
|-&lt;br /&gt;
|Capture usernames as part of the user sessions&lt;br /&gt;
|Выберите, чтобы записывать имена пользователей.&lt;br /&gt;
|-&lt;br /&gt;
|Use terminal name for end user location&lt;br /&gt;
|При захвате сеансов пользователей используйте IP-адрес, полученный из первых 20 символов имени терминала, вместо IP-адреса пользователя, возвращаемого SAP. Это полезно, когда сервер приложений не знает IP-адрес клиента, например, когда пользователи подключаются через маршрутизатор SAP.&lt;br /&gt;
|-&lt;br /&gt;
|Display best practice upper boundary&lt;br /&gt;
|Добавляет верхнюю границу к диаграммам показателей производительности на пользовательском устройстве.&lt;br /&gt;
|-&lt;br /&gt;
|Poll once per five minutes instead of once per minute&lt;br /&gt;
|Снижает нагрузку на сервер приложений SAP, но снижает степень детализации диаграмм и задерживает получение данных. При большой нагрузке на сервер приложений SAP это может привести к тому, что сервер SAP не будет отправлять все действия пользователя в Ключ-АСТРОМ.&lt;br /&gt;
|-&lt;br /&gt;
|Path to a Java executable version 8+&lt;br /&gt;
|Расширение SAP использует соединитель SAP Java для связи с SAP. В связи с этим на АктивномШлюзе должна быть установлена ​​Java. Введите путь к исполняемому файлу Java 8+, например &amp;lt;code&amp;gt;C:\Program Files\Java\jre1.8.0_251\bin\java.exe or /usr/bin/java&amp;lt;/code&amp;gt;. Рекомендуется не использовать среду выполнения Java, поставляемую в комплекте с АктивномШлюзом, поскольку это может вызвать проблемы во время обновлений АктивногоШлюза . Используйте ту же разрядность, что и у Java Connector. Если вы загрузили 64-битный пакет JCo, используйте 64-битную Java.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Устранение неполадок расширений АктивногоШлюза ==&lt;br /&gt;
См. раздел «Устранение неполадок расширений АктивногоШлюза» .&lt;br /&gt;
&lt;br /&gt;
== Метрики ==&lt;br /&gt;
&lt;br /&gt;
==== Экземпляр сервера приложений ====&lt;br /&gt;
&lt;br /&gt;
* Availability&lt;br /&gt;
* Runtime errors (split by error category)&lt;br /&gt;
* Number of user sessions&lt;br /&gt;
* CPU time/Response time ratio&lt;br /&gt;
* Database time/Response time ratio&lt;br /&gt;
* Wait time/Response time ratio&lt;br /&gt;
* Load time/Response time ratio&lt;br /&gt;
&lt;br /&gt;
==== Задачи ====&lt;br /&gt;
&lt;br /&gt;
* Response time&lt;br /&gt;
* Dialog steps&lt;br /&gt;
* CPU time&lt;br /&gt;
* Database time&lt;br /&gt;
* Database calls&lt;br /&gt;
* Roll in time&lt;br /&gt;
* Roll wait time&lt;br /&gt;
* Load + generation time&lt;br /&gt;
* Active user count&lt;br /&gt;
&lt;br /&gt;
==== Диалог ====&lt;br /&gt;
&lt;br /&gt;
* Dialog steps&lt;br /&gt;
* Dialog response time&lt;br /&gt;
* Dialog network time&lt;br /&gt;
* GUI active user count&lt;br /&gt;
&lt;br /&gt;
==== Метрики RFC доступны в проводнике данных ====&lt;br /&gt;
&lt;br /&gt;
* sap.rfcIncomingExecutionTime (миллисекунды)&lt;br /&gt;
* sap.rfcIncomingCallTime (миллисекунды)&lt;br /&gt;
* sap.rfcIncomingReceive (байты)&lt;br /&gt;
* sap.rfcIncomingSend (байты)&lt;br /&gt;
* sap.rfcIncomingRequests (количество)&lt;br /&gt;
* sap.rfcOutgoingExecutionTime (миллисекунды)&lt;br /&gt;
* sap.rfcOutgoingCallTime (миллисекунды)&lt;br /&gt;
* sap.rfcOutgoingReceive (байты)&lt;br /&gt;
* sap.rfcOutgoingSend (байты)&lt;br /&gt;
* sap.rfcOutgoingRequests (количество)&lt;br /&gt;
&lt;br /&gt;
==== Показатели задания доступны в проводнике данных ====&lt;br /&gt;
&lt;br /&gt;
* SAP.job.status_count (количество)&lt;br /&gt;
* SAP.job.avg_duration (миллисекунды)&lt;br /&gt;
* SAP.job.avg_delay (миллисекунды)&lt;br /&gt;
* SAP.job.max_delay (миллисекунды)&lt;br /&gt;
&lt;br /&gt;
== Дополнительные замечания ==&lt;br /&gt;
&lt;br /&gt;
* Ошибки выполнения ABAP создаются как события в Ключ-АСТРОМ и, если возможно, сопоставляются с ответственным сеансом пользователя или действием пользователя.&lt;br /&gt;
* Для мониторинга инфраструктуры и зависимостей требуется установка ЕдиногоАгента на серверах AS ABAP и других серверах в среде SAP. Обычно сюда входят серверы баз данных и клиентские серверы RFC, которые взаимодействуют с серверами приложений SAP.&lt;br /&gt;
&lt;br /&gt;
== История версий ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Версия&lt;br /&gt;
! Изменения&lt;br /&gt;
|-&lt;br /&gt;
|1.6.17&lt;br /&gt;
|&lt;br /&gt;
* Версия расширения для Ключ-АСТРОМ &amp;lt;code&amp;gt;1.285.0+&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Начало поддержки расширения.&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Azubarev</name></author>
	</entry>
</feed>