# Zabbix: Instalando o agente em clientes linux
## 1. Introdução
Zabbix é uma solução de código aberto para monitoramento de dispositivos e aplicações, sendo capaz de monitorar parâmetros utilizando agentes em diversas plataformas de sistemas operacionais, além de protocolos como SNMP, IPMI, JMX, entre outros.
Este documento visa a orientação para a instalação do agente do Zabbix. Ele é utilizado pelo servidor para monitorar ativos e reportar sua disponibilidade permitindo uma visão proativa do parque tecnológico.
## 2. Ferramentas utilizadas
Este tutorial descreve a instalação do agente no sistema operacional Linux, nas distribuições Debian 8, Ubuntu 14.04 LTS e CentOS 7. Também é abordada a questão de edição posterior à instalação e o controle do processo do agente.
Os softwares utilizados na produção deste tutorial é apresentado a seguir:
- CentOS 7.3
- Debian 8
- Ubuntu 14.04
- Zabbix Agent 3.2.7
## 3. Configurando o serviço
**Estes procedimentos devem ser realizados na máquina a ser monitorada, usando um usuário com permissões administrativas.**
#### Configure o repositório
Para obter a versão mais atual do software, adicione o repositório oficial do Zabbix:
- No Centos
```shell
URL='https://repo.zabbix.com/zabbix/3.4/rhel/7/x86_64/zabbix-release-3.4-2.el7.noarch.rpm'
rpm -ivh "$URL" # Adiciona o repositório do zabbix
```
- No Debian
```shell
URL='http://repo.zabbix.com/zabbix/3.2/debian/pool/main/z/zabbix-release/zabbix-release_3.2-1+jessie_all.deb'
wget "$URL"
dpkg -i zabbix-release_3.2-1+jessie_all.deb
apt-get update
```
- No Ubuntu
```shell
URL='http://repo.zabbix.com/zabbix/3.2/ubuntu/pool/main/z/zabbix-release/zabbix-release_3.2-1+xenial_all.deb'
wget "$URL"
sudo dpkg -i zabbix-release_3.2-1+xenial_all.deb
sudo apt update
```
#### Instale o agente
Uma vez que o sistema já esteja usando o repositório do Zabbix, execute a instalação do agente.
- No Centos
```shell
yum install zabbix-agent zabbix-get # Instala o agente do zabbix
systemctl enable zabbix-agent # Configura o systemd para iniciar o agente do zabbix após o boot
```
- No Debian
```shell
apt-get install zabbix-agent zabbix-get # Instala o agente do zabbix
systemctl enable zabbix-agent # Configura o systemd para iniciar o agente do zabbix após o boot
```
- No Ubuntu
```shell
apt-get install zabbix-agent zabbix-get # Instala o agente do zabbix
systemctl enable zabbix-agent # Configura o systemd para iniciar o agente do zabbix após o boot
```
#### Configure o firewall
Configure o firewall para permitir a conexão entre o servidor e o agente
- No Centos
```shell
firewall-cmd --permanent --add-port=10051/tcp # configura o firewalld para permitir conexões ao proxy do zabbix
firewall-cmd --permanent --add-port=10050/tcp # configura o firewalld para permitir conexões ao agente do zabbix
firewall-cmd --reload
```
- No Debian
Não há firewall ativado por padrão.
- No Ubuntu
Não há firewall ativado por padrão.
#### Configure o agente
Preencha as informações requeridas para configurar o agente, elas serão iguais nos três sistemas operacionais utilizados aqui.
Crie o diretório dos arquivos auxiliares do agente
```shell
mkdir -p /etc/zabbix/zabbix_agentd.conf.d
mkdir -p /etc/zabbix/zabbix_scripts
```
Edite o arquivo de configuração
`nano /etc/zabbix/zabbix_agentd.conf`
```shell
# Edite os parâmetros indicados aqui.
# Os outros podem ser mantidos nos valores padrões
#
# Hostname=> Use o IP ou FQDN da máquina que eestá sendo monitorada
# Server=> Use o IP ou FQDN do servidor Zabbix
Hostname = this.machine
Server = zabbix.int.example.com
ServerActive = zabbix.int.example.com
LogRemoteCommands = 1
EnableRemoteCommands = 1
StartAgents = 3
Include=/etc/zabbix/zabbix_agentd.conf.d/*.conf
```
Inicie o serviço do agente
```shell
systemctl start zabbix-agent
```
## 4. Gerenciando o serviço
#### Alterações na configuração do agente
Se for necessário modificar o arquivo de configuração do Zabbix, ele pode ser encontrado no caminho `/etc/zabbix/zabbix_agentd.conf`. Ao realizar qualquer alteração, é preciso reiniciar o agente.
#### Controlando a execução do serviço do agente
Ao modificar o arquivo de configuração mostrado no item anterior ou por razões fora do escopo deste guia pode ser necessário parar ou reiniciar o serviço usado pelo agente do Zabbix. Os comandos a seguir podem ser utilizados:
Para encerrar a execução do agente:
```shell
systemctl stop zabbix-agent
```
Para reiniciar o agente:
```shell
systemctl restart zabbix-agent
```
Para encerrar a execução do agente:
```shell
systemctl stop zabbix-agent
```