Monitoramento Sefaz (NFe/NFCe) com Zabbix + Tecnospeed para qualquer estado

Monitoramento da Sefaz (NFe/NFCe) com Zabbix + Tecnospeed

Este projeto permite monitorar em tempo real o status da Sefaz (NFe e NFCe) utilizando Zabbix, Python e dados da Tecnospeed.

🔎 O que esse projeto faz?

• Consulta o status da Sefaz automaticamente
• Identifica se está Normal, Lento, Timeout ou Erro
• Gera logs para o Zabbix
• Cria triggers automaticamente
• Funciona para QUALQUER estado (PA, SP, RS, MG, etc)

⚙️ Instalação e Dependências

Instale as dependências necessárias no servidor Zabbix:

apt update
apt install -y python3 python3-pip chromium-browser chromium-chromedriver

pip3 install selenium

Crie um ambiente virtual (opcional mas recomendado):

python3 -m venv /root/venv
source /root/venv/bin/activate
pip install selenium

📁 Estrutura dos arquivos

/usr/lib/zabbix/externalscripts/

monitor_nfe_pa.py
monitor_nfce_pa.py
monitor_nfe_rs.py
monitor_nfce_rs.py

monitor_nfe_pa.sh
monitor_nfce_pa.sh
monitor_nfe_rs.sh
monitor_nfce_rs.sh

erros_nfe.sh
erros_nfce.sh

template_tecnospeed.yaml

⚙️ Execução via Shell

Os scripts são executados via Zabbix utilizando shell:

exec "$PY" "$SCRIPT" >> "$LOG" 2>&1

⏱️ Agendamento (CRON)

Adicione as seguintes tarefas no crontab:

crontab -e

📌 NFE

* * * * *  bash /usr/lib/zabbix/externalscripts/monitor_nfe_rs.sh
* * * * *  bash /usr/lib/zabbix/externalscripts/monitor_nfe_pa.sh

📌 NFCE

* * * * *  bash /usr/lib/zabbix/externalscripts/monitor_nfce_rs.sh
* * * * *  bash /usr/lib/zabbix/externalscripts/monitor_nfce_pa.sh

📌 Monitoramento de Erros

*/2 * * * * /bin/bash /usr/lib/zabbix/externalscripts/erros_nfe.sh
*/2 * * * * /bin/bash /usr/lib/zabbix/externalscripts/erros_nfce.sh

💡 Isso garante monitoramento contínuo a cada minuto.

⚙️ Como funciona

O script utiliza Selenium para acessar o monitor da Tecnospeed e identificar o status do estado.

https://monitor.tecnospeed.com.br/?&filter-uf=pa&filter-doc=nfe

💡 Basta trocar o estado:

• pa → Pará
• rs → Rio Grande do Sul
• sp → São Paulo
• mg → Minas Gerais

🧠 Mapeamento de Status

Normal        → green
Erro          → red
Timeout       → yellow
Lento         → orange
Muito Lento   → dark-orange

📊 Integração com Zabbix

O template já vem pronto com:

• Itens de monitoramento
• Leitura de logs
• Triggers automáticas
• Mapeamento de status

🚀 Diferenciais

• ✔ Funciona para todos os estados
• ✔ Monitoramento em tempo real
• ✔ Integração nativa com Zabbix
• ✔ Scripts leves e automatizados
• ✔ Fácil expansão para novos estados

💡 Possibilidades

• Enviar alerta para Telegram
• Enviar alerta para WhatsApp
• Monitorar múltiplos estados
• Criar dashboards em tempo real

📊 Resultado na prática

Exemplo real do status da Sefaz monitorado no Zabbix em tempo real

🔥 Conclusão

Com esse template você tem um monitoramento completo da Sefaz, evitando indisponibilidades e problemas fiscais em produção.

📦 Adquira o Template Completo

Template pronto + scripts configurados + suporte para qualquer estado.