27 мая 2010 г.

Мониторим NGINX в MUNIN

Так как мы решили в качестве веб сервера использовать Nginx, а средством мониторинга системы выбрали Munin, то логичным средством мониторинга веб сервера было бы использовать плагины для Munin. Именно это мы сегодня и рассмотрим.
В /etc/munin/plugins создаем два файла - nginx_request и nginx_status со следующим содержимым: nginx_request
#!/usr/bin/perl
#!/usr/bin/perl
# -*- cperl -*-
=head1 NAME
nginx_request - Munin plugin to show number of requests pr. second to nginx.
=head1 APPLICABLE SYSTEMS
Any nginx host
=head1 CONFIGURATION
This shows the default configuration of this plugin.  You can override
the status URL.
  [nginx*]
      env.url http://hostname/nginx_status
Nginx must also be configured.  Firstly the stub-status module must be
compiled, and secondly it must be configured like this:
  server {
        listen 80;
        server_name localhost;
        location /nginx_status {
                stub_status on;
                access_log   off;
                allow 127.0.0.1;
                deny all;
        }
  }
=head1 MAGIC MARKERS
  #%# family=auto
  #%# capabilities=autoconf
=head1 VERSION
  $Id: $
=head1 BUGS
None known
=head1 AUTHOR
Unknown
=head1 LICENSE
Unknown.  Not specified by the unknown author.  Nginx has a BSD
license.  Munin is GPLv2 licensed.
=cut
my $ret = undef;
if (! eval "require LWP::UserAgent;"){
        $ret = "LWP::UserAgent not found";
}
chomp(my $fqdn=`hostname -f`);
my $URL = exists $ENV{'url'} ? $ENV{'url'} : "http://$fqdn/nginx_status";
my $port = exists $ENV{'port'} ? $ENV{'port'} : "80";
if ( exists $ARGV[0] and $ARGV[0] eq "autoconf" )
{
        if ($ret){
                print "no ($ret)\n";
                exit 1;
        }

        my $ua = LWP::UserAgent->new(timeout => 30);
        my $response = $ua->request(HTTP::Request->new('GET',$URL));
        unless ($response->is_success and $response->content =~ /server/im)
        {
                print "no (no nginx status on $URL)\n";
                exit 1;
        }
        else
        {
                print "yes\n";
                exit 0;
        }
}
if ( exists $ARGV[0] and $ARGV[0] eq "config" )
{
        print "graph_title Nginx requests\n";
        print "graph_args --base 1000\n";
        print "graph_category nginx\n";
        print "graph_vlabel Request per second\n";
        print "request.label req/sec\n";
        print "request.type DERIVE\n";
        print "request.min 0\n";
        print "request.label requests port $port\n";
        print "request.draw LINE2\n";

        exit 0;
}
my $ua = LWP::UserAgent->new(timeout => 30);
my $response = $ua->request(HTTP::Request->new('GET',$URL));
if ($response->content =~ /^\s+(\d+)\s+(\d+)\s+(\d+)/m) {
        print "request.value $3\n";
} else {
        print "request.value U\n";
}
nginx_status

#!/usr/bin/perl -w
#
# Magic markers:
#%# family=auto
#%# capabilities=autoconf

my $ret = undef;

if (! eval "require LWP::UserAgent;"){
        $ret = "LWP::UserAgent not found";
}

chomp(my $fqdn=`hostname -f`);

my $URL = exists $ENV{'url'} ? $ENV{'url'} : "http://$fqdn/nginx_status";

if ( exists $ARGV[0] and $ARGV[0] eq "autoconf" )
{
        if ($ret){
                print "no ($ret)\n";
                exit 1;
        }

        my $ua = LWP::UserAgent->new(timeout => 30);
        my $response = $ua->request(HTTP::Request->new('GET',$URL));

        unless ($response->is_success and $response->content =~ /server/im)
        {
                print "no (no nginx status on $URL)\n";
                exit 1;
        }
        else
        {
                print "yes\n";
                exit 0;
        }
}

if ( exists $ARGV[0] and $ARGV[0] eq "config" )
{
        print "graph_title NGINX status\n";
        print "graph_args --base 1000\n";
        print "graph_category nginx\n";
        print "graph_vlabel Connections\n";

        print "total.label Active connections\n";
        print "total.info  Active connections\n";
        print "total.draw LINE2\n";

        print "reading.label Reading\n";
        print "reading.info  Reading\n";
        print "reading.draw LINE2\n";

        print "writing.label Writing\n";
        print "writing.info  Writing\n";
        print "writing.draw LINE2\n";

        print "waiting.label Waiting\n";
        print "waiting.info  Waiting\n";
        print "waiting.draw LINE2\n";

        exit 0;
}

my $ua = LWP::UserAgent->new(timeout => 30);

my $response = $ua->request(HTTP::Request->new('GET',$URL));

#Active connections: 1845
#server accepts handled requests
# 4566318 4566318 84218236
# Reading: 2 Writing: 278 Waiting: 1565
if ($response->content =~ /Active connections:\s+(\d+).*Reading:\s+(\d+).*Writing:\s+(\d+).*Waiting:\s+(\d+)/s) {
    print "total.value $1\n";
    print "reading.value $2\n";
    print "writing.value $3\n";
    print "waiting.value $4\n";
} else {
        foreach (qw(total reading writing waiting)){
            print "$_.value U\n";
        }
}
Выставляем им права на выполнение
cd /etc/munin/plugins
chmod 755 ./nginx_request
chmod 755 ./nginx_status
Теперь в конфиге Nginx мы должны создать секцию, которая нам будет отдавать статистику. Открываем конфигурационный файл Nginx на редактирование
sudo vi /etc/nginx/sites-available/default
и в секцию server {} добавляем новую подсекцию, отвечающую за отдачу статистики. В целях безопасности рекомендуется ограничить диапазон разрешенных IP.
location /nginx_status {
    stub_status on;
    access_log   off;
    allow 127.0.0.1;
    allow 10.120.1.1; # ip, с которого будет забираться статистика
    deny all;
}
Перезагружаем Nginx
sudo /etc/init.d/nginx restart
Открываем на редактирование /etc/munin/plugin-conf.d/munin-node
sudo vi /etc/munin/plugin-conf.d/munin-node
и в конец добавляем несколько строк [nginx*] user root env.url http://10.120.1.3/nginx_status где env.url должен указывать на статистику Nginx Перезапускаем munin клиент
sudo /etc/init.d/munin-node restart
Через некоторое время у нас появятся подобные графики munin nginx status munin nginx requests

3 комментария:

  1. у меня почему то секция /nginx_status не отрабатывает :(
    (ограничения по ip естестенно убрал)

    ОтветитьУдалить
  2. @GTAlex
    можно посмотреть что в error.log при попытке запросить nginx_status, возможно там будет что-то полезное

    ОтветитьУдалить
  3. Хорошая короткая статья, автару посоветовал бы в пост добавить:
    munin-run nginx_request
    munin-run nginx_status
    этим можно легко проверить корректность отработки плагинов.

    ОтветитьУдалить