Skip to content

README.es.md

Latest commit

 

History

History
181 lines (124 loc) · 6.46 KB

README.es.md

File metadata and controls

181 lines (124 loc) · 6.46 KB
Raw

telert – Alertas para tu terminal

English | हिन्दी | 中文 (简体) | Español

telert logo

Versión 0.2.8

GitHub Stars PyPI version Downloads License Marketplace VS Code Marketplace

📱 Descripción general

Telert es una herramienta ligera que envía notificaciones cuando tus comandos de terminal o código en Python terminan de ejecutarse. Soporta múltiples canales de notificación:

  • Aplicaciones de mensajería: Telegram, Microsoft Teams, Slack, Discord
  • Correo electrónico: Email
  • Dispositivos móviles: Pushover (para Android e iOS)
  • Notificaciones locales: Notificaciones de escritorio, alertas de audio
  • Integraciones personalizadas: Puntos finales HTTP para cualquier servicio

Ideal para tareas de larga duración, servidores remotos, pipelines de CI o monitoreo de código crítico.

Disponible como:

  • Paquete de Python: pip install telert
  • Imagen de Docker: docker pull ghcr.io/navig-me/telert:latest
  • API en la nube alojada en Replit, Railway, Render o Fly.io

telert demo

🚀 Instalación y Comienzo Rápido

pip install telert
telert init

Beneficios clave

  • 📱 Recibe notificaciones cuando los comandos finalicen, incluso si estás lejos de tu equipo
  • ⏱️ Mide exactamente cuánto tardó tu comando o código
  • 🚦 Captura el código de estado de éxito/fallo y cualquier error
  • 📃 Visualiza fragmentos de salida del comando en la notificación
  • 🔄 Funciona con comandos shell, tuberías y código en Python

💻 Uso básico

Envuelve cualquier comando para recibir una notificación cuando termine:

# Notificar cuando un comando termine
telert run npm run build

# Agregar una etiqueta descriptiva
telert run --label "Copia de seguridad BD" pg_dump -U postgres midb > backup.sql

# Notificar solo cuando un comando falle
telert run --only-fail rsync -av /origen/ /respaldo/

# Obtener notificaciones para TODOS los comandos que tarden más de cierto tiempo
eval "$(telert hook -l 30)"

Para configuración persistente:

# Agregar a tu .bashrc (usuarios de Bash)
echo 'eval "$(telert hook -l 30)"' >> ~/.bashrc

# Agregar a tu .zshrc (usuarios de Zsh)
echo 'eval "$(telert hook -l 30)"' >> ~/.zshrc

Filtrar mensajes del hook:

Puedes silenciar notificaciones para comandos específicos usando patrones con comodines:

# Agregar filtros para silenciar comandos comunes
telert hook-filter add "cd *"        # Silenciar todos los comandos cd con argumentos
telert hook-filter add "ls*"         # Silenciar ls, lsof, lsblk, etc.
telert hook-filter add "git status"  # Silenciar comando exacto

# Listar filtros configurados
telert hook-filter list

# Eliminar un filtro
telert hook-filter remove "ls*"

# Limpiar todos los filtros
telert hook-filter clear

Los filtros usan comodines estilo shell: * coincide con cualquier secuencia, ? coincide con cualquier carácter individual, [seq] coincide con cualquier carácter en seq.

🚦 Monitorización

Monitorización de Procesos

Supervise el uso de recursos de procesos y reciba notificaciones cuando excedan los umbrales:

# Monitorear uso de memoria de un proceso
telert monitor process --command-pattern "ps aux | grep mi_app" --memory-threshold 2G

# Monitorear múltiples procesos
telert monitor process --command-pattern "ps aux | grep -E 'nginx|postgres'" --cpu-threshold 80

# Listar todos los monitores de procesos
telert monitor process --list

# Detener monitoreo de un proceso
telert monitor process --stop <id-monitor>

Monitorización de Archivos de Log

Vigile archivos de registro en busca de patrones específicos y reciba notificaciones con contexto cuando se encuentren coincidencias:

# Monitorear un archivo de log para patrones
telert monitor log --file "/var/log/aplicacion.log" --pattern "ERROR|CRITICO" --provider telegram

# Monitoreo avanzado con contexto
telert monitor log \
  --file "/var/log/nginx/error.log" \
  --pattern ".*\[error\].*" \
  --context-lines 5 \
  --cooldown 300 \
  --provider slack

# Listar todos los monitores de log
telert monitor log --list

Monitorización de Red

Supervise la conectividad de red y servicios con diferentes tipos de verificación:

# Monitoreo básico de ping
telert monitor network --host ejemplo.com --type ping --interval 60 --provider slack

# Monitoreo de punto final HTTP
telert monitor network \
  --url https://api.ejemplo.com/health \
  --expected-status 200 \
  --timeout 5 \
  --provider telegram

# Monitoreo de puerto TCP
telert monitor network --host db.ejemplo.com --port 5432 --provider email

# Listar todos los monitores de red
telert monitor network --list

Para documentación detallada sobre las características de monitoreo, consulte la Guía de Monitoreo.

🤝 Contribuciones / Licencia

¡Se aceptan PRs y sugerencias!
Licenciado bajo MIT – consulta el archivo LICENSE.

👏 Agradecimientos

Este proyecto ha sido mejorado gracias a todos los colaboradores que brindan sugerencias y comentarios. Si esta herramienta te resulta útil, considera apoyar el proyecto en Buy Me a Coffee ☕

¿Necesitas un VPS?

Prueba estos proveedores con créditos gratuitos: