Monitoramento de Servidores Com Icinga No Debian Squeeze - Página 2

3 Configurando o Icinga

server1.example.com:

O arquivo de configuração principal do Icinga é /etc/icinga/icinga.cfg, configurações adicionais são armazenadas em /etc/icinga/commands.cfg e /etc/icinga/resource.cfg. Normalmente, a configuração padrão está ok, então você não precisa alterar esses arquivos.

A primeira coisa que você deve alterar são os detalhes de contato em /etc/icinga/objects/contacts_icinga.cfg para que as notificações sejam enviadas para o endereço de e-mail correto:

vi /etc/icinga/objects/contacts_icinga.cfg

| [...] define contact{ contact_name root alias Falko Timme service_notification_period 24x7 host_notification_period 24x7 service_notification_options w,u,c,r host_notification_options d,r service_notification_commands notify-service-by-email host_notification_commands notify-host-by-email email [email protected] } [...] |

Os checks de serviço para localhost (= server1.example.com) estão definidos em /etc/icinga/objects/localhost_icinga.cfg - dê uma olhada nesse arquivo:

cat /etc/icinga/objects/localhost_icinga.cfg

| # Um arquivo de configuração simples para monitorar o host local # Isso pode servir como um exemplo para configurar outros servidores; # Serviços personalizados específicos para este host são adicionados aqui, mas serviços definidos em icinga-common_services.cfg também podem se aplicar. # define host{ use generic-host ; Nome do template de host a ser usado host_name localhost alias localhost address 127.0.0.1 } # Defina um serviço para verificar o espaço em disco da partição raiz # na máquina local. Aviso se < 20% livre, crítico se # < 10% de espaço livre na partição. define service{ use generic-service ; Nome do template de serviço a ser usado host_name localhost service_description Espaço em Disco check_command check_all_disks!20%!10% } # Defina um serviço para verificar o número de usuários atualmente logados # na máquina local. Aviso se > 20 usuários, crítico # se > 50 usuários. define service{ use generic-service ; Nome do template de serviço a ser usado host_name localhost service_description Usuários Atuais check_command check_users!20!50 } # Defina um serviço para verificar o número de processos atualmente em execução # na máquina local. Aviso se > 250 processos, crítico se # > 400 processos. define service{ use generic-service ; Nome do template de serviço a ser usado host_name localhost service_description Total de Processos check_command check_procs!250!400 } # Defina um serviço para verificar a carga na máquina local. define service{ use generic-service ; Nome do template de serviço a ser usado host_name localhost service_description Carga Atual check_command check_load!5.0!4.0!3.0!10.0!6.0!4.0 } |

Os comandos check_command (como check_all_disks) estão definidos nos arquivos de configuração do plugin Nagios no diretório /etc/nagios-plugins/config:

ls -l /etc/nagios-plugins/config

root@server1:~# ls -l /etc/nagios-plugins/config  
total 144  
-rw-r--r-- 1 root root  277 May 23 04:55 apt.cfg  
-rw-r--r-- 1 root root  182 May 23 04:55 breeze.cfg  
-rw-r--r-- 1 root root  458 May 23 04:55 dhcp.cfg  
-rw-r--r-- 1 root root  909 May 23 04:55 disk.cfg  
-rw-r--r-- 1 root root 1722 May 23 04:55 disk-smb.cfg  
-rw-r--r-- 1 root root  321 May 23 04:55 dns.cfg  
-rw-r--r-- 1 root root  673 May 23 04:55 dummy.cfg  
-rw-r--r-- 1 root root  146 May 23 04:55 flexlm.cfg  
-rw-r--r-- 1 root root  159 May 23 04:55 fping.cfg  
-rw-r--r-- 1 root root  414 May 23 04:55 ftp.cfg  
-rw-r--r-- 1 root root  320 May 23 04:55 games.cfg  
-rw-r--r-- 1 root root  157 May 23 04:55 hppjd.cfg  
-rw-r--r-- 1 root root 3579 May 23 04:55 http.cfg  
-rw-r--r-- 1 root root  818 May 23 04:55 ifstatus.cfg  
-rw-r--r-- 1 root root  748 May 23 04:55 ldap.cfg  
-rw-r--r-- 1 root root  195 May 23 04:55 load.cfg  
-rw-r--r-- 1 root root 2062 May 23 04:55 mail.cfg  
-rw-r--r-- 1 root root  708 May 23 04:55 mailq.cfg  
-rw-r--r-- 1 root root  385 May 23 04:55 mrtg.cfg  
-rw-r--r-- 1 root root  567 May 23 04:55 mysql.cfg  
-rw-r--r-- 1 root root 2355 May 23 04:55 netware.cfg  
-rw-r--r-- 1 root root  420 May 23 04:55 news.cfg  
-rw-r--r-- 1 root root  491 May 23 04:55 nt.cfg  
-rw-r--r-- 1 root root  466 May 23 04:55 ntp.cfg  
-rw-r--r-- 1 root root  426 May 23 04:55 pgsql.cfg  
-rw-r--r-- 1 root root 2026 May 23 04:55 ping.cfg  
-rw-r--r-- 1 root root  511 May 23 04:55 procs.cfg  
-rw-r--r-- 1 root root  240 May 23 04:55 radius.cfg  
-rw-r--r-- 1 root root  397 May 23 04:55 real.cfg  
-rw-r--r-- 1 root root  315 May 23 04:55 rpc-nfs.cfg  
-rw-r--r-- 1 root root 5550 May 23 04:55 snmp.cfg  
-rw-r--r-- 1 root root  753 May 23 04:55 ssh.cfg  
-rw-r--r-- 1 root root  784 May 23 04:55 tcp_udp.cfg  
-rw-r--r-- 1 root root  438 May 23 04:55 telnet.cfg  
-rw-r--r-- 1 root root  155 May 23 04:55 users.cfg  
root@server1:~#

Vamos dar uma olhada no arquivo /etc/nagios-plugins/config/disk.cfg:

cat /etc/nagios-plugins/config/disk.cfg

| # definição do comando 'check_disk' define command{ command_name check_disk command_line /usr/lib/nagios/plugins/check_disk -w '$ARG1$' -c '$ARG2$' -e -p '$ARG3$' } # definição do comando 'check_all_disks' define command{ command_name check_all_disks command_line /usr/lib/nagios/plugins/check_disk -w '$ARG1$' -c '$ARG2$' -e } # definição do comando 'ssh_disk' define command{ command_name ssh_disk command_line /usr/lib/nagios/plugins/check_by_ssh -H '$HOSTADDRESS$' -C "/usr/lib/nagios/plugins/check_disk -w '$ARG1$' -c '$ARG2$' -e -p '$ARG3$'" } #### # use esses checks, se você quiser testar a conectividade IPv4 em sistemas habilitados para IPv6 #### # definição do comando 'ssh_disk_4' define command{ command_name ssh_disk_4 command_line /usr/lib/nagios/plugins/check_by_ssh -H '$HOSTADDRESS$' -C "/usr/lib/nagios/plugins/check_disk -w '$ARG1$' -c '$ARG2$' -e -p '$ARG3$'" -4 } |

Como você pode ver, o comando check_all_disks está definido como /usr/lib/nagios/plugins/check_disk -w ‘$ARG1$’ -c ‘$ARG2$’ -e. Se você olhar novamente o arquivo /etc/icinga/objects/localhost_icinga.cfg, verá que temos a linha check_command check_all_disks!20%!10% nela. O Icinga nos permite passar argumentos de linha de comando para os checks de serviço separando-os com um ponto de exclamação (!), então check_command check_all_disks!20%!10% significa que passamos 20% como o primeiro argumento da linha de comando e 10% como o segundo argumento para o comando /usr/lib/nagios/plugins/check_disk -w ‘$ARG1$’ -c ‘$ARG2$’ -e, de modo que finalmente se traduz em /usr/lib/nagios/plugins/check_disk -w ‘20%’ -c ‘10%’ -e.

Se você quiser passar um argumento de linha de comando que contenha um ponto de exclamação, deve escapar o ponto de exclamação com uma barra invertida: !

Os plugins do Nagios (ou seja, as ferramentas que o Icinga usa para executar checks) estão localizados no diretório /usr/lib/nagios/plugins:

ls -l /usr/lib/nagios/plugins

root@server1:~# ls -l /usr/lib/nagios/plugins  
total 2476  
-rwxr-xr-x 1 root root 106120 May 23 04:55 check_apt  
-rwxr-xr-x 1 root root   5369 May 23 04:55 check_bgpstate  
-rwxr-xr-x 1 root root   2242 May 23 04:55 check_breeze  
-rwxr-xr-x 1 root root  46192 May 23 04:55 check_by_ssh  
lrwxrwxrwx 1 root root      9 Aug 23 12:14 check_clamd -> check_tcp  
-rwxr-xr-x 1 root root  32072 May 23 04:55 check_cluster  
-rwxr-xr-x 1 root root  44816 May 23 04:55 check_dhcp  
-rwxr-xr-x 1 root root  41392 May 23 04:55 check_dig  
-rwxr-xr-x 1 root root 119216 May 23 04:55 check_disk  
-rwxr-xr-x 1 root root   8726 May 23 04:55 check_disk_smb  
-rwxr-xr-x 1 root root  45488 May 23 04:55 check_dns  
-rwxr-xr-x 1 root root  28968 May 23 04:55 check_dummy  
-rwxr-xr-x 1 root root   3053 May 23 04:55 check_file_age  
-rwxr-xr-x 1 root root   6315 May 23 04:55 check_flexlm  
-rwxr-xr-x 1 root root  44656 May 23 04:55 check_fping  
lrwxrwxrwx 1 root root      9 Aug 23 12:14 check_ftp -> check_tcp  
-rwxr-xr-x 1 root root  36584 May 23 04:55 check_game  
lrwxrwxrwx 1 root root     10 Aug 23 12:14 check_host -> check_icmp  
-rwxr-xr-x 1 root root  41136 May 23 04:55 check_hpjd  
-rwxr-xr-x 1 root root 164624 May 23 04:55 check_http  
-rwxr-xr-x 1 root root  49264 May 23 04:55 check_icmp  
-rwxr-xr-x 1 root root  34536 May 23 04:55 check_ide_smart  
-rwxr-xr-x 1 root root  15134 May 23 04:55 check_ifoperstatus  
-rwxr-xr-x 1 root root  12598 May 23 04:55 check_ifstatus  
lrwxrwxrwx 1 root root      9 Aug 23 12:14 check_imap -> check_tcp  
-rwxr-xr-x 1 root root   6887 May 23 04:55 check_ircd  
lrwxrwxrwx 1 root root      9 Aug 23 12:14 check_jabber -> check_tcp  
-rwxr-xr-x 1 root root  40816 May 23 04:55 check_ldap  
lrwxrwxrwx 1 root root     10 Aug 23 12:14 check_ldaps -> check_ldap  
-rwxr-xr-x 1 root root   3407 May 23 04:55 check_linux_raid  
-rwxr-xr-x 1 root root  36168 May 23 04:55 check_load  
-rwxr-xr-x 1 root root   6026 May 23 04:55 check_log  
-rwxr-xr-x 1 root root  20284 May 23 04:55 check_mailq  
-rwxr-xr-x 1 root root  36264 May 23 04:55 check_mrtg  
-rwxr-xr-x 1 root root  34440 May 23 04:55 check_mrtgtraf  
-rwxr-xr-x 1 root root  45936 May 23 04:55 check_mysql  
-rwxr-xr-x 1 root root  44688 May 23 04:55 check_mysql_query  
-rwxr-xr-x 1 root root  36616 May 23 04:55 check_nagios  
lrwxrwxrwx 1 root root      9 Aug 23 12:14 check_nntp -> check_tcp  
lrwxrwxrwx 1 root root      9 Aug 23 12:14 check_nntps -> check_tcp  
-rwxr-xr-x 1 root root  48720 May 23 04:55 check_nt  
-rwxr-xr-x 1 root root  46288 May 23 04:55 check_ntp  
-rwxr-xr-x 1 root root  44880 May 23 04:55 check_ntp_peer  
-rwxr-xr-x 1 root root  42224 May 23 04:55 check_ntp_time  
-rwxr-xr-x 1 root root  60912 May 23 04:55 check_nwstat  
-rwxr-xr-x 1 root root   8326 May 23 04:55 check_oracle  
-rwxr-xr-x 1 root root  40400 May 23 04:55 check_overcr  
-rwxr-xr-x 1 root root  40656 May 23 04:55 check_pgsql  
-rwxr-xr-x 1 root root  48848 May 23 04:55 check_ping  
lrwxrwxrwx 1 root root      9 Aug 23 12:14 check_pop -> check_tcp  
-rwxr-xr-x 1 root root 114640 May 23 04:55 check_procs  
-rwxr-xr-x 1 root root  40624 May 23 04:55 check_radius  
-rwxr-xr-x 1 root root  40464 May 23 04:55 check_real  
-rwxr-xr-x 1 root root   9581 May 23 04:55 check_rpc  
lrwxrwxrwx 1 root root     10 Aug 23 12:14 check_rta_multi -> check_icmp  
-rwxr-xr-x 1 root root   1137 May 23 04:55 check_sensors  
lrwxrwxrwx 1 root root      9 Aug 23 12:14 check_simap -> check_tcp  
-rwxr-xr-x 1 root root 127216 May 23 04:55 check_smtp  
-rwxr-xr-x 1 root root 152008 May 23 04:55 check_snmp  
lrwxrwxrwx 1 root root      9 Aug 23 12:14 check_spop -> check_tcp  
-rwxr-xr-x 1 root root  36688 May 23 04:55 check_ssh  
lrwxrwxrwx 1 root root      9 Aug 23 12:14 check_ssmtp -> check_tcp  
-rwxr-xr-x 1 root root  37832 May 23 04:55 check_swap  
-rwxr-xr-x 1 root root  49328 May 23 04:55 check_tcp  
-rwxr-xr-x 1 root root  38128 May 23 04:55 check_time  
lrwxrwxrwx 1 root root      9 Aug 23 12:14 check_udp -> check_tcp  
-rwxr-xr-x 1 root root  44560 May 23 04:55 check_ups  
-rwxr-xr-x 1 root root  36168 May 23 04:55 check_users  
-rwxr-xr-x 1 root root   2936 May 23 04:55 check_wave  
-rwxr-xr-x 1 root root  38152 May 23 04:55 negate  
-rwxr-xr-x 1 root root  36104 May 23 04:55 urlize  
-rw-r--r-- 1 root root   1938 May 23 04:55 utils.pm  
-rwxr-xr-x 1 root root    862 May 23 04:55 utils.sh  
root@server1:~#

Para descobrir quais argumentos de linha de comando um plugin pode aceitar, chame esse plugin com o switch –help. Por exemplo, para descobrir como o plugin check_disk pode ser usado, execute

/usr/lib/nagios/plugins/check_disk --help

Com esse conhecimento, você pode modificar os checks de serviço em /etc/icinga/objects/localhost_icinga.cfg de acordo com suas preferências, e você pode adicionar/modificar configurações de plugins no diretório /etc/nagios-plugins/config.

Agora vamos supor que queremos adicionar um check de serviço para MySQL, primeiro damos uma olhada na configuração do plugin apropriado:

cat /etc/nagios-plugins/config/mysql.cfg

| # definição do comando 'check_mysql' define command{ command_name check_mysql command_line /usr/lib/nagios/plugins/check_mysql -H '$HOSTADDRESS$' } # definição do comando 'check_mysql_cmdlinecred' define command{ command_name check_mysql_cmdlinecred command_line /usr/lib/nagios/plugins/check_mysql -H '$HOSTADDRESS$' -u '$ARG1$' -p '$ARG2$' } # definição do comando 'check_mysql_database' define command{ command_name check_mysql_database command_line /usr/lib/nagios/plugins/check_mysql -d '$ARG3$' -H '$HOSTADDRESS$' -u '$ARG1$' -p '$ARG2$' } |

O comando que quero usar é check_mysql_cmdlinecred - este aceita um nome de usuário MySQL e uma senha como argumentos (além do endereço do host que é retirado do parâmetro host_name da definição do check de serviço. Quero usar o usuário MySQL nagios com a senha howtoforge aqui, então adiciono a seguinte seção em /etc/icinga/objects/localhost_icinga.cfg:

vi /etc/icinga/objects/localhost_icinga.cfg

| [...] define service{ use generic-service host_name localhost service_description MySQL check_command check_mysql_cmdlinecred!nagios!howtoforge } |

Antes de reiniciarmos o Icinga, devemos criar o usuário MySQL nagios com a senha howtoforge:

mysql -u root -p

GRANT USAGE ON *.* TO nagios@localhost IDENTIFIED BY 'howtoforge';  
GRANT USAGE ON *.* TO [email protected] IDENTIFIED BY 'howtoforge';  
FLUSH PRIVILEGES;

quit;

(O privilégio USAGE é um sinônimo para ‘sem privilégios’, ou seja, o usuário nagios pode se conectar ao MySQL, mas não alterar ou ler nenhum dado.)

Agora reiniciamos o Icinga para que nossas alterações tenham efeito:

/etc/init.d/icinga restart

Se você verificar os serviços do localhost na interface web do Icinga agora, deve ver que um check para MySQL foi adicionado:

Da mesma forma, podemos adicionar checks para SMTP, POP3 e IMAP - estes são apenas checks de conexão, então não precisamos de argumentos:

vi /etc/icinga/objects/localhost_icinga.cfg

| [...] define service{ use generic-service host_name localhost service_description SMTP check_command check_smtp } define service{ use generic-service host_name localhost service_description POP3 check_command check_pop } define service{ use generic-service host_name localhost service_description IMAP check_command check_imap } |

Reinicie o Icinga…

/etc/init.d/icinga restart

… e alguns momentos depois você deve ver os novos checks na interface web do Icinga:

Você pode ter notado os checks SSH e HTTP para localhost que não estão definidos em /etc/icinga/objects/localhost_icinga.cfg. Estes estão definidos nos grupos de hosts no arquivo /etc/icinga/objects/hostgroups_icinga.cfg. Um grupo de hosts nos permite executar um check de serviço para vários servidores e defini-lo apenas uma vez. Dê uma olhada nesse arquivo:

cat /etc/icinga/objects/hostgroups_icinga.cfg

| # Algumas definições de grupos de hosts genéricos # Um grupo de hosts simples com curinga define hostgroup { hostgroup_name all alias Todos os Servidores members * } # Uma lista dos seus servidores Debian GNU/Linux define hostgroup { hostgroup_name debian-servers alias Servidores Debian GNU/Linux members localhost } # Uma lista dos seus servidores web define hostgroup { hostgroup_name http-servers alias Servidores HTTP members localhost } # Uma lista dos seus servidores acessíveis por ssh define hostgroup { hostgroup_name ssh-servers alias Servidores SSH members localhost } |

Como você pode ver, temos um grupo de hosts chamado http-servers e um grupo de hosts chamado ssh-servers, e localhost é um membro de cada um desses grupos. Os checks de serviço para os grupos de hosts estão definidos em /etc/icinga/objects/services_icinga.cfg. Este arquivo contém checks de serviço e se refere aos grupos de hosts aos quais esses checks devem ser aplicados usando o parâmetro hostgroup_name:

cat /etc/icinga/objects/services_icinga.cfg

| # verifique se os serviços web estão em execução define service { hostgroup_name http-servers service_description HTTP check_command check_http use generic-service notification_interval 0 ; defina > 0 se você quiser ser notificado novamente } # verifique se os serviços ssh estão em execução define service { hostgroup_name ssh-servers service_description SSH check_command check_ssh use generic-service notification_interval 0 ; defina > 0 se você quiser ser notificado novamente } |

Como você pode ver, os checks de serviço SSH e HTTP estão definidos aqui.