[lang_en]Monitoring nginx Server Statistics With rrdtool[/lang_en][lang_ru]Сбор Статиcтики О Работе Сервера nginx При Помощи rrdtool[/lang_ru]

Posted in: Development, Networks
Tags: Nginx

29 Apr2006

[lang_en]

Few days ago I have installed nginx on one of our adult projects as reverse proxy server and for static files management. Yesterday this server got 200Mbit/sec traffic and because all admins like to create miscellaneous graphs, I have decided to draw nginx stats on graphs to see server load not only in megabits and load averages. As the result, I have created perl script, which uses RRDs perl module to create and manage rrd-database and very beautiful graphs.

[/lang_en]

[lang_ru]

Неcколько дней тому назад я установил nginx на одном из своих adult-проектов как reverse proxy server и сервер для раздачи статичечких файлов. Вчера, когда трафик с этого сервера достиг 200Mbit/сек и, наверное, потому, что все админы любят рисовать графики, я решил отобразить статистику работы сервера nginx на графиках чтобы увидеть загрузку не только в мегабитах и системных параметрах загрузки сервера. В результате работы над этими графиками родился скрипт на perl, использующий модель RRDs для создания и управления базой rrd и рисования очень красивых графиков.

[/lang_ru]

[lang_en]

This script is very easy to install and configure. You can use following steps to get pretty stats graph for your nginx-powered server:

Modify your nginx config file and add following location to it:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

http {
...
server {
listen SOME.IP.ADD.RESS;
...
location /nginx_status {
stub_status on;
access_log off;
allow SOME.IP.ADD.RESS;
deny all;
}
...
}
...
}

Test your config file with following command:

1
2
3
4

# /your/installation/sbin/nginx -t
2006/04/29 04:24:36 [info] 31676#0: the configuration file /opt/nginx/conf/nginx.conf syntax is ok
2006/04/29 04:24:36 [info] 31676#0: the configuration file /opt/nginx/conf/nginx.conf was tested successfully
#

I you will get error about stub_status directive, check your nginx – it should be configured with ----with-http_stub_status_module option.

If your configuration is OK, you can restart nginx and test it:
1
2
3
4
5
6
croesus:~# GET http://your-domain.com/nginx_status
Active connections: 1492
server accepts handled requests
2124355 2124355 8278635
Reading: 6 Writing: 405 Waiting: 1081
croesus:~#
Download my perl script: rrd_nginx.pl and make it executable with
1
# chmod +x rrd_nginx.pl

Change settings in rrd_nginx.pl to let script know where it will save rrd-base and images:

1
2
3
4
5
6
7
8
9
10
11

#!/usr/bin/perl
use RRDs;
use LWP::UserAgent;

# define location of rrdtool databases
my $rrd = '/opt/rrd';
# define location of images
my $img = '/opt/rrd/html';
# define your nginx stats URL
my $URL = "http://your-domain.com/nginx_status";
...

Last step is to insert following string to /etc/crontab file and to restart cron daemon:
```
* *     * * *   root    /some/path/rrd_nginx.pl
```

When all preparations will be finished, you get following images in your $img directory:

Nginx connections statistics:
Nginx requests statistics:

That is all. If you have some comments or suggestions, feel free to post them in comments section and, it you like this howto, you can click on advertisements ;-).

[/lang_en]

[lang_ru]

Скрипт очень прост в установке и настройке. Вы можете использовать следующий набор шагов для получения симпатичных графиков со статистикой работы вашего nginx-сервера:

Добавьте в конфигурационный файл nginx следующий раздел location:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

http {
...
server {
listen SOME.IP.ADD.RESS;
...
location /nginx_status {
stub_status on;
access_log off;
allow SOME.IP.ADD.RESS;
deny all;
}
...
}
...
}

Проверьте свою конфигурацию следующей командой:

1
2
3
4

Если вы получите сообщение о том, что директива stub_status неизвестна, то проверьте включена ли опция ----with-http_stub_status_module при компиляции nginx.

Если проверка конфигурации прошла успешно, перезапустите nginx и проверьте статистику:
1
2
3
4
5
6
croesus:~# GET http://your-domain.com/nginx_status
Active connections: 1492
server accepts handled requests
2124355 2124355 8278635
Reading: 6 Writing: 405 Waiting: 1081
croesus:~#
Скачайте скрипт генерации графиков: rrd_nginx.pl и сделайте его исполнимым:
1
# chmod +x rrd_nginx.pl

Измените настройки в файле rrd_nginx.pl, чтобы дать скрипту знать, куда складывать rrd-базу и картинки со статистикой:

1
2
3
4
5
6
7
8
9
10
11

#!/usr/bin/perl
use RRDs;
use LWP::UserAgent;

# определите путь к базам для rrdtool
my $rrd = '/opt/rrd';
# определите путь к картинкам
my $img = '/opt/rrd/html';
# определите URL для статистики nginx
my $URL = "http://your-domain.com/nginx_status";
...

Последний шаг в настройке – добавление следующей команды в файл /etc/crontab и перезапуск демона cron:
```
* *     * * *   root    /some/path/rrd_nginx.pl
```

Когда все приготовления будут завершены, Вы получите в каталоге $img следующие графики:

Nginx connections statistics:
Nginx requests statistics:

Вот и все. Если у Вас есть какие-либо коментарии или пожелания, оставляйте их в разделе коментариев. Если заметка вам понравилась, можете поддержать автора обратив внимание на рекламные объявления на этой странице. ;-).

[/lang_ru]

Homo-Adminus Blog

Yet Another Admin’s Blog