66 lines
3 KiB
Markdown
66 lines
3 KiB
Markdown
# install-zabbixagent
|
|
|
|
Script para instalação e configuração automática do **Zabbix Agent 2** em servidores Ubuntu e Debian.
|
|
|
|
## Compatibilidade
|
|
|
|
- Ubuntu 20.04
|
|
- Ubuntu 22.04
|
|
- Ubuntu 24.04
|
|
- Debian 12
|
|
- Debian 13
|
|
|
|
## Configuração padrão
|
|
|
|
| Item | Valor |
|
|
|---|---|
|
|
| Zabbix Server | `10.15.0.120` |
|
|
| Versão do Zabbix | `7.4` |
|
|
| Porta do Agent (passive) | `10050` |
|
|
| Porta do Server (active checks) | `10051` |
|
|
|
|
## Uso
|
|
|
|
Execute como **root** na máquina que receberá o agent:
|
|
|
|
```bash
|
|
wget -O install-zabbix.sh https://git.ledcloud.com.br/LED_Cloud/install-zabbixagent/raw/branch/main/install-zabbix.sh
|
|
chmod +x install-zabbix.sh
|
|
sudo ./install-zabbix.sh
|
|
```
|
|
|
|
Ou, se o repositório já estiver clonado localmente:
|
|
|
|
```bash
|
|
git clone https://git.ledcloud.com.br/LED_Cloud/install-zabbixagent.git
|
|
cd install-zabbixagent
|
|
chmod +x install-zabbix.sh
|
|
sudo ./install-zabbix.sh
|
|
```
|
|
|
|
## O que o script faz
|
|
|
|
1. **Detecta o sistema operacional** e valida se é suportado.
|
|
2. Instala dependências (`wget`, `curl`, `ca-certificates`, `gnupg`, `iproute2`).
|
|
3. **Detecta agentes Zabbix já instalados** (`zabbix-agent` clássico e/ou `zabbix-agent2`).
|
|
4. **Para e remove agentes antigos**: para e desabilita os serviços, encerra processos residuais (`SIGTERM` e, se necessário, `SIGKILL`) e desinstala os pacotes (`apt-get purge`).
|
|
5. **Remove configurações antigas** (`/etc/zabbix/zabbix_agentd.conf`, `/etc/zabbix/zabbix_agent2.conf` e os diretórios `.d` correspondentes).
|
|
6. **Verifica se a porta TCP 10050 está livre** antes de prosseguir; se algo ainda estiver escutando nela, o script para com erro.
|
|
7. Adiciona o repositório oficial do Zabbix e instala o pacote `zabbix-agent2`.
|
|
8. Configura `/etc/zabbix/zabbix_agent2.conf` do zero (remove entradas antigas/comentadas da chave e escreve o novo valor):
|
|
- `Server` = IP do Zabbix Server
|
|
- `ServerActive` = IP do Zabbix Server + porta 10051
|
|
- `Hostname` = hostname (FQDN) da máquina, detectado automaticamente
|
|
- `ListenPort` = 10050
|
|
- `ListenIP` = 0.0.0.0
|
|
- `Timeout` = 10
|
|
9. **Valida a configuração** (`zabbix_agent2 -T`) antes de iniciar o serviço.
|
|
10. Habilita e reinicia o serviço `zabbix-agent2`, e valida a instalação: status do serviço, porta 10050 escutando e versão instalada.
|
|
|
|
## Observações
|
|
|
|
- O script precisa ser executado como root (`sudo`).
|
|
- É seguro executar o script mais de uma vez na mesma máquina: instalações/configurações anteriores (Agent clássico ou Agent 2) são detectadas e removidas antes da reinstalação.
|
|
- Se o hostname da máquina não corresponder a um host já cadastrado no Zabbix Server, o agent ficará ativo mas não enviará dados até que o host seja criado no servidor com o mesmo `Hostname` configurado.
|
|
- Se a porta TCP 10050 continuar ocupada por outro processo após a remoção dos agentes antigos, o script para com erro — verifique manualmente o que está usando a porta.
|
|
- Em caso de falha ao iniciar o serviço, o script exibe automaticamente os últimos 100 logs (`journalctl -u zabbix-agent2`).
|