Guia para preparação do sistema. Guia de obtenção e descompactação

Transcrição

1 Guia para preparação do sistema 1. Adicione o usuário nagios ao sistema. Este usuário será o dono dos processos relativos ao monitoramento useradd nagios 2. Adicine o grupo nagios. Este grupo será útil na execução de comandos externos (via interface web) como veremos mais adiante. groupadd nagios Guia de obtenção e descompactação 1. Crie um diretório temporário para compilação mkdir /var/tmp/nagios 2. Faça o download do programa Nagios, no site no diretório acima criado 3. Entre no diretório no qual você salvou o arquivo e liste seu conteúdo cd /var/tmp/nagios ls -l 4. Descompacte o programa tar jxvf <nome_do_arquivo> ex.: tar zxvf nagios-2.0b2.tar.gz 5. Liste o conteúdo do diretório novamente. Note que uma nova pasta foi criada contendo o programa descompactado. Entre nela e liste seu conteúdo: ex.: cd nagios-2.0b2; ls -l

2 Guia configuração pré-instalação 1. Digite./configure --help para ver as opções disponíveis de compilação. As opções mais importantes são: --prefix: diretório de instalação --libexecdir: diretório de instalação dos plugins --with-htmurl: site de acesso ao Nagios (padrão: --with-cgiurl: endereço web de onde ficarão os CGIs (padrão: 2. Rode o script de configuração:./configure --prefix=/opt/nagios-turma1 --with-htmurl=/nagios-turma1 --with-cgiurl=/nagiosturma1/cgi-bin --libexecdir=plugins *** Configuration summary for nagios 2.0b ***: General Options: Nagios executable: nagios Nagios user/group: nagios,nagios Command user/group: nagios,nagios Embedded Perl: no Event Broker: yes Install ${prefix: /opt/nagios-turma1 Lock file: ${prefix/var/nagios.lock Init directory: /etc/init.d Host OS: linux-gnu Web Interface Options: HTML URL: CGI URL: Traceroute (used by WAP): /usr/bin/traceroute 3. Caso apareça a mensagem de erro abaixo: *** GD, PNG, and/or JPEG libraries could not be located... ********* Boutell's GD library is required to compile the statusmap, trends and histogram CGIs. Get it from compile it, and use the --with-gd-lib and --with-gd-inc arguments to specify the locations of the GD library and include files. NOTE: In addition to the gd-devel library, you'll also need to make sure you have the png-devel and jpeg-devel libraries installed on your system.

3 NOTE: After you install the necessary libraries on your system: 1. Make sure /etc/ld.so.conf has an entry for the directory in which the GD, PNG, and JPEG libraries are installed. 2. Run 'ldconfig' to update the run-time linker options. 3. Run 'make clean' in the Nagios distribution to clean out any old references to your previous compile. 4. Rerun the configure script. NOTE: If you can't get the configure script to recognize the GD libs on your system, get over it and move on to other things. The CGIs that use the GD libs are just a small part of the entire Nagios package. Get everything else working first and then revisit the problem. Make sure to check the nagios-users mailing list archives for possible solutions to GD library problems when you resume your troubleshooting. ******************************************************************** verifique se o código fonte da bibioteca GD está instalado: apt-get install libgd2-xpm-dev e repita o processo de configuração.o comando acima instalará várias bibliotecas de graficas no sistema A maior dificuldade nesta etapa é fazer com que o Nagios encontre a biblioteca GD. Esta biblioteca é responsável pela geração dos gráficos e icones da visualização via interface Web. Guia de compilação e instalação 1. Compile o programa com o comando make all 2. Instale o programa com o comando make install 3. Instale o script de inicialização com o comando make install-init. Este script será colocado no diretório /etc/init.d. Quando o computador for reiniciado, o nagios será automaticamente chamado. Esta pasta funciona como a pasta Inicializar (Start) do Windows. 4. Instale o arquivo de comandos externos com o comando make install-commandmode. É neste arquivo que o seu servidor web vai escrever as ordens enviadas via interface web para serem processadas pelo nagios. 5. Instale os arquivos de exemplo configuração com o comando make install-config. Atenção: para que o Nagios sejá inicializado no boot, será preciso criar os links nos diretórios / etc/rc*.d. update-rc.d nagios defaults 1. Entre no diretório /etc/init.d cd /etc/init.d 2. Digite o comando: update-rc.d nagios defaults

4 Obtendo e descompactando os plugins 1. Crie um diretório temporário para compilação mkdir /var/tmp/plugins 2. Faça o download dos plugins ( no diretório acima criado 3. Entre no diretório no qual você salvou o arquivo e liste seu conteúdo cd /var/tmp/plugins ls -l 4. Descompacte o pacote de plugins tar jxvf <nome_do_arquivo> ex.: tar zxvf nagios-plugins-1.4.tar.gz 5. Liste o conteúdo do diretório novamente. Note que uma nova pasta foi criada contendo o programa descompactado. Entre nela e liste seu conteúdo: ex.: cd nagios-plugins-1.4; ls -l Guia configuração pré-instalação dos plugins 1. Digite./configure --help para ver as opções disponíveis de compilação. As opções mais importantes são: --prefix: selecionar o diretório do nagios --libexecdir: selecionar o diretório de instalação dos plugins --with-cgiurl: endereço web de onde ficarão os CGIs (padrão: 2. Rode o script de configuração:./configure --prefix=/opt/nagios-turma1 --libexecdir=/opt/nagios-turma1/plugins --withcgiurl=/nagios-turma1/cgi

5 Guia de compilação e instalação dos plugins 1. Compile o programa com o comando make 2. Instale o programa com o comando make install Guia para edição do httpd.conf Assumirei que seu servidor web é o Apache 1. Abra o arquivo de configuração do Apache: vim /etc/apache/httpd.conf 2. Adicione ao final do arquivo as seguintes linhas: ##### Configuração do Nagios - Turma 1 ######### ScriptAlias /nagios-turma1/cgi-bin /opt/nagios-turma1/sbin <Directory "/opt/nagios-turma1/sbin"> AllowOverride AuthConfig Options ExecCGI Order allow,deny Allow from all </Directory> Alias /nagios-turma1 /opt/nagios-turma1/share <Directory "/opt/nagios-turma1/share"> Options None AllowOverride AuthConfig Order allow,deny Allow from all </Directory> ############### FIM #################### 3. Recarregue as configurações do servidor Web: /etc/init.d/apache restart

6 Guia para aumentar a segurança no acesso via Web 1. Altere os dois blocos de configuração acima. Após a alteração, o acesso à interface web de controle do Nagios será restrita à rede : ##### Configuração do Nagios - Turma 1 ######### ScriptAlias /nagios-turma1/cgi-bin /opt/nagios-turma1/sbin <Directory "/opt/nagios-turma1/sbin"> AllowOverride AuthConfig Options ExecCGI Order deny,allow Deny from all Allow from </Directory> Alias /nagios-turma1 /opt/nagios-turma1/share <Directory "/opt/nagios-turma1/share"> Options None AllowOverride AuthConfig Order allow,deny Allow from all </Directory> ############### FIM #################### 2. Ative a autenticação de usuários (CGI). Para isso, crie um arquivo chamado.htaccess, com o conteúdo abaixo, no diretório de CGIs (/opt/nagios-turma1/sbin) AuthName "Acesso ao Nagios" AuthType Basic AuthUserFile /opt/nagios-turma1/etc/htpasswd.users require valid-user 3. Crei um arquivo contendo o nome e a senha do usuário que terá acesso à interface Web do Nagios como administrador (usuário/senha: nagiosadmin/passwd): htpasswd -c /opt/nagios-turma1/etc/htpasswd.users nagiosadmin 4. Adicione mais um usuário. Este nós configuraremos, mais tarde, para ter acesso parcial às funcionalidades do sistema: htpasswd /opt/nagios-turma1/etc/htpasswd.users suporte 5. Libere a permissão de leitura dos arquivos de autenticação (.htaccess e.htpasswd) para o usuário do seu servidor Web. cd /opt/nagios-turma1 chown root.www-data etc/htpasswd.users sbin/.htaccess chmod 640 etc/htpasswd.users sbin/.htaccess

7 Guia de configuração do arquivo principal: nagios.cfg 1. Entre no diretório de arquivos de configuração cd /opt/nagios-turma1/etc 2. Renomeie o arquivo de exemplo nagios.cfg-sample para nagios.cfg mv nagios.cfg-sample nagios.cfg 2. Abra o arquivo para edição vim nagios.cfg 3. Comente todas as linhas que se iniciam com cfg_file, deixando apenas as seguintes: cfg_file=/opt/nagios-turma1/etc/contatos.cfg cfg_file=/opt/nagios-turma1/etc/computadores.cfg cfg_file=/opt/nagios-turma1/etc/servicos.cfg cfg_file=/opt/nagios-turma1/etc/timeperiods.cfg cfg_file=/opt/nagios-turma1/etc/checkcommands.cfg cfg_file=/opt/nagios-turma1/etc/misccommands.cfg Dica: :%s/^cfg_file/#cfg_file/g (comando do vim) 4. Altere o valor padrão das seguintes variável: service_reaper_frequency=1 refresh_rate=5 retain_state_information=0 date_format=euro As alterções acima têm como objetivo fazer com que as nossas mudanças sejam visualizadas em poucos segundos. Em um ambiente real, o valor deverá ser ajustado para um tempo maior para evitar sobrecarga no monitoramento. Atenção: Caso queira uma descrição exata do significado de cada variável deste arquivo, acesse o link: Ou siga o curso até o final.

8 Guia de configuração do arquivo de macros: resource.cfg 1. Renomeie o arquivo resource.cfg-sample para resource.cfg mv resource.cfg-sample resource.cfg 2. Abra o arquivo resource.cfg vim resource.cfg 3. Verifique se a macro $USER1$ está apontando para o diretórios do plugins 4. Feche o arquivo Atenção: A macro $USER1$ é a única pre-configurada de fábrica. Você pode criar a sua. Veja mais a frente quando trataremos de Uso de Macros em Comandos

9 Guia de configuração do arquivo de CGIs: cgi.cfg 1. Renomeie o arquivo cgi.cfg-sample para cgi.cfg mv cgi.cfg-sample cgi.cfg 2. Abra o arquivo cgi.cfg vim cgi.cfg 3. Verifique se o acesso à interface Web do Nagios exige autenticação: use_authentication=1 4. Libere o acesso completo ao usuário nagiosadmin (ps: as linhas abaixo deverão ser descomentadas e editadas) authorized_for_system_information=nagiosadmin authorized_for_configuration_information=nagiosadmin authorized_for_configuration_information=nagiosadmin authorized_for_system_commands=nagiosadmin authorized_for_all_services=nagiosadmin authorized_for_all_hosts=nagiosadmin authorized_for_all_service_commands=nagiosadmin authorized_for_all_host_commands=nagiosadmin 5. Vefique se o comando ping, usado pelo Nagios para saber se um computador está ativo ou não, está de acordo com seu sistema. A sintaxe do comando ping muda com freqüencia entre *UNIX. ping_syntax=/bin/ping -n -U -c 5 $HOSTADDRESS$ (Teste digitando: /bin/ping -n -U -c 5 localhost). Em caso de falha, verifique qual o parâmentro que deverá ser removido/substituído. Atenção: Caso queira uma descrição exata do significado de cada variável deste arquivo, acesse o link:

10 Guia de configuração do arquivo de comandos: checkcommands.cfg 1. Renomeie o arquivo cgi.cfg-sample para cgi.cfg mv checkcommands.cfg-sample checkcommands.cfg 2. Abra o arquivo checkcommands.cfg vim checkcommands.cfg 3. Veja como cada comando está definido. Note o uso da macro $USER1$, mencionada anteriormente no arquivo resource.cfg. Esta variável guarda o caminho onde o Nagios encontrará os executáveis responsáveis pelo realização das checagens. Atenção: Teste o comando abaixo (sem quebra de linhas) /opt/nagios-turma1/plugins/check_ping -H localhost -w 80,0.4% -c 90,0.6% -p 1 Se ele retornar "CRITICAL - Could not interpret output from ping comman", então substituia todas as ocorrências de "$USER1$/check_ping" neste arquivo de configuração por "$USER1$/check_icmp". Isto ocorre devido à diferença entre pings de diversas distribuições. Dica: :%s#\$user\$/check_ping#$user$check_icmp#gc (comando do vim) Guia de configuração do arquivo de comandos auxiliares: misccommands.cfg 1. Renomeie o arquivo misccommands.cfg-sample para misccommands.cfg mv misccommands.cfg-sample misccommands.cfg 2. Abra o arquivo misccommands.cfg vim misccommands.cfg 3. Veja como cada comando está definido. Note que aqui está definido como o Nagios notificará os contatos em caso de detecção de problemas. Basicamente usa-se o programa mail, presente em qualquer distribuição linux.

11 Guia de configuração de objetos: timeperiods.cfg 1. Crie um arquivo para definição de intervalos de tempo vim timeperiods.cfg 2. Adicione um intervalo de tempo que representa 24 horas por dia/7 dias por semana e outro intervalo que represente apenas horário comercial: # Definição de horário '24x7' define timeperiod{ timeperiod_name 24x7 alias 24h por dia e 7 dias por semana sunday 00:00-24:00 monday 00:00-24:00 tuesday 00:00-24:00 wednesday 00:00-24:00 thursday 00:00-24:00 friday 00:00-24:00 saturday 00:00-24:00 # Definição de horário de trabalho define timeperiod{ timeperiod_name horadetrabalho alias Hora normal de trabalho monday 08:00-12:00,13:00-17:00 tuesday 08:00-12:00,13:00-17:00 wednesday 08:00-12:00,13:00-17:00 thursday 08:00-12:00,13:00-17:00 friday 08:00-12:00,13:00-17:00 3. Salve o arquivo

12 Guia de configuração de objetos: contatos.cfg 1. Crie um arquivo para definição de contatos e grupos de contatos vim contatos.cfg 2. Crie dois contato para serem notificado # Definição do contato Nagios Admin define contact{ contact_name nagios alias Nagios Admin service_notification_period 24x7 host_notification_period 24x7 service_notification_options w,u,c,r host_notification_options d,u,r service_notification_commands notify-by- host_notification_commands host-notify-by- nagios-admin@localhost.localdomain # Definição do contato suporte define contact{ contact_name suporte alias Suporte da Rede service_notification_period horadetrabalho host_notification_period horadetrabalho service_notification_options w,u,c,r host_notification_options d,u,r service_notification_commands notify-by- host_notification_commands host-notify-by- root@localhost.localdomain 3. Adicione os contatos acima definidos ao grupo de administradores # Definição do grupo de administradores define contactgroup{ contactgroup_name administradores alias Administradores members nagios,suporte 4. Salve o arquivo

13 Guia de configuração de objetos: computadores.cfg 1. Crie um arquivo para descrição dos computadores e grupo de computadores vim computadores.cfg 2. Defina três computadores a serem monitorados: o seu (Servidor Nagios) e o dos alunos ao lado. #Template (Para evitar repetições de variáveis) define host{ name template-generico check_command check-host-alive max_check_attempts 3 notification_interval 120 notification_period 24x7 notification_options d,u,r contact_groups administradores register 0 # Definição do Servidor Nagios define host{ use template-generico host_name servidor-nagios alias Servidor Nagios address # Definição do Computador Um define host{ use template-generico host_name computador-1 alias Computador #1 address # Definição do Computador Dois define host{ use template-generico host_name computador-2 alias Computador #2 address check_command check-host-alive 3. Adicione os computadores acima definidos ao grupo de servidoras # Grupo de computadores servidores

14 define hostgroup{ hostgroup_name servidoras alias Servidoras da Rede members servidor-nagios,computador-1,computador-2 4. Salve o arquivo Atenção: o uso de templates facilita muito a adição de vários computadores ao monitoramento!

15 Guia de configuração de serviços: servicos.cfg 1. Crie um arquivo para definição dos serviços que serão monitorados vim servicos.cfg 2. Defina um serviço para cada computador que você está monitorando. Inicialmente criaremos um serviço de PING. Este serviço pingará as máquinas em intervalos de tempo regular para verificar se a mesma encontra-se na rede # Template de definição do serviço PING define service{ name template active_checks_enabled 1 passive_checks_enabled 0 parallelize_check 1 obsess_over_service 1 check_freshness 0 notifications_enabled 1 event_handler_enabled 1 flap_detection_enabled 1 process_perf_data 1 retain_status_information 1 retain_nonstatus_information 1 is_volatile 0 notification_interval 120 notification_period 24x7 notification_options w,u,c,r max_check_attempts 3 normal_check_interval 1 retry_check_interval 1 check_period 24x7 contact_groups administradores register 0 # Definição do serviço do Servidor Nagios define service{ use template host_name service_description check_command servidor-nagios PING check_ping!100.0,20%!500.0,60%

16 # Definição do serviço do computador-1 define service{ use template host_name service_description check_command computador-1 PING check_ping!100.0,20%!500.0,60% # Definição do serviço do computador-2 define service{ use template host_name service_description check_command computador-2 PING check_ping!100.0,20%!500.0,60% 3. Adicione os serviços acima definidos ao um grupo de serviços #Definição de um grupo de serviço define servicegroup{ servicegroup_name Pings alias Ping nos computadores members servidor-nagios,ping,computador-1,ping,computador- 2,PING

17 Guia de Agendamento de Checagens 1. Entre no diretório de instalação do Nagios cd /opt/nagios-turma1 2. Execute o Nagios com o parâmetro -s e passando como argumento o arquivo de configuração principal (nagios.cfg) bin/nagios -s etc/nagios.cfg 3. Verifique se o Nagios faz alguma sugestão de alteração das variáveis de agendamento de checagens Recortado PERFORMANCE SUGGESTIONS Value for 'max_concurrent_checks' option should >= Fim

18 Guia de Tratadores de Eventos Neste guia veremos na prática a funcionamento de um tratador de eventos. Este simples exemplo servirá para mostrar a variedades de situações às quais esta funcionalidade pode ser aplicada. Primeiramente, verifique se o tratamento de eventos está ativado no nagios.cfg 1. vim nagios.cfg nagios.cfg:enable_event_handlers=1 Parte 1: Crie um serviço de verificação do servidor Apache 1. Entre no diretório de configuração do Nagios cd /opt/nagios-turma1/etc 2. Edite o arquivo de serviços vim servicos.cfg 3. Adicione ao final do arquivo a seguinte definição de serviço: #Monitrando o Apache define service{ use template host_name servidor-nagios service_description Apache max_check_attempts 4 event_handler reinicie-apache check_command check_http Note que o comando check_http já existe pronto para usarmos. Ele veio juntamente com o pacote de plugins que instalamos. Salve o arquivo servicos.cfg e saia. Parte 2: Crie uma definição de comando para seu tratador de eventos 1. Abra o arquivo de definição de comandos: vim checkcommands.cfg 2. Crie, ao final do arquivo, uma definição de comando para o nosso novo tratador de eventos #Reiniciando Apache define command{ command_name reinicie-apache command_line $USER1$/reinicie-apache $SERVICESTATE$ $SERVICESTATETYPE$ $SERVICEATTEMPT$ Veja que o nosso script receberá três argumentos: O estado atual do serviço (OK, WARNING, UNKNOWN, CRITICAL) O tipo em que o serviço está (SOFT, HARD)

19 O número de tentativas de checagens já feitas (1,2,3...) Parte 3 Crie o programa tratador de eventos 4. Crie um script que será o nosso tratador de evento. A linguagem usada não importa. Usaremos aqui um bash script. O programa deverá fazer o seguinte: -Se o problema acabou de ser detectado, não tente fazer nada -Se o problema persistir aós 3 checagens, então reinicie o servidor Apache Veja na definição do serviço acima que o serviço Apache será verificado 4 vezes (max_check_attempts). Após estas 4 checagens o problema deixará de ser SOFT e passará a ser HARD, ou seja, o problema realmente existe. Queremos que nosso script atue antes da quarta checagem. 5. Programa em bash 1. #!/bin/sh 2. case "$1" in 3. CRITICAL) 4. case "$2" in 5. SOFT) 6. case "$3" in 7. 3) 8. echo -n "Reiniciando Apache (terceira tentativa do nagios)..." 9. /etc/rc.d/init.d/apache restart 10. ;; 11. esac 12. ;; 13. esac 14. ;; 15.esac 16.exit 0 Os parâmetros para um script bash são chamados, dentro do programa, através das variáveis $1, $2, $3. Lembre-se que na definição de comandos, na parte 2 deste guia, passamos 3 argumentos para nosso script: O estado atual do serviço (OK, WARNING, UNKNOWN, CRITICAL) O tipo em que o serviço está (SOFT, HARD) O número de tentativas de checagens já feitas (1,2,3...) Na linha 3, caso o estado CRITICAL seja detectado então tomaremos alguma atitude baseando-se no segundo argumento. Se o tipo do serviço do segundo argumento ($2) for SOFT, então restanos saber qual o número de tentativas de checagens que foram feitas até o momento. Isso é obtido no terceiro argumento ($3). Se este número de checagens for 3 então é hora de nosso script entrar em ação! O comando para reinicar o Apache é visto na linha Salve o arquivo e saia do editor 7. Transforme o arquivo em executável chmod og+x reinicie-apache 8. Dê as permissões de execução do tratador de eventos ao nagios 9. Mova o tratador de eventos para o diretório de plugins mv reinicie-apache /opt/nagios-turma1/plugins Nota: Veja que na definição de comandos definimos que o nosso tratador de

20 eventos ficaria no diretório de plugins ($USER1$, macro definida no arquivo resources.cfg) Parte 5 Ativando depuração de tratadores de eventos Vamos agora ativar as variáveis de depuração de tratadores de eventos. Assim poderemos acompanhar todo o processo de atuação do nosso tratador de eventos: 1. Edite o arquivo nagios.cfg dentro do diretório de configuração do Nagios (/opt/nagios-turma1/etc): vim etc/nagios.cfg log_host_retries = 1 log_service_retries = 1 log_event_handlers = 1 2. Certifique-se que as variáveis abaixo estejam ajustadas para os seguintes valores: 3. Salve e saia do arquivo de configuração 4. Teste as configuração do Nagios /opt/nagios-turma1/bin/nagios -v /opt/nagios-turma1/etc/nagios.cfg 5. Se tudo estiver correto. recarregue as configurações do Nagios e verifique se o serviço de checagem do Apache está sendo executado normalmente através da interface web: /etc/init.d/nagios reload Parte 6 Permitindo ao usuário nagios reiniciar o servidor apache Sabemos que apenas o administrador do sistema (root) tem permissões para executar tarefas avançadas como reiniciar um servidor de páginas (apache). Uma forma de delegar permissões a outros usuários é usando o comando sudo. As características avançadas de uso deste programa não está no escopo deste curso, porém indicaremos aqui apenas como instalar e adicionar a linha de configuração que será necessária ao prosseguimento deste guia. Para mais informações sobre sudo, consulte o manual do sistema (man sudo, man sudoesr). 1. Instale o sudo no seu sistema apt-get install sudo 2. Abra o arquivo de configuração do sudo (/etc/sudoers) usando o comando abaixo. (Atenção: não tente editar o sudores diretamente. O comando abaixo verifica por erros de sintaxe antes de ser salvo) visudo 3. Adicione a seguinte linha ao final do arquivo nagios ALL=NOPASSWD:/etc/init.d/apache restart 4. Salve e saia.

21 Parte 7 Teste seu tratador de eventos Curso Nagios Vamos agora parar nosso servidor Apache e acompahar o que o Nagio ira fazer para resolver este problema usando nosso tratador de eventos: 1. Abra dois terminais. Em um deles digite o comando abaixo para acompanhar todos os registros do log assim que forem sendo gerados: tail -f /opt/nagios/var/nagios.log 2. Em outro terminal pare o serviço Apache: /etc/init.d/apache stop 3. Acompanhe, no primeiro terminal, tudo que aparecer no log. 4. Acompanhe no segundo terminal se o Apache voltou a funcionar com o comando ps auxwf grep apache [ ] SERVICE ALERT: servidor-nagios;apache;critical;soft;1;connection refused [ ] SERVICE EVENT HANDLER: servidornagios;apache;critical;soft;1;reinicie-apache [ ] SERVICE ALERT: servidor-nagios;apache;critical;soft;2;connection refused [ ] SERVICE EVENT HANDLER: servidornagios;apache;critical;soft;2;reinicie-apache [ ] SERVICE ALERT: servidor-nagios;apache;critical;soft;3;connection refused [ ] SERVICE EVENT HANDLER: servidornagios;apache;critical;soft;3;reinicie-apache [ ] SERVICE ALERT: servidor-nagios;apache;ok;soft;4;http OK HTTP/ OK bytes in seconds

22 Guia de Habilitação de Comandos Externos 1. Entre no diretório de configuração do Nagios cd /opt/nagios-turma1/etc 2. Abra o arquivo de configuração principal vim nagios.cfg 3. Certifique-se que as diretivas abaixo estejam ajustada com o valor mostrado check_external_commands=1 command_check_interval=-1 command_file=/opt/nagios-turma1/var/rw/nagios.cmd 4. Salve e feche o arquivo. :wq 5. Reinicie o nagios para que o arquivo de comando externo apareça. /etc/init.d/nagios restart Nota: no passo 4 do guia de compilação e instalação já havíamos preparado o nagios para criar o diretório de comando externo ajustando nele as devidas permissões (make install-commandmode) 6. Visualize o arquivo de comando externo ls -l /opt/nagios-turma1/var/rw/nagios.cmd Nota: Observe que este arquivo na verdade é um pipe. Este tipo de arquivo é utilizado para estabelecer uma conexão entre dois programas. No nosso caso, o nagios.cmd é uma porta de entrada para o processo do nagios.

23 Guia de Criação do Arquivo de Permissões de Aceso ao Arquivo de Comando Externo Como vimos na listagem acima o arquivo nagios.cmd está com permissão de escrita para o usuário nagios e todos os usuários do grupo nagios. Vamos fazer algumas mudanças para que comandos enviados pela interface web possam ser escritos no nagios.cmd Parte 1 Adicionando o servidor web ao grupo do nagios 1. Adicione ao grupo nagios, criado no primeiro guia deste curso (Guia de Preparação do Sistema), os usuários nagios e o grupo usado pelo seu servidor web. Caso o servidor web seja o apache, digite: grep "^User" /etc/apache/httpd.conf para saber qual o usuário usado pelo servidor durante sua execução. No caso do Debian, o usuário do apache se chama www-data. # usermod -G nagios www-data (comando para adicionr o www-data ao grupo nagios) 2. Veja agora que o o usuário do servidor web pertence ao grupo do nagios #groups www-data Nota: o usuário nagios tabém deverá fazer parte do grupo nagios. Este passo não é necessário pois, por padrão, ao criarmos um usuário nagios, um grupo de mesmo nome foi criado (nagios) contendo o usuário nagios dentro dele. 3. Reinicie o servidor web (Apache) Guia de Comandos Externos Via Tratador de Eventos Mostraremos neste guia como associar a funcionalidade de tratamento de eventos com a possibilidade de envio de comandos externos ao Nagios. O objetivo do guia será fazer com que o Nagios adicione um comentário ao serviço de verificação do Apache dizendo que aconteceu um erro no serviço e que o tratador de eventos solucionou. 1. Adicione a seguinte linha no nosso arquivo de tratamento de evento reinicie-apache (linha 10) echo "[`date +%s`] ADD_SVC_COMMENT;servidor-nagios;Apache;1;nagiosadmin;Serviço Apache deu problemas mas o tratador de eventos resolveu." > /opt/nagiosturma1/var/rw/nagios.cmd 2. Pare o servidor e aguarde até que ele seja reiniciado pelo nosso tratador de eventos.

24 /etc/init.d/apache stop Acompanhe no /opt/nagios-turma1/var/nagios.log para ver o que está acontecendo. 3. Assim que o Apache for reiniciado vá até a interface web e clieque em comments (comantários) para ver se o comentário foi adicionado. 4. Os comandos externos mais comuns aceitos pelo Nagios atualmente são listados na tabela abaixo. Uma descrição mais detalhada sobre a sintaxe e a função de cada um dos comandos pode ser lida na documentação oficial do Nagios: Sintaxe: [Date] Command_ID;Argumentos ID do Command ADD_HOST_COMME NT ADD_SVC_COMMEN T DEL_HOST_COMME NT DEL_ALL_HOST_CO MMENTS DEL_SVC_COMMEN T DEL_ALL_SVC_COM MENTS DELAY_HOST_NOTI FICATION DELAY_SVC_NOTIFI CATION SCHEDULE_SVC_CH ECK SCHEDULE_HOST_S VC_CHECKS ENABLE_SVC_CHEC K DISABLE_SVC_CHEC K ENABLE_SVC_NOTIF ICATIONS DISABLE_SVC_NOTI FICATIONS Descrição do Comando Adicionar comentários ao computador Adicionar comentários ao serviço Apagar um comentário de um do computador Apagar todos os comentário do computador Apagar todos um comentário de um serviço Apagar todos os comentários de serviços Atrasar notificações de problemas com um computador Atrasar notificações de problemas com um computador Re-agendar checagem de serviços Re-agendar checagem de computadores Habilitar checagem de serviço Desabilitar checagem de serviço Habilitar notificação de problemas com serviços Desabilitar notificação de problemas com serviços

25 ENABLE_HOST_SVC _NOTIFICATIONS DISABLE_HOST_SVC _NOTIFICATIONS ENABLE_HOST_SVC _CHECKS DISABLE_HOST_SVC _CHECKS ENABLE_HOST_NOT IFICATIONS DISABLE_HOST_NO TIFICATIONS ENABLE_ALL_NOTIF ICATIONS_BEYOND_ HOST DISABLE_ALL_NOTI FICATIONS_BEYON D_HOST ENABLE_NOTIFICAT IONS DISABLE_NOTIFICA TIONS SHUTDOWN_PROGR AM Curso Nagios Habilitar notificação de problemas com clientes Desabilitar notificação de problemas com serviços Desabilitar checagem de clientes Isto desabilitará temporariamente todos os serviços no cliente especificado. Isto irá temporariamente desabilitar notificações para este cliente. Isto desabilitará temporariamente notificações para este cliente. Isto habilitará notificações para todos os clientes e serviços que não seja o cliente especificado no argumento host_name (do ponto de vista do Nagios).. Isto desabilitará temporariamente notificações para todos os clientes e serviços que não sejam o cliente especificado no argumento host_name (do ponto de Nagios). Isto habilitará notificações de cliente e serviço em caráter geral no programa Isto desabilitará notificações de cliente e serviço em caráter geral no programa Isto fará com que Nagios pare de funcionar no momento especificado Dica: Para você ver qual a sintaxe de um comando externo, execute o comando pela interface web e veja como ele aparece no arquivo nagios.log. Copie e adapte-o às suas necessidades.

26 Guia Configurando NRPE Parte 1 Obtendo e compilando o NRPE Instalaremos o NRPE no computador definido como computador-1 no arquivo computadores.cfg 1. Logue no computador remoto (onde você instalará o NRPE) ssh Baixe o Nagios Remote Plugin Executor (NRPE) 2.0) do site: e salve no diretório /var/tmp 2. Descompacte o NRPE tar zxf nrpe-2.0.tar.gz 3. Entre no diretório e compile o programa cd nrpe-2.0./configure make 4. Repita o mesmo procedimento no computador servidor do Nagios Nota: Precisamos compilar o programa em ambos os computadores pois o binário nrpe gerado ficará no computador remoto e o binário check_nrpe ficará no servidor Nagios. Atenção: Caso a instalação gere erros certifique-se que as bibliotecas de desenvolvimento SSL e programa OpenSSL estejam instalados. No debian este pacote se chamam libssl-dev e openssl. apt-get install libssl-dev openssl Parte 2 Instalando o NRPE 1. No servidor Nagios copie o plugin abaixo para o diretório de plugins do Nagios cp /var/tmp/nrpe-2.0/src/check_nrpe /opt/nagios-turma1/plugins 2. Logue no computador remoto ssh No computador remoto crie um diretório para armazenar o nrpe e os plugins mkdir /opt/nagios 4. Mova o daemon nrpe para o diretório criado mv /var/tmp/nrpe /opt/nagios 5. Entre no diretório criado cd /opt/nagios

27 6. Crie um arquivo de configuração para o NRPE vim nrpe.cfg Curso Nagios 7. Adicione a seguinte linha command[check_disk]=/opt/nagios/check_disk -w 20 -c 10 -p / 8. Salve e feche o arquivo (permissoes? Como já deve ter notado, precisamos ter o plugin de checagem disponível no computador remoto. A forma mais rápida de ser fazer isso é simplesmente envinado o plugins necessário a partir do servidor nagios. Porém, pelo mesmo motivo de termos compilado o NRPE na computador remoto, o plugin só funcionará em outro lugar se as configuração e arquitetura do computador forem as mesmas. Caso contrário será preciso obter o pacote de plugins e recompilá-lo no computador remoto. Por exemplo, se o Nagios estiver sendo executado em um computador PC rodando linux, e meu NRPE estiver sendo instalado em um máquina Ultra Sparc, então o NRPE e o plugin deverá ser compilado na maquina remota pois nenhum programa compilado em PC rodaria diretamente em uma Ultra. Parte 4 Configurando o sistema do computador remoto Instalaremos nosso daemon usando o Inetd. Poderíamos também fazer isso através do xinetd. 1. Edite o arquivo /etc/inetd.conf e adicione a seguinte linha: nrpe stream tcp nowait nagios /usr/sbin/tcpd /opt/nagios/nrpe -c /opt/nagios/nrpe.cfg inetd 3. Edite o arquivo /etc/services. Vim /etc/services 4. Adicione a seguinte linha ao final do arquivo nrpe 5666/tcp 5. Salve e feche o arquivo 2. Recarregue o inetd. Para isso precisamos saber o qual o PID do processo #ps auxw grep inetd root ? Ss 07:09 0:00 /usr/sbin/inetd A partir do comando acima descobre-se que o PID do programa é Basta enviar um HUP para o processo: kill -HUP 2513 Parte 5 Testando o NRPE 1. Digite, nesse mesmo computador em que instalamos o NRPE, o comando: telnet localhost 5666 Ser aparecer a seguinte mensagem, o daemon está ativo na porta 5666 aguardando requisições do servidor Nagios! # telnet localhost 5666

28 Trying Connected to Escape character is '^]'. Se aparecer a mensagem abaixo, telnet: Unable to connect to remote host: Connection refused Verifique: Erros no nrpe.cfg Erros no inetd.conf (reiniciou o daemon?) Erros no service.cfg Mensagem de erros no /var/log/messages Guia Finalizando configuração do NRPE 1. Teste a conexão com o NRPE /opt/nagios-turma1/check_nrpe -H c check_disk 2. Se o comando acima não retornar erros então vamos criar um comando fixo para a verificação de serviços nrpe. Faremos a alteração no arquivo checkcommands.cfg vim /opt/nagios-turma1/checkcommands.cfg 3. Adicione a seguinte definição de comando ao arquivo #Comandos NRPE define command{ command_name check_nrpe command_line $USER1$/check_nrpe -H $HOSTADDRESS$ -c $ARG1$ 4. Salve e feche o arquivo 5. Vamos agora criar um serviço de checagem que usa o comando acima definido vim /opt/nagios-turma1/servicos.cfg 6. Adicione a seguinte definição de comando ao arquivo de serviços: #Monitrando disco remoto define service{ use template host_name computador-1 service_description disco check_command check_nrpe!check_disk 7. Salve e feche o arquivo 8. Recarregue as configurações do Nagios /etc/init.d/nagios reload 9. Acompanhe a checagem na interface Web.

29 Usar o exemplo de backup da documentacao Curso Nagios Guia de Freshness

30 Guia de Monitoramento Distribuído TODO: comentar que a desabilitacao de checagens de servico global eh apenas usada assumindo q o servidor central não checa nada. Se ele checar teremos que deixar a opcao ativada e desabilita-la individualmente em cada servico.