Source: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent?at=release/7.0
IIS by Zabbix agent
Overview
The template to monitor IIS (Internet Information Services) by Zabbix that works without any external scripts.
Requirements
Zabbix version: 7.0 and higher.
Tested versions
This template has been tested on:
- Windows Server 2012R2
Configuration
Zabbix should be configured according to the instructions in the Templates out of the box section.
Setup
You have to enable the following Windows Features (Control Panel > Programs and Features > Turn Windows features on or off) on your server
Web Server (IIS)
Web Server (IIS)\Management Tools\IIS Management Scripts and Tools
Optionally, it is possible to customize the template:
- Set value for the macro {$IIS.QUEUE.MAX.WARN}, if you want to receive alerts when a number of requests in the application pool queue exceeds the threshold.
- If you use a non-standard port for the IIS, don't forget to update the macros {$IIS.SERVICE} and {$IIS.PORT}.
- Change the value of macro {$IIS.APPPOOL.MONITORED} to "0", if you want to disable all notifications about application pools state.
You can also add additional context macro {$IIS.APPPOOL.MONITORED:<AppPoolName>} for excluding specific application pools from monitoring. - Change regexp in the macros {$IIS.APPPOOL.MATCHES} and {$IIS.APPPOOL.NOT_MATCHES} used for filtering application pools discovery results.
Macros used
Name | Description | Default |
---|---|---|
{$IIS.PORT} | Listening port. |
80 |
{$IIS.SERVICE} | The service (http/https/etc) for port check. See "net.tcp.service" documentation page for more information: https://www.zabbix.com/documentation/7.0/manual/config/items/itemtypes/simple_checks |
http |
{$IIS.QUEUE.MAX.WARN} | Maximum application pool's request queue length for trigger expression. |
|
{$IIS.QUEUE.MAX.TIME} | The time during which the queue length may exceed the threshold. |
5m |
{$IIS.APPPOOL.NOT_MATCHES} | This macro is used in application pools discovery. Can be overridden on the host or linked template level. |
<CHANGE_IF_NEEDED> |
{$IIS.APPPOOL.MATCHES} | This macro is used in application pools discovery. Can be overridden on the host or linked template level. |
.+ |
{$IIS.APPPOOL.MONITORED} | Monitoring status for discovered application pools. Use context to avoid trigger firing for specific application pools. "1" - enabled, "0" - disabled. |
1 |
Items
Name | Description | Type | Key and additional info |
---|---|---|---|
World Wide Web Publishing Service (W3SVC) state | The World Wide Web Publishing Service (W3SVC) provides web connectivity and administration of websites through the IIS snap-in. If the World Wide Web Publishing Service stops, the operating system cannot serve any form of web request. This service was dependent on "Windows Process Activation Service". |
Zabbix agent | service.info[W3SVC] Preprocessing
|
Windows Process Activation Service (WAS) state | Windows Process Activation Service (WAS) is a tool for managing worker processes that contain applications that host Windows Communication Foundation (WCF) services. Worker processes handle requests that are sent to a Web Server for specific application pools. Each application pool sets boundaries for the applications it contains. |
Zabbix agent | service.info[WAS] Preprocessing
|
{$IIS.PORT} port ping | Simple check | net.tcp.service[{$IIS.SERVICE},,{$IIS.PORT}] Preprocessing
|
|
Uptime | The service uptime expressed in seconds. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Service Uptime"] |
Bytes Received per second | The average rate per minute at which data bytes are received by the service at the Application Layer. Does not include protocol headers or control bytes. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Bytes Received/sec", 60] |
Bytes Sent per second | The average rate per minute at which data bytes are sent by the service. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Bytes Sent/sec", 60] |
Bytes Total per second | The average rate per minute of total bytes/sec transferred by the Web service (sum of bytes sent/sec and bytes received/sec). |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Bytes Total/Sec", 60] |
Current connections | The number of active connections. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Current Connections"] |
Total connection attempts | The total number of connections to the Web or FTP service that have been attempted since service startup. The count is the total for all Web sites or FTP sites combined. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Total Connection Attempts (all instances)"] Preprocessing
|
Connection attempts per second | The average rate per minute that connections using the Web service are being attempted. The count is the average for all Web sites combined. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Connection Attempts/Sec", 60] Preprocessing
|
Anonymous users per second | The number of requests from users over an anonymous connection per second. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Anonymous Users/sec", 60] |
NonAnonymous users per second | The number of requests from users over a non-anonymous connection per second. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\NonAnonymous Users/sec", 60] |
Method GET requests per second | The rate of HTTP requests made using the GET method. GET requests are generally used for basic file retrievals or image maps, though they can be used with forms. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Get Requests/Sec", 60] Preprocessing
|
Method COPY requests per second | The rate of HTTP requests made using the COPY method. Copy requests are used for copying files and directories. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Copy Requests/Sec", 60] Preprocessing
|
Method CGI requests per second | The rate of CGI requests that are simultaneously being processed by the Web service. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\CGI Requests/Sec", 60] Preprocessing
|
Method DELETE requests per second | The rate of HTTP requests using the DELETE method made. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Delete Requests/Sec", 60] Preprocessing
|
Method HEAD requests per second | The rate of HTTP requests using the HEAD method made. HEAD requests generally indicate a client is querying the state of a document they already have to see if it needs to be refreshed. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Head Requests/Sec", 60] Preprocessing
|
Method ISAPI requests per second | The rate of ISAPI Extension requests that are simultaneously being processed by the Web service. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\ISAPI Extension Requests/Sec", 60] Preprocessing
|
Method LOCK requests per second | The rate of HTTP requests made using the LOCK method. Lock requests are used to lock a file for one user so that only that user can modify the file. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Lock Requests/Sec", 60] Preprocessing
|
Method MKCOL requests per second | The rate of HTTP requests using the MKCOL method made. Mkcol requests are used to create directories on the server. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Mkcol Requests/Sec", 60] Preprocessing
|
Method MOVE requests per second | The rate of HTTP requests using the MOVE method made. Move requests are used for moving files and directories. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Move Requests/Sec", 60] Preprocessing
|
Method OPTIONS requests per second | The rate of HTTP requests using the OPTIONS method made. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Options Requests/Sec", 60] Preprocessing
|
Method POST requests per second | Rate of HTTP requests using POST method. Generally used for forms or gateway requests. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Post Requests/Sec", 60] Preprocessing
|
Method PROPFIND requests per second | The rate of HTTP requests using the PROPFIND method made. Propfind requests retrieve property values on files and directories. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Propfind Requests/Sec", 60] Preprocessing
|
Method PROPPATCH requests per second | The rate of HTTP requests using the PROPPATCH method made. Proppatch requests set property values on files and directories. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Proppatch Requests/Sec", 60] Preprocessing
|
Method PUT requests per second | The rate of HTTP requests using the PUT method made. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Put Requests/Sec", 60] Preprocessing
|
Method MS-SEARCH requests per second | The rate of HTTP requests using the MS-SEARCH method made. Search requests are used to query the server to find resources that match a set of conditions provided by the client. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Search Requests/Sec", 60] Preprocessing
|
Method TRACE requests per second | The rate of HTTP requests using the TRACE method made. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Trace Requests/Sec", 60] Preprocessing
|
Method TRACE requests per second | The rate of HTTP requests using the UNLOCK method made. Unlock requests are used to remove locks from files. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Unlock Requests/Sec", 60] Preprocessing
|
Method Total requests per second | The rate of all HTTP requests received. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Total Method Requests/Sec", 60] Preprocessing
|
Method Total Other requests per second | Total Other Request Methods is the number of HTTP requests that are not OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, MOVE, COPY, MKCOL, PROPFIND, PROPPATCH, SEARCH, LOCK or UNLOCK methods (since service startup). Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Other Request Methods/Sec", 60] Preprocessing
|
Locked errors per second | The rate of errors due to requests that couldn't be satisfied by the server because the requested document was locked. These are generally reported as an HTTP 423 error code to the client. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Locked Errors/Sec", 60] Preprocessing
|
Not Found errors per second | The rate of errors due to requests that couldn't be satisfied by the server because the requested document could not be found. These are generally reported to the client with HTTP error code 404. Average per minute. |
Zabbix agent | perf_counter_en["\Web Service(_Total)\Not Found Errors/Sec", 60] Preprocessing
|
Files cache hits percentage | The ratio of user-mode file cache hits to total cache requests (since service startup). Note: This value might be low if the Kernel URI cache hits percentage is high. |
Zabbix agent | perf_counter_en["\Web Service Cache\File Cache Hits %"] Preprocessing
|
URIs cache hits percentage | The ratio of user-mode URI Cache Hits to total cache requests (since service startup) |
Zabbix agent | perf_counter_en["\Web Service Cache\URI Cache Hits %"] Preprocessing
|
File cache misses | The total number of unsuccessful lookups in the user-mode file cache since service startup. |
Zabbix agent | perf_counter_en["\Web Service Cache\File Cache Misses"] Preprocessing
|
URI cache misses | The total number of unsuccessful lookups in the user-mode URI cache since service startup. |
Zabbix agent | perf_counter_en["\Web Service Cache\URI Cache Misses"] Preprocessing
|
Triggers
Name | Description | Expression | Severity | Dependencies and additional info |
---|---|---|---|---|
The World Wide Web Publishing Service (W3SVC) is not running | The World Wide Web Publishing Service (W3SVC) is not in the running state. IIS cannot start. |
last(/IIS by Zabbix agent/service.info[W3SVC])<>0 |
High | Depends on:
|
Windows process Activation Service (WAS) is not running | Windows Process Activation Service (WAS) is not in the running state. IIS cannot start. |
last(/IIS by Zabbix agent/service.info[WAS])<>0 |
High | |
Port {$IIS.PORT} is down | last(/IIS by Zabbix agent/net.tcp.service[{$IIS.SERVICE},,{$IIS.PORT}])=0 |
Average | Manual close: Yes Depends on:
|
|
has been restarted | Uptime is less than 10 minutes. |
last(/IIS by Zabbix agent/perf_counter_en["\Web Service(_Total)\Service Uptime"])<10m |
Info | Manual close: Yes |
LLD rule Application pools discovery
Name | Description | Type | Key and additional info |
---|---|---|---|
Application pools discovery | Zabbix agent | wmi.getall[root\webAdministration, select Name from ApplicationPool] |
Item prototypes for Application pools discovery
Name | Description | Type | Key and additional info |
---|---|---|---|
{#APPPOOL} Uptime | The web application uptime period since the last restart. |
Zabbix agent | perf_counter_en["\APP_POOL_WAS({#APPPOOL})\Current Application Pool Uptime"] |
AppPool {#APPPOOL} state | The state of the application pool. |
Zabbix agent | perf_counter_en["\APP_POOL_WAS({#APPPOOL})\Current Application Pool State"] Preprocessing
|
AppPool {#APPPOOL} recycles | The number of times the application pool has been recycled since Windows Process Activation Service (WAS) started. |
Zabbix agent | perf_counter_en["\APP_POOL_WAS({#APPPOOL})\Total Application Pool Recycles"] Preprocessing
|
AppPool {#APPPOOL} current queue size | The number of requests in the queue. |
Zabbix agent | perf_counter_en["\HTTP Service Request Queues({#APPPOOL})\CurrentQueueSize"] Preprocessing
|
Trigger prototypes for Application pools discovery
Name | Description | Expression | Severity | Dependencies and additional info |
---|---|---|---|---|
{#APPPOOL} has been restarted | Uptime is less than 10 minutes. |
last(/IIS by Zabbix agent/perf_counter_en["\APP_POOL_WAS({#APPPOOL})\Current Application Pool Uptime"])<10m |
Info | Manual close: Yes |
Application pool {#APPPOOL} is not in Running state | last(/IIS by Zabbix agent/perf_counter_en["\APP_POOL_WAS({#APPPOOL})\Current Application Pool State"])<>3 and {$IIS.APPPOOL.MONITORED:"{#APPPOOL}"}=1 |
High | Depends on:
|
|
Application pool {#APPPOOL} has been recycled | last(/IIS by Zabbix agent/perf_counter_en["\APP_POOL_WAS({#APPPOOL})\Total Application Pool Recycles"],#1)<>last(/IIS by Zabbix agent/perf_counter_en["\APP_POOL_WAS({#APPPOOL})\Total Application Pool Recycles"],#2) and {$IIS.APPPOOL.MONITORED:"{#APPPOOL}"}=1 |
Info | ||
Request queue of {#APPPOOL} is too large | min(/IIS by Zabbix agent/perf_counter_en["\HTTP Service Request Queues({#APPPOOL})\CurrentQueueSize"],{$IIS.QUEUE.MAX.TIME})>{$IIS.QUEUE.MAX.WARN} |
Warning | Depends on:
|
Feedback
Please report any issues with the template at https://support.zabbix.com
You can also provide feedback, discuss the template, or ask for help at ZABBIX forums