Azubarev: Новая страница: «Идентификатор расширения: `ru.ruscomtech.extension.wmi.iis`. == Возможности == * Сбор количества запросов и статистики HTTP-методов. * Контроль входящего и исходящего трафика, подключений и времени работы веб-службы. * Мониторинг состояния пулов приложений, числа ра...»

2026-10-10T02:21:13Z

Новая страница: «Идентификатор расширения: <code>ru.ruscomtech.extension.wmi.iis</code>. == Возможности == * Сбор количества запросов и статистики HTTP-методов. * Контроль входящего и исходящего трафика, подключений и времени работы веб-службы. * Мониторинг состояния пулов приложений, числа ра...»

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

Идентификатор расширения: <code>ru.ruscomtech.extension.wmi.iis</code>.
== Возможности ==

* Сбор количества запросов и статистики HTTP-методов.
* Контроль входящего и исходящего трафика, подключений и времени работы веб-службы.
* Мониторинг состояния пулов приложений, числа рабочих процессов, перезапусков и сбоев.
* Контроль длины очередей, возраста запросов и отказов при постановке в очередь.
* Сбор показателей потоков, кешей, Windows Process Activation Service (WAS) и групп URL.
* Создание сущностей IIS Service, IIS Site и IIS App Pool.
* Формирование связей сайтов и пулов с экземпляром IIS, а при наличии соответствующего хоста — связей с хостом.
* Готовые обзорные панели и страницы анализа сущностей.

Интервал сбора всех групп в текущем пакете — одна минута.

== Требования ==

Расширение предназначено для Ключ-АСТРОМ версии <code>1.313.0</code> и новее.

Версии Windows и IIS необходимо выбирать с учётом поддержки используемого ЕдиногоАгента или АктивногоШлюза и наличия необходимых WMI-классов. Отдельная минимальная версия EEC в манифесте пакета не указана.

=== Локальный сбор ===

Для локального сбора необходимы:

* Windows с установленным IIS и доступными счётчиками производительности.
* ЕдиныйАгент на сервере IIS.
* Включённый контроллер выполнения расширений EEC.
* Доступ учётной записи сборщика к WMI и счётчикам производительности.
* Работающие службы Windows Management Instrumentation (Winmgmt), Windows Process Activation Service (WAS) и World Wide Web Publishing Service (W3SVC) для получения соответствующих данных.

=== Удалённый сбор ===

Для удалённого сбора необходимы:

* АктивныйШлюз на Windows с включённым EEC и поддержкой удалённого сбора WMI.
* Сетевой доступ от АктивногоШлюза к серверу IIS по WMI/DCOM: TCP 135 и используемые целевым сервером порты RPC.
* Учётная запись с правами удалённого чтения WMI и счётчиков производительности.
* Разрешённый удалённый доступ к WMI и соответствующие правила межсетевого экрана.

ЕдиныйАгент на сервере IIS для удалённого сбора не требуется. АктивныйШлюз на Linux для этого режима не подходит.

== Подготовка сервера IIS ==

=== Проверка служб и счётчиков ===

На сервере IIS выполните в PowerShell:

<pre>
Get-Service Winmgmt, WAS, W3SVC

Get-CimInstance -Namespace root/cimv2 -Query "SELECT Name, TotalMethodRequestsPersec, CurrentConnections FROM Win32_PerfFormattedData_W3SVC_WebService WHERE Name != '_Total'"

Get-CimInstance -Namespace root/cimv2 -Query "SELECT Name, CurrentApplicationPoolState, CurrentWorkerProcesses FROM Win32_PerfFormattedData_APPPOOLCountersProvider_APPPOOLWAS WHERE Name != '_Total'"
</pre>

Запросы должны возвращать доступные экземпляры сайтов и пулов приложений. Некоторые экземпляры счётчиков появляются только после запуска пула и обработки первого запроса. При пустом результате запустите нужный сайт, обратитесь к нему и повторите проверку.

Расширение использует следующие классы в пространстве имён <code>root\cimv2</code>:

* <code>Win32_PerfFormattedData_W3SVC_WebService</code> — сайты, HTTP-методы, трафик и соединения.
* <code>Win32_PerfFormattedData_APPPOOLCountersProvider_APPPOOLWAS</code> — пулы приложений, состояние и сбои рабочих процессов.
* <code>Win32_PerfFormattedData_Counters_HTTPServiceRequestQueues</code> — очереди HTTP-запросов.
* <code>Win32_PerfFormattedData_W3SVCW3WPCounterProvider_W3SVCW3WP</code> — обработка запросов рабочими процессами.
* <code>Win32_PerfFormattedData_WASW3WPCounterProvider_WASW3WP</code> — рабочие процессы WAS.
* <code>Win32_PerfFormattedData_W3SVC_WebServiceCache</code> — кеши веб-службы.
* <code>Win32_PerfFormattedData_Counters_HTTPServiceUrlGroups</code> — группы URL HTTP-службы.

=== Права для удалённого сбора ===

# Создайте отдельную учётную запись мониторинга, например <code>EXAMPLE\iis-monitor</code>.
# Предоставьте ей доступ к счётчикам производительности. Для этого обычно используется локальная группа <code>Performance Monitor Users</code> («Пользователи системного монитора»).
# Откройте <code>wmimgmt.msc</code>, затем свойства WMI Control → Security → Root → CIMV2 → Security.
# Разрешите учётной записи доступ к пространству имён: <code>Enable Account</code> и <code>Remote Enable</code>.
# В <code>dcomcnfg</code> проверьте права <code>Remote Access</code>, <code>Remote Launch</code> и <code>Remote Activation</code>, если они не предоставлены через группы учётной записи.
# Разрешите подключения WMI/DCOM с АктивногоШлюза в межсетевом экране. Одного открытого порта 135 недостаточно: соединение также использует порты RPC.

Для локальных учётных записей дополнительно учитывайте ограничения Remote UAC. Не отключайте защитные механизмы Windows и межсетевой экран целиком: предоставляйте необходимые права конкретной учётной записи и разрешайте подключения с нужного сборщика.

Проверьте соединение с Windows-хоста АктивногоШлюза, используя ту же учётную запись, которая будет указана в конфигурации расширения:

<pre>
$credential = Get-Credential 'EXAMPLE\iis-monitor'
$sessionOptions = New-CimSessionOption -Protocol Dcom

$iisSession = New-CimSession -ComputerName 'iis01.example.local' `
-Credential $credential -SessionOption $sessionOptions

try {
Get-CimInstance -CimSession $iisSession -Namespace root/cimv2 `
-Query "SELECT Name, TotalMethodRequestsPersec FROM Win32_PerfFormattedData_W3SVC_WebService WHERE Name != '_Total'"
} finally {
Remove-CimSession $iisSession
}
</pre>

Проверка использует DCOM, как удалённый сбор WMI. Успешное подключение только по WinRM не подтверждает доступность WMI/DCOM для расширения.

== Установка и подключение ==

# Загрузите пакет расширения в Ключ-АСТРОМ через раздел управления расширениями.
# При необходимости установите корневой сертификат, которым подписан пакет, на ЕдиныйАгент или АктивныйШлюз, выполняющий сбор.
# Откройте расширение <code>ru.ruscomtech.extension.wmi.iis</code>.
# Создайте конфигурацию мониторинга.
# Выберите локальный или удалённый режим.
# Настройте область мониторинга, наборы функций и фильтры.
# Сохраните и включите конфигурацию.

Не создавайте несколько конфигураций с пересекающейся областью мониторинга одного сервера без необходимости.

=== Локальная конфигурация ===

Выберите Windows-хост с установленным IIS и включённым EEC. Допускается настройка области мониторинга через группу хостов или зону управления, если соответствующая возможность доступна в интерфейсе.

Адрес сервера, имя пользователя и пароль для подключения к локальному WMI отдельно не задаются: сбор выполняется на выбранном хосте.

=== Удалённая конфигурация ===

Выберите группу АктивныхШлюзов, содержащую Windows-сборщик с доступом к серверу IIS.

Добавьте сервер со следующими параметрами:

* Сервер WMI — <code>iis01.example.local</code>.
* Пользователь — <code>EXAMPLE\iis-monitor</code>.
* Пароль — пароль учётной записи мониторинга.

Все АктивныеШлюзы, которые могут выполнять эту конфигурацию, должны иметь доступ к указанному серверу.

== Конфигурация и фильтры ==

Расширение содержит две переменные для фильтрации WQL-запросов:

* <code>iis_site</code> — поле <code>IIS Site WMI Query</code>.
* <code>iis_app_pool</code> — поле <code>IIS App Pool WMI Query</code>.

В поле указывается только условие, подставляемое после <code>WHERE</code>. Полный запрос <code>SELECT</code> и само слово <code>WHERE</code> добавлять не нужно.

Значение по умолчанию для обеих переменных:

<pre>
Name != '_Total'
</pre>

Пример фильтра одного сайта:

<pre>
Name = 'Default Web Site'
</pre>

Пример фильтра одного пула:

<pre>
Name = 'DefaultAppPool'
</pre>

Для выбора по префиксу имени можно использовать <code>LIKE</code>, например <code>Name LIKE 'MySite%'</code>.

=== Область действия фильтров ===

* <code>iis_site</code> применяется к основным метрикам сайтов и набору <code>IIS Extended Request Metrics</code>.
* <code>iis_app_pool</code> применяется к основным метрикам пулов и запросам к классу очередей <code>HTTPServiceRequestQueues</code>.
* Сбор состояния пулов выполняется отдельными запросами и не использует переменную <code>iis_app_pool</code>.
* Наборы <code>Http request processing</code>, <code>WAS worker process</code>, <code>WWW publishing service cache</code>, <code>WWW publishing service</code> и <code>Url groups</code> не используют эти переменные.

Поэтому фильтр одного сайта или пула не ограничивает весь сбор расширения этим объектом.

Имена экземпляров очередей необходимо проверять отдельно: они могут отличаться от имён сайтов. В текущем пакете имя очереди передаётся через измерение <code>iis_site</code>, что следует учитывать при анализе данных.

=== Пример конфигурации через API ===

Пример удалённой конфигурации мониторинга:

<pre>
[
{
"scope": "ag_group-IIS-Windows",
"value": {
"version": "1.2.1",
"description": "Microsoft IIS — удалённый мониторинг",
"enabled": true,
"activationContext": "REMOTE",
"wmiRemote": {
"devices": [
{
"host": "iis01.example.local",
"user": "EXAMPLE\\iis-monitor",
"password": "REPLACE_WITH_PASSWORD"
}
]
},
"featureSets": [
"IIS Extended Request Metrics"
],
"vars": {
"iis_site": "Name != '_Total'",
"iis_app_pool": "Name != '_Total'"
}
}
}
]
</pre>

Замените название группы АктивныхШлюзов, адрес сервера и учётные данные своими значениями. Пример не является конфигурацией с рабочим паролем.

В JSON обратная косая черта в имени пользователя записывается как <code>\\</code>. В поле пользователя интерфейса используется обычная запись <code>EXAMPLE\iis-monitor</code>.

Основной набор <code>default</code> собирается независимо от выбранных дополнительных наборов. В примере дополнительно включена статистика HTTP-методов.

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

* <code>default</code> — 30 ключей метрик. Основные показатели сайтов, пулов, их состояния, очередей и сбоев.
* <code>IIS Extended Request Metrics</code> — 5 метрик. HEAD, PUT, DELETE, OPTIONS и TRACE.
* <code>Http request processing</code> — 13 метрик. Активные запросы, потоки, память и промахи кешей рабочих процессов.
* <code>WAS worker process</code> — 3 метрики. Каналы слушателей, обработчики протоколов и задержка ответа на проверку WAS.
* <code>WWW publishing service cache</code> — 3 метрики. Попадания в файловый кеш, кеш URI ядра и эффективность выходного кеша.
* <code>WWW publishing service</code> — 5 метрик. Трафик, попытки подключения, соединения и пользователи.
* <code>Url groups</code> — 9 метрик. Запросы, трафик и подключения по группам URL.

Всего пакет содержит 67 уникальных ключей метрик. Ключ <code>iis.current.connections.gauge</code> используется в двух наборах, поэтому сумма количества метрик по наборам отличается от количества уникальных ключей.

Набор <code>IIS Extended Request Metrics</code> отмечен в пакете как рекомендуемый. Остальные дополнительные наборы включайте в соответствии с задачами мониторинга и доступностью соответствующих WMI-классов.

== Основные метрики ==

=== Сайты и веб-служба ===

* <code>iis.method.requests.persec</code> — скорость поступления HTTP-запросов.
* <code>iis.total.method.requests.count</code> — счётчик всех HTTP-запросов.
* <code>iis.total.get.requests.count</code> — счётчик GET-запросов.
* <code>iis.total.post.requests.count</code> — счётчик POST-запросов.
* <code>iis.total.bytes.received.count</code> — принятые байты.
* <code>iis.total.bytes.sent.count</code> — переданные байты.
* <code>iis.total.bytes.transferred.count</code> — суммарный объём трафика.
* <code>iis.current.connections.gauge</code> — текущее число подключений.
* <code>iis.service.uptime</code> — время работы веб-службы, секунды.
* <code>iis.total.files.received.count</code> — полученные файлы.
* <code>iis.total.files.sent.count</code> — переданные файлы.
* <code>iis.total.connectionAttempts.allInstances.count</code> — попытки подключения.

=== Пулы приложений и сбои ===

* <code>iis.current.applicationPool.state</code> — текущее состояние пула.
* <code>iis.current.applicationPool.uptime</code> — время с последнего запуска пула, секунды.
* <code>iis.total.applicationPool.uptime</code> — суммарное время работы пула с запуска WAS, секунды.
* <code>iis.current.workerProcesses</code> — текущее число рабочих процессов.
* <code>iis.maximum.workerProcesses</code> — максимальное число рабочих процессов с запуска WAS.
* <code>iis.total.applicationPool.recycles.count</code> — перезапуски пула (recycle).
* <code>iis.timeSinceLast.workerProcess.failure</code> — время с последнего сбоя процесса, секунды.
* <code>iis.APPPOOLWAS.RecentWorkerProcessFailures</code> — сбои в интервале rapid-fail protection.
* <code>iis.APPPOOLWAS.TotalWorkerProcessFailures</code> — общее число сбоев рабочих процессов.
* <code>iis.APPPOOLWAS.TotalWorkerProcessPingFailures</code> — ошибки ответа на проверку WAS.
* <code>iis.APPPOOLWAS.TotalWorkerProcessShutdownFailures</code> — ошибки остановки процессов.
* <code>iis.APPPOOLWAS.TotalWorkerProcessStartupFailures</code> — ошибки запуска процессов.

Числовое состояние пула дополняется измерением <code>app_pool_state</code>:

* <code>1</code> — не инициализирован. В текущем пакете текстовая метка записана как <code>Unitialized</code>.
* <code>2</code> — инициализирован (<code>Initialized</code>).
* <code>3</code> — работает (<code>Running</code>).
* <code>4</code> — отключается (<code>Disabling</code>).
* <code>5</code> — отключён (<code>Disabled</code>).
* <code>6</code> — ожидает завершения (<code>Shutdown Pending</code>).
* <code>7</code> — ожидает удаления (<code>Delete Pending</code>).

=== Очереди запросов ===

* <code>iis.current.queue.size</code> — текущее число запросов в очереди.
* <code>iis.cache.hitRate</code> — процент попаданий в кеш очереди.
* <code>iis.HTTPServiceRequestQueues.ArrivalRate</code> — скорость поступления запросов в очередь.
* <code>iis.HTTPServiceRequestQueues.MaxQueueItemAge</code> — возраст старейшего запроса, секунды.
* <code>iis.HTTPServiceRequestQueues.RejectedRequests</code> — число отклонённых запросов.
* <code>iis.HTTPServiceRequestQueues.RejectionRate</code> — скорость отклонения запросов.

Полный перечень ключей, описаний и единиц измерения приведён в разделе <code>metrics</code> файла <code>extension.yaml</code>.

Для метрик, объявленных в источнике как <code>type: count</code>, EEC обрабатывает исходные накопительные счётчики Windows. При построении графиков учитывайте тип метрики и выбранную агрегацию.

Отсутствие данных не следует автоматически считать нулевой нагрузкой или остановкой IIS.

== Сущности и панели ==

Расширение создаёт следующие типы сущностей:

* <code>wmi:iis_service_instance</code> — экземпляр веб-службы IIS.
* <code>wmi:iis_service_site</code> — сайт IIS.
* <code>wmi:iis_service_app_pool</code> — пул приложений IIS.

Сайты и пулы связываются с экземпляром IIS отношением <code>CHILD_OF</code>. При наличии соответствующего обнаруженного хоста формируются связи <code>RUNS_ON</code>.

На странице хоста предусмотрены списки связанных экземпляров IIS, сайтов и пулов. При удалённом сборе без ЕдиногоАгента сущности IIS могут существовать без связи с сущностью хоста.

В правилах сущностей предусмотрен атрибут <code>dt.security_context</code>.

Пакет содержит:

* <code>IIS Overview</code> — классическую обзорную панель.
* <code>IIS Extension Overview</code> — панель в формате документов.
* Страницы анализа IIS Service, IIS Site и IIS App Pool.

На панелях доступны списки объектов, трафик, состояние пулов и их перезапуски. Дополнительные метрики можно использовать в собственных графиках.

В текущем пакете ссылки на настройки в обеих обзорных панелях содержат прежний идентификатор с префиксом <code>custom:</code>. Если кнопка настройки не открывает нужное расширение, откройте <code>ru.ruscomtech.extension.wmi.iis</code> вручную в разделе управления расширениями.

Доступность панели в формате документов зависит от возможностей используемой установки Ключ-АСТРОМ. Для классического интерфейса используйте <code>IIS Overview</code>.

== Проверка работы ==

# Проверьте, что конфигурация мониторинга включена и назначена нужному сборщику.
# Откройте журнал выполнения расширения. Убедитесь, что нет ошибок подключения, авторизации и WMI-запросов.
# Проверьте наличие данных по <code>iis.method.requests.persec</code>, <code>iis.current.connections.gauge</code> и <code>iis.current.applicationPool.state</code>.
# Откройте сущности IIS Service, IIS Site и IIS App Pool.
# Проверьте соответствие имён сайтов и пулов результатам PowerShell-запросов.
# Откройте обзорную панель и выберите период, включающий время после активации конфигурации.

После запуска дайте сборщику выполнить несколько минутных циклов. Для проверки статистики запросов создайте нагрузку на тестовый сайт.

== Диагностика ==

=== Нет данных ===

Проверьте:

* Состояние EEC и выбранную область мониторинга.
* Наличие работающего сайта и пула приложений.
* Доступность WMI-классов из раздела подготовки сервера.
* Значения <code>iis_site</code> и <code>iis_app_pool</code>.
* Включение нужного дополнительного набора функций.
* Журнал выполнения расширения.

Если фильтр использует точное имя, оно должно совпадать со значением <code>Name</code>, возвращаемым соответствующим WMI-классом.

=== Ошибка Access denied ===

Проверьте учётную запись и пароль, права пространства имён <code>root\cimv2</code>, настройки DCOM, доступ к счётчикам производительности и ограничения Remote UAC.

=== Ошибка RPC server is unavailable ===

Проверьте разрешение имени сервера, сетевую доступность, TCP 135, используемые порты RPC и правила межсетевого экрана.

Доступность HTTP-сайта на портах 80 или 443 не подтверждает доступность удалённого WMI.

=== Ошибка Invalid class ===

Проверьте наличие соответствующего WMI-класса и компонентов IIS, предоставляющих счётчики. Запросите класс вручную через <code>Get-CimInstance</code>.

Если отсутствует класс дополнительного набора, отключите этот набор до восстановления необходимых счётчиков.

=== Пустые экземпляры счётчиков ===

Запустите сайт и пул, выполните запрос к сайту, затем повторите проверку WMI. Не все экземпляры доступны до запуска рабочих процессов.

=== Нет связи с хостом ===

Проверьте наличие обнаруженного Windows-хоста в Ключ-АСТРОМ. Удалённый сбор WMI без ЕдиногоАгента не гарантирует создание сущности хоста и соответствующих связей.

== История изменений ==

=== 1.2.1 ===

Пакет для Ключ-АСТРОМ <code>1.313.0+</code>.

В состав версии входят:

* Локальный и удалённый сбор показателей IIS через WMI.
* Переменные WQL для фильтрации основных метрик сайтов, пулов и очередей.
* 67 уникальных ключей метрик: основной набор и шесть дополнительных наборов функций.
* Сбор состояния пулов приложений с текстовым измерением <code>app_pool_state</code>.
* Классическая обзорная панель и панель в формате документов.
* Страницы анализа экземпляров IIS, сайтов и пулов приложений.
* Правила топологии и атрибут <code>dt.security_context</code> в сущностях.

Microsoft IIS - История изменений