一、环境
ubuntu 14.04 LTS
zabbix 2.4.5
nginx/1.4.6
二、配置
1、确定Nginx HttpStubStatusModule模块已经安装，可以通过nginx -V来查看
nginx -V
nginx version: nginx/1.4.6 (Ubuntu)
built by gcc 4.8.2 (Ubuntu 4.8.2-19ubuntu1)
TLS SNI support enabled
configure arguments: --with-cc-opt='-g -O2 -fstack-protector --param=ssp-buffer-size=4 -Wformat -Werror=format-security -D_FORTIFY_SOURCE=2' --with-ld-opt='-Wl,-Bsymbolic-functions -Wl,-z,relro' --prefix=/usr/share/nginx --conf-path=/etc/nginx/nginx.conf --http-log-path=/var/log/nginx/access.log --error-log-path=/var/log/nginx/error.log --lock-path=/var/lock/nginx.lock --pid-path=/run/nginx.pid --http-client-body-temp-path=/var/lib/nginx/body --http-fastcgi-temp-path=/var/lib/nginx/fastcgi --http-proxy-temp-path=/var/lib/nginx/proxy --http-scgi-temp-path=/var/lib/nginx/scgi --http-uwsgi-temp-path=/var/lib/nginx/uwsgi --with-debug --with-pcre-jit --with-ipv6 --with-http_ssl_module --with-http_stub_status_module --with-http_realip_module --with-http_addition_module --with-http_dav_module --with-http_geoip_module --with-http_gzip_static_module --with-http_image_filter_module --with-http_spdy_module --with-http_sub_module --with-http_xslt_module --with-mail --with-mail_ssl_module
2、配置nginx文件
cd /etc/nginx/conf.d
sudo vim zabbix-monitor-nginx.conf
#Add the following into Nginx configuration:
server {
listen 10061;
location /nginx_status {
stub_status on;
access_log off;
allow 127.0.0.1;
deny all;
}
}
# reload nginx
sudo nginx -t && sudo nginx -s reload
3、测试nginx配置是否成功`curl http://127.0.0.1:10061/nginx_status` 获取数据
curl http://127.0.0.1:10061/nginx_status
Active connections: 1
server accepts handled requests
167 167 167
Reading: 0 Writing: 1 Waiting: 0
4、编写nginx status检测脚本
cd /etc/zabbix
sudo mkdir scripts
sudo vim scripts/nginx-check.sh
#Add the following bash codes
#!/bin/bash
##################################
# Zabbix monitoring script
#
# nginx:
# - anything available via nginx stub-status module
#
##################################
# Contact:
# vincent.viallet@gmail.com
##################################
# ChangeLog:
# 20100922 VV initial creation
##################################
# Zabbix requested parameter
ZBX_REQ_DATA="$1"
ZBX_REQ_DATA_URL="$2"
# Nginx defaults
NGINX_STATUS_DEFAULT_URL="http://localhost:80/nginx_status"
WGET_BIN="/usr/bin/wget"
#
# Error handling:
# - need to be displayable in Zabbix (avoid NOT_SUPPORTED)
# - items need to be of type "float" (allow negative + float)
#
ERROR_NO_ACCESS_FILE="-0.9900"
ERROR_NO_ACCESS="-0.9901"
ERROR_WRONG_PARAM="-0.9902"
ERROR_DATA="-0.9903" # either can not connect / bad host / bad port
# Handle host and port if non-default
if [ ! -z "$ZBX_REQ_DATA_URL" ]; then
URL="$ZBX_REQ_DATA_URL"
else
URL="$NGINX_STATUS_DEFAULT_URL"
fi
# save the nginx stats in a variable for future parsing
NGINX_STATS=$($WGET_BIN -q $URL -O - 2> /dev/null)
# error during retrieve
if [ $? -ne 0 -o -z "$NGINX_STATS" ]; then
echo $ERROR_DATA
exit 1
fi
#
# Extract data from nginx stats
#
case $ZBX_REQ_DATA in
active_connections) echo "$NGINX_STATS" | head -1 | cut -f3 -d' ';;
accepted_connections) echo "$NGINX_STATS" | grep -Ev '[a-zA-Z]' | cut -f2 -d' ';;
handled_connections) echo "$NGINX_STATS" | grep -Ev '[a-zA-Z]' | cut -f3 -d' ';;
handled_requests) echo "$NGINX_STATS" | grep -Ev '[a-zA-Z]' | cut -f4 -d' ';;
reading) echo "$NGINX_STATS" | tail -1 | cut -f2 -d' ';;
writing) echo "$NGINX_STATS" | tail -1 | cut -f4 -d' ';;
waiting) echo "$NGINX_STATS" | tail -1 | cut -f6 -d' ';;
*) echo $ERROR_WRONG_PARAM; exit 1;;
esac
exit 0
sudo chown -R zabbix:zabbix ./scripts/
sudo chmod +x nginx-check.sh
5、修改zabbix_agent.conf
sudo vi /etc/zabbix/zabbix_agent.conf
###Change the value of
UnsafeUserParameters=1
### Add User Parameters
UserParameter=nginx[*],/etc/zabbix/scripts/nginx-check.sh "$1" "$2"
sudo service zabbix-agent restart
6、导入Template nginx
Import nginx-template.xml, and link it to a host. Set the host macro {$NGINX_STATUS_URL} if needed.
nginx模板
1 <?xml version="1.0" encoding="UTF-8"?>
2 <zabbix_export>
3 <version>2.0</version>
4 <date>2015-06-19T15:17:58Z</date>
5 <groups>
6 <group>
7 <name>Templates</name>
8 </group>
9 </groups>
10 <templates>
11 <template>
12 <template>Template_Nginx</template>
13 <name>Template_Nginx</name>
14 <groups>
15 <group>
16 <name>Templates</name>
17 </group>
18 </groups>
19 <applications>
20 <application>
21 <name>Nginx</name>
22 </application>
23 </applications>
24 <items>
25 <item>
26 <name>Nginx $1</name>
27 <type>0</type>
28 <snmp_community/>
29 <multiplier>0</multiplier>
30 <snmp_oid/>
31 <key>nginx[waiting,{$NGINX_STATUS_URL}]</key>
32 <delay>60</delay>
33 <history>30</history>
34 <trends>365</trends>
35 <status>0</status>
36 <value_type>0</value_type>
37 <allowed_hosts/>
38 <units/>
39 <delta>0</delta>
40 <snmpv3_securityname/>
41 <snmpv3_securitylevel>0</snmpv3_securitylevel>
42 <snmpv3_authpassphrase/>
43 <snmpv3_privpassphrase/>
44 <formula>1</formula>
45 <delay_flex/>
46 <params/>
47 <ipmi_sensor/>
48 <data_type>0</data_type>
49 <authtype>0</authtype>
50 <username/>
51 <password/>
52 <publickey/>
53 <privatekey/>
54 <port/>
55 <description/>
56 <inventory_link>0</inventory_link>
57 <applications>
58 <application>
59 <name>Nginx</name>
60 </application>
61 </applications>
62 <valuemap/>
63 </item>
64 <item>
65 <name>Nginx $1</name>
66 <type>0</type>
67 <snmp_community/>
68 <multiplier>0</multiplier>
69 <snmp_oid/>
70 <key>nginx[writing,{$NGINX_STATUS_URL}]</key>
71 <delay>60</delay>
72 <history>30</history>
73 <trends>365</trends>
74 <status>0</status>
75 <value_type>0</value_type>
76 <allowed_hosts/>
77 <units/>
78 <delta>0</delta>
79 <snmpv3_securityname/>
80 <snmpv3_securitylevel>0</snmpv3_securitylevel>
81 <snmpv3_authpassphrase/>
82 <snmpv3_privpassphrase/>
83 <formula>1</formula>
84 <delay_flex/>
85 <params/>
86 <ipmi_sensor/>
87 <data_type>0</data_type>
88 <authtype>0</authtype>
89 <username/>
90 <password/>
91 <publickey/>
92 <privatekey/>
93 <port/>
94 <description/>
95 <inventory_link>0</inventory_link>
96 <applications>
97 <application>
98 <name>Nginx</name>
99 </application>
100 </applications>
101 <valuemap/>
102 </item>
103 <item>
104 <name>Nginx $1</name>
105 <type>0</type>
106 <snmp_community/>
107 <multiplier>0</multiplier>
108 <snmp_oid/>
109 <key>nginx[active_connections,{$NGINX_STATUS_URL}]</key>
110 <delay>60</delay>
111 <history>30</history>
112 <trends>365</trends>
113 <status>0</status>
114 <value_type>0</value_type>
115 <allowed_hosts/>
116 <units/>
117 <delta>0</delta>
118 <snmpv3_securityname/>
119 <snmpv3_securitylevel>0</snmpv3_securitylevel>
120 <snmpv3_authpassphrase/>
121 <snmpv3_privpassphrase/>
122 <formula>1</formula>
123 <delay_flex/>
124 <params/>
125 <ipmi_sensor/>
126 <data_type>0</data_type>
127 <authtype>0</authtype>
128 <username/>
129 <password/>
130 <publickey/>
131 <privatekey/>
132 <port/>
133 <description/>
134 <inventory_link>0</inventory_link>
135 <applications>
136 <application>
137 <name>Nginx</name>
138 </application>
139 </applications>
140 <valuemap/>
141 </item>
142 <item>
143 <name>Nginx $1</name>
144 <type>0</type>
145 <snmp_community/>
146 <multiplier>0</multiplier>
147 <snmp_oid/>
148 <key>nginx[reading,{$NGINX_STATUS_URL}]</key>
149 <delay>60</delay>
150 <history>30</history>
151 <trends>365</trends>
152 <status>0</status>
153 <value_type>0</value_type>
154 <allowed_hosts/>
155 <units/>
156 <delta>0</delta>
157 <snmpv3_securityname/>
158 <snmpv3_securitylevel>0</snmpv3_securitylevel>
159 <snmpv3_authpassphrase/>
160 <snmpv3_privpassphrase/>
161 <formula>1</formula>
162 <delay_flex/>
163 <params/>
164 <ipmi_sensor/>
165 <data_type>0</data_type>
166 <authtype>0</authtype>
167 <username/>
168 <password/>
169 <publickey/>
170 <privatekey/>
171 <port/>
172 <description/>
173 <inventory_link>0</inventory_link>
174 <applications>
175 <application>
176 <name>Nginx</name>
177 </application>
178 </applications>
179 <valuemap/>
180 </item>
181 <item>
182 <name>Nginx $1/sec</name>
183 <type>0</type>
184 <snmp_community/>
185 <multiplier>0</multiplier>
186 <snmp_oid/>
187 <key>nginx[handled_requests,{$NGINX_STATUS_URL}]</key>
188 <delay>60</delay>
189 <history>30</history>
190 <trends>365</trends>
191 <status>0</status>
192 <value_type>0</value_type>
193 <allowed_hosts/>
194 <units/>
195 <delta>1</delta>
196 <snmpv3_securityname/>
197 <snmpv3_securitylevel>0</snmpv3_securitylevel>
198 <snmpv3_authpassphrase/>
199 <snmpv3_privpassphrase/>
200 <formula>1</formula>
201 <delay_flex/>
202 <params/>
203 <ipmi_sensor/>
204 <data_type>0</data_type>
205 <authtype>0</authtype>
206 <username/>
207 <password/>
208 <publickey/>
209 <privatekey/>
210 <port/>
211 <description/>
212 <inventory_link>0</inventory_link>
213 <applications>
214 <application>
215 <name>Nginx</name>
216 </application>
217 </applications>
218 <valuemap/>
219 </item>
220 <item>
221 <name>Nginx $1/sec</name>
222 <type>0</type>
223 <snmp_community/>
224 <multiplier>0</multiplier>
225 <snmp_oid/>
226 <key>nginx[accepted_connections,{$NGINX_STATUS_URL}]</key>
227 <delay>60</delay>
228 <history>30</history>
229 <trends>365</trends>
230 <status>0</status>
231 <value_type>0</value_type>
232 <allowed_hosts/>
233 <units/>
234 <delta>1</delta>
235 <snmpv3_securityname/>
236 <snmpv3_securitylevel>0</snmpv3_securitylevel>
237 <snmpv3_authpassphrase/>
238 <snmpv3_privpassphrase/>
239 <formula>1</formula>
240 <delay_flex/>
241 <params/>
242 <ipmi_sensor/>
243 <data_type>0</data_type>
244 <authtype>0</authtype>
245 <username/>
246 <password/>
247 <publickey/>
248 <privatekey/>
249 <port/>
250 <description/>
251 <inventory_link>0</inventory_link>
252 <applications>
253 <application>
254 <name>Nginx</name>
255 </application>
256 </applications>
257 <valuemap/>
258 </item>
259 <item>
260 <name>Nginx $1/sec</name>
261 <type>0</type>
262 <snmp_community/>
263 <multiplier>0</multiplier>
264 <snmp_oid/>
265 <key>nginx[handled_connections,{$NGINX_STATUS_URL}]</key>
266 <delay>60</delay>
267 <history>30</history>
268 <trends>365</trends>
269 <status>0</status>
270 <value_type>0</value_type>
271 <allowed_hosts/>
272 <units/>
273 <delta>1</delta>
274 <snmpv3_securityname/>
275 <snmpv3_securitylevel>0</snmpv3_securitylevel>
276 <snmpv3_authpassphrase/>
277 <snmpv3_privpassphrase/>
278 <formula>1</formula>
279 <delay_flex/>
280 <params/>
281 <ipmi_sensor/>
282 <data_type>0</data_type>
283 <authtype>0</authtype>
284 <username/>
285 <password/>
286 <publickey/>
287 <privatekey/>
288 <port/>
289 <description/>
290 <inventory_link>0</inventory_link>
291 <applications>
292 <application>
293 <name>Nginx</name>
294 </application>
295 </applications>
296 <valuemap/>
297 </item>
298 <item>
299 <name>Number of $1 process</name>
300 <type>0</type>
301 <snmp_community>public</snmp_community>
302 <multiplier>0</multiplier>
303 <snmp_oid>interfaces.ifTable.ifEntry.ifInOctets.1</snmp_oid>
304 <key>proc.num[nginx]</key>
305 <delay>300</delay>
306 <history>30</history>
307 <trends>365</trends>
308 <status>0</status>
309 <value_type>3</value_type>
310 <allowed_hosts/>
311 <units/>
312 <delta>0</delta>
313 <snmpv3_securityname/>
314 <snmpv3_securitylevel>0</snmpv3_securitylevel>
315 <snmpv3_authpassphrase/>
316 <snmpv3_privpassphrase/>
317 <formula>1</formula>
318 <delay_flex/>
319 <params/>
320 <ipmi_sensor/>
321 <data_type>0</data_type>
322 <authtype>0</authtype>
323 <username/>
324 <password/>
325 <publickey/>
326 <privatekey/>
327 <port/>
328 <description/>
329 <inventory_link>0</inventory_link>
330 <applications/>
331 <valuemap/>
332 </item>
333 </items>
334 <discovery_rules/>
335 <macros>
336 <macro>
337 <macro>{$NGINX_STATUS_URL}</macro>
338 <value>http://127.0.0.1:10061/nginx_status</value>
339 </macro>
340 </macros>
341 <templates/>
342 <screens/>
343 </template>
344 </templates>
345 <triggers>
346 <trigger>
347 <expression>{Template_Nginx:proc.num[nginx].last(0)}=0</expression>
348 <name>Nginx is not running on {HOSTNAME}</name>
349 <url/>
350 <status>0</status>
351 <priority>4</priority>
352 <description>Nginx is not running.
353
354 It has been stopped / shutdown or has crashed.
355 Check on the server for more details:
356 - w / last
357 - dmesg logs
358 - /var/log/messages
359 - nginx error logs</description>
360 <type>0</type>
361 <dependencies/>
362 </trigger>
363 </triggers>
364 <graphs>
365 <graph>
366 <name>Nginx - Connections and Requests status</name>
367 <width>900</width>
368 <height>200</height>
369 <yaxismin>0.0000</yaxismin>
370 <yaxismax>100.0000</yaxismax>
371 <show_work_period>0</show_work_period>
372 <show_triggers>0</show_triggers>
373 <type>0</type>
374 <show_legend>1</show_legend>
375 <show_3d>0</show_3d>
376 <percent_left>0.0000</percent_left>
377 <percent_right>0.0000</percent_right>
378 <ymin_type_1>1</ymin_type_1>
379 <ymax_type_1>0</ymax_type_1>
380 <ymin_item_1>0</ymin_item_1>
381 <ymax_item_1>0</ymax_item_1>
382 <graph_items>
383 <graph_item>
384 <sortorder>0</sortorder>
385 <drawtype>1</drawtype>
386 <color>FF9999</color>
387 <yaxisside>0</yaxisside>
388 <calc_fnc>4</calc_fnc>
389 <type>0</type>
390 <item>
391 <host>Template_Nginx</host>
392 <key>nginx[accepted_connections,{$NGINX_STATUS_URL}]</key>
393 </item>
394 </graph_item>
395 <graph_item>
396 <sortorder>1</sortorder>
397 <drawtype>2</drawtype>
398 <color>990000</color>
399 <yaxisside>0</yaxisside>
400 <calc_fnc>4</calc_fnc>
401 <type>0</type>
402 <item>
403 <host>Template_Nginx</host>
404 <key>nginx[handled_connections,{$NGINX_STATUS_URL}]</key>
405 </item>
406 </graph_item>
407 <graph_item>
408 <sortorder>2</sortorder>
409 <drawtype>0</drawtype>
410 <color>009900</color>
411 <yaxisside>0</yaxisside>
412 <calc_fnc>4</calc_fnc>
413 <type>0</type>
414 <item>
415 <host>Template_Nginx</host>
416 <key>nginx[handled_requests,{$NGINX_STATUS_URL}]</key>
417 </item>
418 </graph_item>
419 </graph_items>
420 </graph>
421 <graph>
422 <name>Nginx - Threads status</name>
423 <width>900</width>
424 <height>200</height>
425 <yaxismin>0.0000</yaxismin>
426 <yaxismax>100.0000</yaxismax>
427 <show_work_period>0</show_work_period>
428 <show_triggers>0</show_triggers>
429 <type>1</type>
430 <show_legend>1</show_legend>
431 <show_3d>0</show_3d>
432 <percent_left>0.0000</percent_left>
433 <percent_right>0.0000</percent_right>
434 <ymin_type_1>1</ymin_type_1>
435 <ymax_type_1>0</ymax_type_1>
436 <ymin_item_1>0</ymin_item_1>
437 <ymax_item_1>0</ymax_item_1>
438 <graph_items>
439 <graph_item>
440 <sortorder>0</sortorder>
441 <drawtype>1</drawtype>
442 <color>990000</color>
443 <yaxisside>0</yaxisside>
444 <calc_fnc>4</calc_fnc>
445 <type>0</type>
446 <item>
447 <host>Template_Nginx</host>
448 <key>nginx[writing,{$NGINX_STATUS_URL}]</key>
449 </item>
450 </graph_item>
451 <graph_item>
452 <sortorder>1</sortorder>
453 <drawtype>1</drawtype>
454 <color>999900</color>
455 <yaxisside>0</yaxisside>
456 <calc_fnc>4</calc_fnc>
457 <type>0</type>
458 <item>
459 <host>Template_Nginx</host>
460 <key>nginx[reading,{$NGINX_STATUS_URL}]</key>
461 </item>
462 </graph_item>
463 <graph_item>
464 <sortorder>2</sortorder>
465 <drawtype>1</drawtype>
466 <color>009900</color>
467 <yaxisside>0</yaxisside>
468 <calc_fnc>4</calc_fnc>
469 <type>0</type>
470 <item>
471 <host>Template_Nginx</host>
472 <key>nginx[waiting,{$NGINX_STATUS_URL}]</key>
473 </item>
474 </graph_item>
475 </graph_items>
476 </graph>
477 </graphs>
478 </zabbix_export>
参考资料：https://github.com/jizhang