README_pt.md

Laboratório simples em docker para o Zabbix com PostgreSQL, Grafana e Zapix(Testes em API)

Important Note

Se você estiver usando o Zabbix 5.0 LTS ou usando uma versão anterior ao release do 5.4 por favor, remova ou comente as linhas do container zabbix-reports, ou o docker-compose não vai subir.

Conteúdo

• Zabbix:
  • Zabbix Server zabbix-server:10051
  • Zabbix Agent em: zabbix-agent:10050
  • Zabbix Frontend em: http://zabbix-frontend:8080
• Banco de dados:
  • Postgresql em : postgresql:5432
  • PGAdmin em : http://pgadmin:5050
  • Extensão TimescaleDB instalada
• Ferramentas de apoio:
  • Zapix em: http://zapix
  • Grafana em: http://grafana:3000
  • Mailhog: http://mailhog:8025
• Provisionamento / Pré-configurações:
  • Grafana já está provisionado com :
    • Instalados o plugin e datasources para Zabbix
    • Configurado o Datasource do Zabbix para o Zabbix
    • Configurado o Datasource PostgreSQL para o banco de dados do Zabbix
    • Notification Channel usando e-mail e MailHog
  • Zabbix já está provisionado com :
    • Zabbix já configurado com TimescaleDB
    • Atualização do host "Zabbix server" para usar o nome zabbix-agent com DNS
    • Atualização do Tipo de Mídia EMail para usar o MailHog
    • Configurada a Mídia E-Mail para o usuário "Admin" usando MailHog
    • Habilitada a ação "Report problems to Zabbix administrators"
  • Zabbix 5.4 or mais atual:
    • Container para os Relatórios agendados do zabbix-web-server
    • Configurada a URL do Frontend para o lab: http://zabbix-frontend:8080

Como usar

• Instalar os pré-requisitos

• Copiar o projeto e a dependência do zapix para sua estação:

  git clone --recurse-submodules https://git.serpro/monitoracao/zabbix-lab.git

• Em caso de esquecimento do parâmetro "--recurse-submodules" acima, ative o zapix usando os comandos abaixo:

  git submodule init
  git submodule update

• Se necessário editar as variaveis de opções de versão:

  vim .env

  Ambiente	Padrão	Outras Opções
  ZABBIX_VERSION	7.0-latest	6.0-latest, 5.0-latest, 5.2-latest, 5.4-latest ou trunk (o último é para versões de desenvolvimento)
  POSTGRES_VERSION	15	11, 12 ou 13
  GRAFANA_VERSION	8.3.5	7.5.10, 8.1, 8.2
  GFN_ZBX_PLUGIN_VERSION	4.4.5	4.1.5 (Para Grafana 8 e Zabbix 5.4)

• Iniciar o gestor do hosts para facilitar acesso:

  docker run -d \
      --restart=always \
      -v /var/run/docker.sock:/tmp/docker.sock \
      -v /etc/hosts:/tmp/hosts \
      dvdarias/docker-hoster

• Iniciar o projeto com o docker-compose

  docker-compose up -d

• Observe que a estrutura em docker não usa 'localhost' então não use esse hostname 'localhost' para configurar o PGAdmin para PostgreSQL e no mailhog. Para configurar os mesmos, atentar-se para a opção de hostname para cada contêiner dentro da configuração do arquivo docker-compose.yml.

Ferramentas

Sobre o Zabbix

O Zabbix é uma solução de monitoramento distribuído de código aberto para grandes ambientes - O repositório base desse projeto que contem todos os Dockerfiles do Zabbix para Docker é o zabbix-docker com builds automáticas publicadas no Docker Hub Registry.

Sobre o Zapix

Ferramenta Online para testes e desenvolvimento usando pesquisas dentro da API Web do Zabbix - Projeto original em: Github Zapix por monitoringartist.

Sobre o Grafana

Grafana é uma ferramenta para relatórios e análise de dados - Versão em container já configurada para uso com o plugin do zabbix

Sobre o Mailhog

Ferramenta para teste de envio de emails para desenvolvedores - MailHog.