# Nginx by Zabbix agent ## Overview This template is developed to monitor Nginx by Zabbix that works without any external scripts. Most of the metrics are collected in one go, thanks to Zabbix bulk data collection. The template `Nginx by Zabbix agent` - collects metrics by polling the [Module ngx_http_stub_status_module](https://nginx.ru/en/docs/http/ngx_http_stub_status_module.html) locally with Zabbix agent: ```text Active connections: 291 server accepts handled requests 16630948 16630948 31070465 Reading: 6 Writing: 179 Waiting: 106 ``` Note that this template doesn't support HTTPS and redirects (limitations of `web.page.get`). It also uses Zabbix agent to collect `Nginx` Linux process statistics, such as CPU usage, memory usage and whether the process is running or not. ## Requirements Zabbix version: 7.0 and higher. ## Tested versions This template has been tested on: - Nginx 1.17.2 ## Configuration > Zabbix should be configured according to the instructions in the [Templates out of the box](https://www.zabbix.com/documentation/7.0/manual/config/templates_out_of_the_box) section. ## Setup See the setup instructions for [ngx_http_stub_status_module](https://nginx.ru/en/docs/http/ngx_http_stub_status_module.html). Test the availability of the `http_stub_status_module` `nginx -V 2>&1 | grep -o with-http_stub_status_module`. Example configuration of Nginx: ```text location = /basic_status { stub_status; allow 127.0.0.1; allow ::1; deny all; } ``` If you use another location, then don't forget to change the {$NGINX.STUB_STATUS.PATH} macro. Example answer from Nginx: ```text Active connections: 291 server accepts handled requests 16630948 16630948 31070465 Reading: 6 Writing: 179 Waiting: 106 ``` Note that this template doesn't support https and redirects (limitations of web.page.get). Install and setup [Zabbix agent](https://www.zabbix.com/documentation/7.0/manual/installation/install_from_packages). ### Macros used |Name|Description|Default| |----|-----------|-------| |{$NGINX.STUB_STATUS.HOST}|
The hostname or IP address of the Nginx host or Nginx container of `astub_status`.
|`localhost`| |{$NGINX.STUB_STATUS.PATH}|The path of the `Nginx stub_status` page.
|`basic_status`| |{$NGINX.STUB_STATUS.PORT}|The port of the `Nginx stub_status` host or container.
|`80`| |{$NGINX.RESPONSE_TIME.MAX.WARN}|The maximum response time of Nginx expressed in seconds for a trigger expression.
|`10`| |{$NGINX.DROP_RATE.MAX.WARN}|The critical rate of the dropped connections for a trigger expression.
|`1`| |{$NGINX.PROCESS_NAME}|The process name filter for the Nginx process discovery.
|`nginx`| |{$NGINX.PROCESS.NAME.PARAMETER}|The process name of the Nginx server used in the item key `proc.get`. It could be specified if the correct process name is known.
|| ### Items |Name|Description|Type|Key and additional info| |----|-----------|----|-----------------------| |Nginx: Get stub status page|The following status information is provided:
`Active connections` - the current number of active client connections including waiting connections.
`Accepted` - the total number of accepted client connections.
`Handled` - the total number of handled connections. Generally, the parameter value is the same as for the accepted connections, unless some resource limits have been reached (for example, the `worker_connections` limit).
`Requests` - the total number of client requests.
`Reading` - the current number of connections where Nginx is reading the request header.
`Writing` - the current number of connections where Nginx is writing a response back to the client.
`Waiting` - the current number of idle client connections waiting for a request.
See also [Module ngx_http_stub_status_module](https://nginx.org/en/docs/http/ngx_http_stub_status_module.html).
|Zabbix agent|web.page.get["{$NGINX.STUB_STATUS.HOST}","{$NGINX.STUB_STATUS.PATH}","{$NGINX.STUB_STATUS.PORT}"]| |Nginx: Service status||Zabbix agent|net.tcp.service[http,"{$NGINX.STUB_STATUS.HOST}","{$NGINX.STUB_STATUS.PORT}"]**Preprocessing**
Discard unchanged with heartbeat: `10m`
The total number of client requests.
|Dependent item|nginx.requests.total**Preprocessing**
Regular expression: `The text is too long. Please see the template.`
The total number of client requests.
|Dependent item|nginx.requests.total.rate**Preprocessing**
Regular expression: `The text is too long. Please see the template.`
The total number of accepted client connections.
|Dependent item|nginx.connections.accepted.rate**Preprocessing**
Regular expression: `The text is too long. Please see the template.`
The total number of dropped client connections.
|Dependent item|nginx.connections.dropped.rate**Preprocessing**
JavaScript: `The text is too long. Please see the template.`
The total number of handled connections. Generally, the parameter value is the same as for the accepted connections, unless some resource limits have been reached (for example, the `worker_connections limit`).
|Dependent item|nginx.connections.handled.rate**Preprocessing**
Regular expression: `The text is too long. Please see the template.`
The current number of active client connections including waiting connections.
|Dependent item|nginx.connections.active**Preprocessing**
Regular expression: `Active connections: ([0-9]+) \1`
The current number of connections where Nginx is reading the request header.
|Dependent item|nginx.connections.reading**Preprocessing**
Regular expression: `Reading: ([0-9]+) Writing: ([0-9]+) Waiting: ([0-9]+) \1`
The current number of idle client connections waiting for a request.
|Dependent item|nginx.connections.waiting**Preprocessing**
Regular expression: `Reading: ([0-9]+) Writing: ([0-9]+) Waiting: ([0-9]+) \3`
The current number of connections where Nginx is writing a response back to the client.
|Dependent item|nginx.connections.writing**Preprocessing**
Regular expression: `Reading: ([0-9]+) Writing: ([0-9]+) Waiting: ([0-9]+) \2`
**Preprocessing**
Regular expression: `Server: nginx\/(.+(?
Discard unchanged with heartbeat: `1d`
The aggregated data of summary metrics for all processes.
|Zabbix agent|proc.get[{$NGINX.PROCESS.NAME.PARAMETER},,,summary]| ### Triggers |Name|Description|Expression|Severity|Dependencies and additional info| |----|-----------|----------|--------|--------------------------------| |Nginx: Version has changed|The Nginx version has changed. Acknowledge to close the problem manually.
|`last(/Nginx by Zabbix agent/nginx.version,#1)<>last(/Nginx by Zabbix agent/nginx.version,#2) and length(last(/Nginx by Zabbix agent/nginx.version))>0`|Info|**Manual close**: Yes| ### LLD rule Nginx process discovery |Name|Description|Type|Key and additional info| |----|-----------|----|-----------------------| |Nginx process discovery|The discovery of Nginx process summary.
|Dependent item|nginx.proc.discovery| ### Item prototypes for Nginx process discovery |Name|Description|Type|Key and additional info| |----|-----------|----|-----------------------| |Nginx: CPU utilization|The percentage of the CPU utilization by a process {#NGINX.NAME}.
|Zabbix agent|proc.cpu.util[{#NGINX.NAME}]| |Nginx: Get process data|The summary metrics aggregated by a process {#NGINX.NAME}.
|Dependent item|nginx.proc.get[{#NGINX.NAME}]**Preprocessing**
JSON Path: `$.[?(@["name"]=="{#NGINX.NAME}")].first()`
⛔️Custom on fail: Set value to: `Failed to retrieve process {#NGINX.NAME} data`
The summary of virtual memory used by a process {#NGINX.NAME} expressed in bytes.
|Dependent item|nginx.proc.vmem[{#NGINX.NAME}]**Preprocessing**
JSON Path: `$.vsize`
⛔️Custom on fail: Discard value
The summary of resident set size memory used by a process {#NGINX.NAME} expressed in bytes.
|Dependent item|nginx.proc.rss[{#NGINX.NAME}]**Preprocessing**
JSON Path: `$.rss`
⛔️Custom on fail: Discard value
The percentage of real memory used by a process {#NGINX.NAME}.
|Dependent item|nginx.proc.pmem[{#NGINX.NAME}]**Preprocessing**
JSON Path: `$.pmem`
⛔️Custom on fail: Discard value
The number of running processes {#NGINX.NAME}.
|Dependent item|nginx.proc.num[{#NGINX.NAME}]**Preprocessing**
JSON Path: `$.processes`
⛔️Custom on fail: Set value to: `0`
Discard unchanged with heartbeat: `1h`
The rate of dropping connections has been greater than {$NGINX.DROP_RATE.MAX.WARN} for the last 5 minutes.
|`min(/Nginx by Zabbix agent/nginx.connections.dropped.rate,5m) > {$NGINX.DROP_RATE.MAX.WARN} and last(/Nginx by Zabbix agent/nginx.proc.num[{#NGINX.NAME}])>0`|Warning|**Depends on**:Zabbix has not received any data for items for the last 30 minutes.
|`(find(/Nginx by Zabbix agent/web.page.get["{$NGINX.STUB_STATUS.HOST}","{$NGINX.STUB_STATUS.PATH}","{$NGINX.STUB_STATUS.PORT}"],,"like","HTTP/1.1 200")=0 or nodata(/Nginx by Zabbix agent/web.page.get["{$NGINX.STUB_STATUS.HOST}","{$NGINX.STUB_STATUS.PATH}","{$NGINX.STUB_STATUS.PORT}"],30m)) and last(/Nginx by Zabbix agent/nginx.proc.num[{#NGINX.NAME}])>0`|Warning|**Manual close**: Yes