py-logger-alert 0.2.1

Um monitor de logs automático via Telegram para robôs Python

py-logger-alert 🚀

Uma biblioteca leve e eficiente para monitoramento de scripts e bots em Python.

O py-logger-alert integra o sistema de logging padrão do Python com o Telegram, permitindo receber alertas de erros críticos em tempo real, enquanto mantém um histórico completo de logs em arquivos locais.

Ideal para quem roda bots, automações, robôs de trading ou scripts agendados e precisa saber imediatamente quando algo dá errado.

---

✨ Principais Funcionalidades

• 📢 Notificações em Tempo Real
  Envia logs de nível ERROR e CRITICAL diretamente para o Telegram.

• ⚙️ Configuração Simplificada
  Suporte nativo a variáveis de ambiente via arquivo .env.

• 🧾 Formatação Amigável
  Mensagens formatadas em blocos de código, facilitando leitura de tracebacks.

• 🔐 Segurança
  Truncamento automático de mensagens longas para respeitar os limites da API do Telegram.

---

🛠 Instalação

pip install py-logger-alert

---

⚙️ Configuração do Telegram

🤖 Criando o Bot (BotFather)

1. Abra o Telegram e procure por @BotFather
2. Envie o comando:

/start

3. Crie o bot:

/newbot

4. Defina o nome e o username (termina com bot)
5. Copie o TOKEN retornado

---

🆔 Obtendo o Chat ID

1. Procure por @userinfobot
2. Envie:

/start

3. Copie o número retornado (Chat ID)

---

📁 Arquivo .env

TELEGRAM_TOKEN=seu_token_aqui
TELEGRAM_CHAT_ID=seu_chat_id_aqui

---

🚀 Como Usar

from py_logger_alert import setup_monitoring
import logging

setup_monitoring(
    nome_robo="Robô Trader v1",
    log_filename="logs_bot"
)

logging.info("Sistema iniciado com sucesso.")

try:
    10 / 0
except Exception as e:
    logging.error(f"Erro crítico detectado: {e}", exc_info=True)

---

📜 Licença

MIT License

---

👨‍💻 Autor

Vitor Marinheiro
https://github.com/vitormarinheiro1
https://github.com/vitormarinheiro1/py-logger-alert