Apostila Instalação do Servidor Zabbix

Capítulo 3

Instalação do Servidor Zabbix

OBJETIVOS

• Instalar o servidor Zabbix

• Instalar o banco de dados.

• Configurações iniciais do servidor.

• Instalar o agente Zabbix.

• Configurar o agente para enviar informações ao servidor.

• Preparar o servidor Apache

• Configurar o FrontEnd

3.1 Obtendo os fontes do Zabbix

Antes de começar a trabalhar com as diversas partes básicas da instalação, preci-samos baixar o código fonte do Zabbix. Você sempre pode fazê-lo através da URLhttp://www.zabbix.com/download.php, mas o comando abaixo já vai colocar o pacotede fontes no local apropriado dentro da máquina virtual Zabbix Servidor 2.0.

1 # cd /usr/src

2 # wget -c http :// downloads.sourceforge.net/project/zabbix/ZABBIX %20

Latest %20 Stable /2.0.5/ zabbix -2.0.5. tar.gz

3 # tar xf zabbix -2.0.5. tar.gz

3.1.1 Preparando o banco de dados

O Zabbix não utiliza recursos como o RRDTools para armazenar dados, ele faz usoapenas de um SGBD ou de um banco de dados mais simplório (como o sqlite) para

9

4Linux - www.4linux.com.br

armazenar configurações, hosts, templates, histórico, etc.

Por isso precisamos selecionar um dos bancos nativos ou usar ODBC (este últimonão é recomendado). No caso deste curso elegemos o PostgreSQL, um SGBD livree de alta performance capaz de manipular uma grande quantidade de dados. Apesarda maioria das instalações de Zabbix estar em MySQL recomendamos fortementeque seja usado o PostgreSQL pois sua robustez se mostrou mais adequada aos tiposde dados que o Zabbix manipula.

Embora não pareça a princípio, o banco de dados do Zabbix é de extrema valia paraa empresa, pois ele contém todo o histórico de funcionamento de sua infraestruturae através dele podemos coletar SLAs e informações de “capacity plan”.

É recomendado também que seu banco de dados possua um plano de backupsregular via PITR – Point in Time Recovery.

3.2 Instalação

Para instalar a versão do repositório do PostgreSQL:

No repositório oficial do Debian o PostgreSQL encontra-se na versão 8.4,como no curso usaremos a versão 9.1, temos que adicionar o repositório

backports.

1 # vim /etc/apt/sources.list

2 deb http ://www.backports.com/debian squeeze -backports main

3 # aptitude update

4 # aptitude install postgresql -9.1

# yum install postgresql9.1-server

3.2.1 Criando o usuário e o banco

Com o banco de dados instalado devemos criar uma base de dados e um usuáriocom as devidas permissões de acesso ao mesmo. O nome de ambos elementos sãototalmente opcionais, mas neste material vamos convencionar que o banco de dadosse chamará zabbixdb e o usuário será zabbix.

Monitoramento de Redes com o Zabbix 2.0.X 10


Muitas documentações e até o próprio arquivo padrão de configuração dozabbix server utiliza o nome do banco como zabbix, mas isso pode causar

algumas confusões entre ele e o nome do usuário, foi por isso que optamos pelaconvenção acima.

Somente o superusuário do PostgreSQL, chamado postgres tem permissão de reali-zar a criação dos objetos citados acima, logo, para podermos acessar o terminal deconsole do banco (psql) temos que entrar como usuário postgres no Gnu/Linux e en-tão usar o comando correto. Note que o prompt de comando irá se alterar indicandoque estamos no console do PostgreSQL.

1 # su - postgres

2 $ psql

3 psql (9.1.7)

4 Digite "help" para ajuda.

5

6 postgres=#

Agora que conseguimos o acesso como superusuário, vamos primeiro criar o bancode dados. O comando “create database” irá cuidar desta tarefa. Note que todos oscomandos digitados dentro deste console terminam com ponto-e-vírgula (;).

1 postgres=# CREATE DATABASE zabbixdb;

Com o banco de dados criado com sucesso vamos criar o usuário e definir suasenha. Para propósito de organização deste material a senha do banco de dados dozabbix será zabbix. Ao digitar a senha note que ela não aparece como no quadro decomando abaixo� Este é apenas um demonstrativo didático.

1 postgres=# CREATE ROLE zabbix LOGIN;

2

3 postgres=# \password zabbix

4

5 Digite nova senha: zabbixdbpw

6

7 Digite -a novamente: zabbixdbpw

11 Monitoramento de Redes com o Zabbix 2.0.X


É interessante definir a senha por password pois assim ela não fica armaze-nada no histórico de comandos do usuário.

Agora precisamos liberar a conexão do servidor ao banco de dados do zabbix, paraisso edite o arquivo “pg_hba.conf” conforme abaixo e acrescente a linha em desta-que.

1 postgres=# \q

2 $ logout

3 # vim /etc/postgresql /9.1/ main/pg_hba.conf

4

5 host zabbixdb zabbix 127.0.0.1/32 md5

6 host zabbixdb zabbix ::1/128 md5

Outro ponto importante que merece atenção é o IP no qual o PostgreSQL está fa-zendo binding ports.

Reinicie o banco de dados e realize o teste de conexão.

1 # service postgresql restart

1 # psql -h localhost -U zabbix -d zabbixdb

2 psql (9.1.7)

3 Digite "help" para ajuda.

4

5 zabbixdb=> \q

Se você estiver usando a versão 9.0 ou superior do PostgreSQL e um Zabbixabaixo da versão 1.8.6 é importante lembrar que o suporte a imagens do

Zabbix assume que o banco utiliza a forma antiga de armazenamento bytea (escapeem vez de hex). Para configurar o comportamento antigo use o comando “ALTERDATABASE zabbixdb SET bytea_output=escape;” dentro do console do psql. Issopode ser configurado no usuário ou no “postgresql.conf” também.

3.3 Carga inicial

Para isso, temos que desempacotar o fonte do Zabbix 2.0.5



1 # cd /usr/src

2 # tar xvf zabbix -2.0.5. tar.gz

Agora vamos fazer a carga inicial do banco carregando os esquemas, os dados maisbásicos.

1 # su - postgres

2 $ cd /usr/src/zabbix -2.0.5/ database/postgresql

3 $ cat schema.sql | psql zabbix

4 $ cat images.sql | psql zabbix

5 $ cat data.sql | psql zabbix

3.4 Concedendo as permissões necessárias ao

usuário

Agora é o momento de conceder as permissões de acesso nas tabelas. O usuárioZabbix precisa de permissões de SELECT, INSERT, UPDATE e DELETE apenas.Com a sequência de comandos abaixo você conseguirá ativar todas as permissõesnecessárias.

1 $ psql zabbix

2 zabbixdb=> GRANT SELECT ,UPDATE ,DELETE ,INSERT ON ALL TABLES IN SCHEMA

public TO zabbix;

3 zabbixdb=>\q

4 $logout

Opcionalmente, se você estiver usando um postgresql anterior a versão 9.0 o proce-dimento é um pouco mais complexo.

1 $ psql zabbixdb

2 postgres=# \t

3 postgres=# \a

4 postgres=# \o /tmp/grantzabbix.sql

5 postgres=# SELECT ’GRANT SELECT ,UPDATE ,DELETE ,INSERT ON ’ ||

schemaname || ’.’ ||

6 relname || ’ TO zabbix ;’ FROM pg\_stat\_user\_tables;

7 postgres=# \o

8 postgres=# \i /tmp/grantzabbix.sql



9 postgres=# \q

10 $ logout

1) O comando \a remove o alinhamento dos elementos na tabela;

2) O \t mostra apenas tuplas, eliminando cabeçalhos e rodapés;

3) O comando \o grava o “output” no arquivo definido (/tmp/grantzabbix.sql). Noteque é preciso de outro \o sem o nome do arquivo para encerrar o “output”;

4) Este comando em SQL seleciona todas as tabelas do banco de dados e montauma “string” com o comando de permissão (GRANT), você pode ver o conteúdodeste comando no arquivo “/tmp/grantzabbix.sql”;

5) O comando \i carrega e executa o conteúdo do arquivo gerado acima.

3.5 Instalação do servidor Zabbix via código fonte

Em alguns casos a distribuição Gnu/Linux que você escolher pode possuir em seurepositório uma versão satisfatória do Zabbix disponível. Se for este o caso, ótimo�Simplesmente instale o pacote e comece a configurar.

No entanto isso nem sempre é verdade e pode ser necessário uma versão maisrecente (devido a recursos novos, etc.) na sua solução de monitoramento. Parasuprir esta necessidade é preciso compilar o Zabbix a partir de seu código fonte.

Esta sessão toda é dedicada ao processo de criar os binários, cobrindo quais depen-dências devem ser instaladas e como escolher os recursos a serem compilados. Viade regra se algum tipo de recurso não se mostrar necessário a princípio não o ative,isso gera binários mais leves (com menos código embutido) e alivia o consumo dememória em servidores com altas cargas de métricas sendo monitoradas.

Para começar, vamos instalar os dois pacotes mais básicos para compilação de fon-tes no Debian, o build-essential, make e o java. O primeiro é um meta pacote queirá instalar todos os pacotes mínimos de compilação de fontes (compilador, linkeditor,cabeçalhos do kernel e da libc, etc.) e o segundo é um automatizador de compilação.No terminal do zabbixsrv rode os seguintes comandos.

1 # aptitude install build -essential make pkg -config openjdk -6-jdk

2

3 # cd /usr/src/zabbix -2.0.5

4

5 # ./ configure --help | less

O configure é um script gerado a partir do “autotools”, que é um conjunto de ferra-



mentas para facilitar a compilação de fontes em C. A opção –help fornecida acima irálistar todas as opções que podemos ativar ou não para compilar o Zabbix. Note que oconfigure não compila nada ele apenas “prepara a cama” para realizar a compilaçãocom o “make”.

Na tabela a seguir estão as opções relevantes do configure para a nossa tarefa.Opção do configure



Tabela 3.1: Opções de compilação

Opções do configure Descrição

- -enable-server Ativa a compilação do servidor. No caso presente ire-mos ativar esta opção, quando formos compilar ape-nas o agente iremos desabilitá-la.

- -enable-proxy Compila os binários para sistemas distribuídos. Comoneste curso não abordaremos o sistema de proxy, va-mos deixar essa opção desabilitada.

- -enable-agent Compila os binárioss para os agentes. É uma exce-lente idéia sempre deixar esta opção ativada. Mesmoem servidores dedicados do Zabbix é uma boa práticamonitorar a própria máquina.

- -enable-ipv6 Compila suporte a IPV6. Embora não seja absoluta-mente necessário , dado o esgotamento de endere-ços IP da IANA, o 6 logo será necessário.

- -enable-static Ativa a geração de binários de forma estática. É reco-mendado deixar esta opção desligada.

- -with-ibm-db2 Ativa o suporte do banco de dados IBM-DB2. Vamosdeixar desabilitado uma vez que usaremos o Pos-treSQL.

- -with-mysql Ativa o suporte do banco de dados mysql. Vamos dei-xar desabilitado uma vez que usaremos o PostreSQL.

- -with-oracle Ativa o suporte do banco de dados oracle. Vamos dei-xar desabilitado uma vez que usaremos o PostreSQL.

- -with-postgres Ativa o suporte do banco de dados PostgreSQL.- -with-jabber Ativa suporte a servidores Jabber permitindo que o

Zabbix envie alertas através deste serviço de mensa-gens instantâneas.

- -with-odbc Ativa o suporte do banco de dados odbc. Vamos dei-xar desabilitado uma vez que usaremos o PostreSQL.

- -with-net-snmp Ativa suporte a monitoramente vai SNMP usando abiblioteca ’net-snmp’ do unix.

- -with-ucd-snmp Ativa suporte a monitoramente vai SNMP usando abiblioteca ucd.

- -with-ssh2 Ativa suporte a monitoramente vai SSH e verificaçãode status de um serviço de conexão remota segura.

- -with-openipmi Ativa suporte a comandos de monitoramento de hard-ware por IPMI.

- -with-ldap Ativa suporte a autenticação via LDAP e verificaçãode status de um serviço de diretórios remotos .

- -prefix=diretório Define localicação da instalação do Zabbix.- -mandir=/usr/share/man Aponta a localização correta da página de manual, as-

sim podemos usar o comando man para acessar asopções dos binários do Zabbix.



3.5.1 Dependências de compilação.

Ao executar o comando abaixo, colete cada erro que aparecer e aponte na tabelao pacote que deve ser instalado para resolver a dependência. Isto vai servir dereferência para você em futuras instalações e também tem como intenção ensinar alidar com erros de dependências de compilação.

1 ./ configure --prefix =/opt/zabbix -2.0.5 --mandir =/usr/share/man --

enable -server

2 --enable -proxy --enable -agent --enable -ipv6 --with -postgresql --with

-jabber --with -libcurl

3 --with -net -snmp --with -ssh2 --without -openipmi --with -ldap --enable -

java

Tabela 3.2: Tabela de dependência

Erro Dependência

Você pode otimizar os binários tornando o Zabbix mais rápido mas depen-dente de uma CPU compatível se você exportar as variáveis de ambiente

CFLAGS e CXXFLAGS com o seguinte valor “-O2 -pipe -march=native”, antes deexecutar o configure. Se você estiver usando um sistema de 32 bits acrescenteainda -fomit-frame-pointer. Cuidado com outros flags de compilação� Você podeacabar com um binário defeituoso�

Solução da tabela de dependência.

1 # aptitude install postgresql -server -dev -9.1 libssh2 -1-dev

libopenipmi -dev

2 libsnmp -dev libksemel -dev libcurl4 -gnults -dev



3.6 Compilando e instalando

Agora que o “configure” chegou ao ponto final e todas as dependências foram resolvi-das é hora de executar a compilação com o comando “make”. Na verdade o “make”não é um compilador, ele apenas chama os comandos necessários para construir osbinário através de um arquivo Makefile que foi gerado pelo “configure”.

Execute conforme abaixo, os comandos. No final o comando “ln” irá criar um linksimbólico para /opt/zabbix. Isso é uma boa prática para ajudar a trocar as versões doZabbix durante uma migração, apontando o link para a pasta com os novos binários,enquanto mantemos os anteriores para o caso de um “downgrade” emergencial.

Você pode substituir o -j2 por outro número para acelerar a sua compilaçãose você tiver múltiplos cores. Uma regra geral é 2xCores+1.

1 # make -j2

2 # make install

3 # ln -svf /opt/zabbix -2.0.5 /opt/zabbix

4 # tree /opt/zabbix

O comando “tree” vai mostrar a hierarquia de diretórios e arquivos abaixo do caminhoda instalação. A tabela abaixo tem o descritivo de cada um deles.

Caso não esteja instalado, execute : # aptitude install tree



Tabela 3.3: Comandos do Zabbix

Binário Funcionalidade

zabbix_get Utilitário para realizar consultas nos agentes vialinha de comando.

zabbix_sender Utilitário para envio de traps para o servidor Zab-bix. É necessário criar um item do tipo ZabbixTrap para lidar com estes eventos.Útil para aler-tar incidentes instantâneamente para o servidorcomo o ínicio, término ou erro de um backup.

zabbix_agent Agente para ser usado com o super deamon xi-netd ou similar. Não é necessário na maioria dasvezes e será removido do diretório.

zabbix_agentd O daemon do agente do Zabbix que fica na me-mória a espera das requisições do servidor.

zabbix_server O daemon do servidor do Zabbix. Este é o com-ponente principal de toda a infraestrutura.

É preciso remover o “zabbix_agent” , uma vez que iremos usar apenas o “daemonzabbix_agentd”. Também é uma boa prática não manter os símbolos de depuraçãonos binários de produção. O comando “strip” irá retirar estes símbolos e o executávelfinal será ligeiramente menor em tamanho (o que ajuda a consumir menos memóriatambém).

1 # rm /opt/zabbix -2.0.5/ sbin/zabbix_agent

2 # strip --strip -all /opt/zabbix -2.0.5/*/*

Não é aconselhável executar daemons de sistema com o usuário root, por isso vamoscriar um grupo e usuário de nome zabbix para que o serviço entre na memória comousuário não privilegiado.

O nome do usuário que o Zabbix usa é hadcoded, ou seja, ele é programadodentro do código fonte e não pode ser alterado via configuração. Desse modo

sempre temos que criar o usuário com o nome zabbix, já o nome do grupo é total-mente opcional.

1 # groupadd zabbix

2 # useradd -g zabbix -m -s /bin/bash zabbix



Ambos os daemons, do agente e do servidor, precisam de dois diretórios para arma-zenar os logs e o arquivo de PID. Com os comandos abaixo crie e dê as permissõesnecessárias para ambos.

1 # mkdir /var/{log ,run}/ zabbix -p

2 # chown zabbix. /var/{run ,log}/ zabbix -R

3.7 Serviços de rede

Acrescente ao “/etc/services” (caso não exista) o mapeamento de portas do “ZabbixAgent” e “Zabbix Trapper”.

1 # vim /etc/services

2

3 zabbix -agent 10050/ tcp Zabbix Agent

4 zabbix -agent 10050/ udp Zabbix Agent

5 zabbix -trapper 10051/ tcp Zabbix Trapper

6 zabbix -trapper 10051/ udp Zabbix Trapper

Estas entradas permitem que programas como “wireshark” e “netstat” reconheçamas portas do Zabbix.

3.8 Arquivos de configuração

Os arquivos de configuração do Zabbix acompanham os seus fontes, mas a 4Linuxpreparou um conjunto de arquivos para uso em produção com uma organizaçãomelhorada. Ao invés de simplesmente colocar todas as configurações em um únicoarquivo, os parâmetros foram distribuídos em grupos lógicos separados em váriosarquivos e diretórios.

1 # cd ~/conf/zabbix/

2 # tar xf zabbix -server -config.tar.bz2 -C /opt/zabbix/etc

3 # tar xf zabbix -agent -config.tar.bz2 -C /opt/zabbix

4 # mv /opt/zabbix/default /etc

5 # mv /opt/zabbix/init.d /etc

6 # chown root.zabbix /opt/zabbix/etc -R

7 # find /opt/zabbix/etc -type d -exec chmod 0750 {} \;

8 # find /opt/zabbix/etc -type f -exec chmod 0640 {} \;

9 # chmod 0750 /opt/zabbix/share/zabbix/externalscripts /* /etc/init.d/

zabbix -*



1) Note que o grupo dos diretórios e seus arquivos foram apontados para “zabbix”.O dono continuou a ser o root; 2) Todos os diretórios tiveram a permissão de acessoglobal revogada, nenhum usuário do sistema tem que acessar esta pasta exceto o doZabbix (existem informações sensíveis como senhas em text/plain nestes arquivos).Também, apenas o root tem direitos de gravação nessas pastas o grupo zabbix temapenas acesso de leitura. 3) Os arquivos seguem a mesma lógica que os diretó-rios.

O Zabbix por padrão procura pelos seus arquivos em /opt/zabbix/etc, a partir dosarquivos principais (zabbix_server.conf e zabbix_agentd.conf) outros arquivos foramchamados e inseridos na configuração. A tabela abaixo demonstra como ficaramorganizados os diretórios e seu conteúdo.

Tabela 3.4: Diretórios e arquivos do Agente do Zabbix

Diretório ou Arquivo Descrição

/opt/zabbix/etc/agent.d Diretório para configurações extrasdo agente.(carregado pelo arquivoprincipal)

/opt/zabbix/etc/agent.d/activechecks.conf Configuração de checagens ativas doagente.

/opt/zabbix/etc/agent.d/logs Configuração de logs (local, nível dedebug) do agente.

/opt/zabbix/etc/agent.d/passivechecks.conf Configuração de checagens passivasdo agente.

/opt/zabbix/etc/agent.d/remote_commands.conf Configuração de recebimento de co-mandos remotos no agente.

/opt/zabbix/etc/agent.d/userparams.conf Configuracao para parametros perso-nalizados pelo usuario.

/opt/zabbix/etc/zabbix_agentd.conf Arquivo principal de configuração doagente.

Tabela 3.5: Diretórios de scripts do Zabbix

Diretório Descrição

/opt/zabbix/share/zabbix/alertscripts Diretório para scripts de alertas exter-nos.

/opt/zabbix/share/zabbix/externalscripts Diretório para scripts de extensão doagente do Zabbix.



Tabela 3.6: Diretórios e arquivos do Servidor do Zabbix

Diretório ou Arquivo Descrição

/opt/zabbix/etc/server.d Diretório para configurações extrasdo servidor.(carregado pelo arquivoprincipal)

/opt/zabbix/etc/server.d/activechecks.conf Configuracoes para coletas ativas(que partem dos agentes para o ser-vidor)

/opt/zabbix/etc/server.d/alerts.conf Opcoes de configuracoes de alertasdo Zabbix.

/opt/zabbix/etc/server.d/cache.conf Opcoes de cache do Zabbix server./opt/zabbix/etc/server.d/database.conf Configuração do ’back and’ do banco

de dados do servidor Zabbix./opt/zabbix/etc/server.d/external.conf Configuracao para recursos externos

do servidor./opt/zabbix/etc/server.d/housekeeping.conf Configuracao de housekeping do ser-

vidor do Zabbix./opt/zabbix/etc/server.d/jmx-gateway.conf Configuracao de acesso ao JMX Ga-

teway./opt/zabbix/etc/server.d/logs.conf Configuração de logs (local, nível de

debug) do agente./opt/zabbix/etc/server.d/node.conf Configuracao de node./opt/zabbix/etc/server.d/passivechecks.conf Configurações para coletas passivas

(que parter do servidor para os agen-tes)

/opt/zabbix/etc/server.d/proxy.conf Configuração de monitoramento dis-tribuído do servidor.

/opt/zabbix/etc/zabbix_server.conf Arquivo principal de configuração doservidor.

Não deixe de fazer o procedimento das permissões, ele vai tornar a sua insta-lação do Zabbix muito mais segura. Para finalizar vamos configurar o sistema

para apontar o PATH para o link simbólico de instalação. Isso vai facilitar o acessoaos comandos.

1 # vim /etc/profile.d/zabbix -path.sh

2 export PATH="$PATH:/opt/zabbix/sbin:/opt/zabbix/bin"

3 # . /etc/profile

4 # zabbix_get --help

5 # zabbix_agentd --help



3.9 Testando sua instalação

Utilize o manual do “zabbix_agentd” para descobrir como listar as métricas suporta-das pelo ambiente e como testar um delas individualmente. Depois inicie o agente,veja o conteúdo do arquivo de logs e use os comandos “ps” e “netstat” para ver quaisos processos que ele iniciou e em quais portas eles se vincularam.

Depois do término com o agente vamos configurar o servidor conforme os passos aseguir e realizar o mesmo procedimento de inicialização e pesquisa que no agente.

1 # vim /etc/zabbix/server.d/database.conf

2 DBHost =127.0.0.1

3 DBPort =5432

4 DBName=zabbixdb

5 DBUser=zabbix

6 DBPassword=zabbixdbpw

1) O endereço IP ou nome DNS do servidor que esta com o banco de dados. Comono nosso cenário o banco e o servidor Zabbix estão na mesma máquina virtual uti-lizamos o endereço de “loopback”; 2) A porta TCP de acesso do banco. Esta é aporta padrão do PostgreSQL; 3) Nome do banco de dados que criamos no início docapítulo; 4) Nome do usuário que criamos e demos permissão; 5) Senha do usuárioacima.

Colocando os scripts no boot da máquina virtual.

1 # insserv -v zabbix -agent

2 # innserv -v zabbix -server

Agora execute os scripts de inicialização dos daemons conforme indicado abaixo.

1 # service zabbix -server start

2 # service zabbix -agent start

Verifique se as últimas linhas do log indicam se ambos iniciaram corretamente etambém se todos os processos estão na memória.

1 # tail -n1 /var/log/zabbix/zabbix_server.log

2 1203:20110207:092633.044 server #1 started [DB Cache]

3 # tail -n1 /var/log/zabbix/zabbix_agentd.log


Apostila Instalação do Servidor Zabbix

Documents

Transcript of Apostila Instalação do Servidor Zabbix