A comprehensive multi-channel error monitoring and notification system for Python applications — built for teams that can't afford to miss a production error.
Developed and maintained by EaseCloud — your trusted partner for cloud-native, AI-driven, and data infrastructure solutions.
Monitor errors, exceptions, and custom events across Telegram, Slack, webhooks, and console output. Route alerts by severity, environment, and channel — automatically.
At EaseCloud, we run Python services in production. We kept hitting the same wall: existing error monitoring tools are either too heavy (full APM suites), too rigid (only one notification channel), or require you to set up and maintain external infrastructure.
Errica removes that friction. Drop it into any Python project, point it at your Telegram or Slack, and within minutes you're getting structured, deduplicated, context-rich alerts — wherever your team already lives.
Our goal is to make production observability accessible to every Python team while showcasing our expertise in integration, automation, and cloud solutions.
- Multi-Channel Notifications: Send alerts to Telegram, Slack, webhooks, and console
- Smart Routing: Route different error levels to different channels based on environment
- Global Exception Handling: Automatically capture unhandled exceptions, asyncio errors, and threading errors
- Task Monitoring: Context managers for monitoring tasks and batch operations
- Rate Limiting: Prevent notification spam with configurable rate limits per channel
- Message Deduplication: Avoid duplicate alerts within configurable time windows
- Rich Formatting: Channel-specific formatting — Markdown for Telegram/Slack, JSON for webhooks, colored output for console
- Health Checks: Monitor channel health and connectivity
- Comprehensive Configuration: YAML configuration with environment variable support
pip install easecloud-errica# For Telegram/Slack/Webhook support (included by default)
pip install easecloud-errica[all]
# For SOCKS proxy support (Telegram)
pip install easecloud-errica[socks]
# For development
pip install easecloud-errica[dev]from easecloud_errica import quick_setup, task_monitor, log_error, log_info
# Quick setup with environment variables
manager, handler = quick_setup()
# Log messages
log_info("Application started")
log_error("Something went wrong", exception, {"user_id": 123})
# Monitor tasks
with task_monitor("user_sync"):
# Your code here
sync_users()Set these environment variables for automatic configuration:
# App identification
export APP_NAME="My Application"
export APP_VERSION="1.0.0"
export ENVIRONMENT="production"
# Telegram (optional)
export TELEGRAM_BOT_TOKEN="your_bot_token"
export TELEGRAM_CHAT_ID="your_chat_id"
# Slack (optional)
export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/..."
# Generic webhook (optional)
export WEBHOOK_URL="https://your-webhook-endpoint.com/alerts"Create a config.yaml file:
app:
name: "My Application"
version: "1.0.0"
environment: "production"
channels:
telegram:
enabled: true
bot_token: "YOUR_BOT_TOKEN"
chat_id: "YOUR_CHAT_ID"
slack:
enabled: true
webhook_url: "YOUR_SLACK_WEBHOOK"
channel: "#alerts"
console:
enabled: true
use_colors: true
routing:
level_routing:
CRITICAL: ["telegram", "slack"]
ERROR: ["telegram", "slack"]
WARNING: ["slack", "console"]
INFO: ["console"]from easecloud_errica import ErricaConfig, create_monitor
config = ErricaConfig()
config.set_config("channels.telegram.enabled", True)
config.set_config("channels.telegram.bot_token", "your_token")
manager, handler = create_monitor(config)- Rich message formatting with Markdown
- File attachments for large error reports
- Proxy support for restricted networks
- Rate limiting and deduplication
- Rich message blocks and attachments
- Thread support for related errors
- Custom emoji and mentions
- Color-coded severity levels
- Generic HTTP webhook support
- JSON or form-encoded payloads
- Custom headers and authentication
- Configurable retry logic
- Colored terminal output
- Detailed exception formatting
- Progress indicators
- Structured logging format
from easecloud_errica import create_config_from_env, create_monitor
config = create_config_from_env()
# Route critical errors to all channels
config.set_config("routing.level_routing.CRITICAL",
["telegram", "slack", "console"])
# Route errors differently per environment
config.set_config("routing.environment_routing.production.ERROR",
["telegram"])
config.set_config("routing.environment_routing.development.ERROR",
["console"])
manager, handler = create_monitor(config)from easecloud_errica import task_monitor, batch_monitor
# Monitor individual tasks
with task_monitor("user_registration", category="auth"):
register_user(user_data)
# Monitor batch operations
with batch_monitor("notification_batch", category="notifications", batch_size=100):
send_notifications(notification_list)
# Decorators for functions
from easecloud_errica import monitor_function, monitor_async_function
@monitor_function
def process_data(data):
return transform(data)
@monitor_async_function
async def fetch_data():
return await api_call()from easecloud_errica import log_error, send_alert, capture_exception
# Log errors with context
log_error("Payment processing failed", exception, {
"user_id": 123,
"payment_amount": 99.99,
"payment_method": "credit_card"
})
# Send custom alerts
send_alert("High CPU usage detected", "WARNING", {
"cpu_usage": "85%",
"threshold": "80%"
})
# Capture exceptions with custom context
try:
risky_operation()
except Exception as e:
capture_exception(e, {"operation": "data_sync"}, "manual")from easecloud_errica import health_check, get_monitoring_stats
# Check channel health
results = health_check()
for channel, result in results.items():
if not result.success:
print(f"❌ {channel}: {result.message}")
# Get comprehensive statistics
stats = get_monitoring_stats()
print(f"Messages sent: {stats['channel_manager']['messages_sent']}")
print(f"Errors captured: {stats['error_handler']['error_count']}")See the examples/ directory for comprehensive examples:
basic_usage.py- Simple setup and usageadvanced_usage.py- Advanced configuration and featuresmulti_channel_demo.py- Multi-channel demonstrationconfig_example.yaml- Complete configuration reference
# Run tests
pytest
# Run with coverage
pytest --cov=easecloud_errica
# Run specific test types
pytest -m unit
pytest -m integration- Email channel implementation
- Database logging channel
- Metrics integration (Prometheus, StatsD)
- Web dashboard for monitoring
- Custom channel plugin system
- Advanced filtering and correlation
- Integration with popular frameworks (Django, Flask, FastAPI)
EaseCloud is a cloud consulting and solutions company specializing in:
- Cloud-native application development
- AI & automation integrations
- DevOps and infrastructure management
- Data analytics and BI platform consulting
We built Errica to solve real production observability problems we faced ourselves — and to contribute a useful, well-maintained tool to the Python open-source ecosystem.
👉 If your team needs help with Python infrastructure, cloud architecture, or AI integrations, get in touch with us — we provide consulting, customization, and managed support for engineering teams.
💡 Work with EaseCloud Need help deploying, scaling, or extending Errica for your production environment? We provide end-to-end support for monitoring, cloud infrastructure, and AI integrations.
📧 Contact us: support@easecloud.io 🌐 Learn more: https://easecloud.io
Contributions are welcome! Please read our Development Guide for setup instructions and Contributing Guide for details.
Found a bug or have a feature request? We'd love to hear from you!
Report Issues: Create a bug report on GitHub
When reporting issues, please include:
- Python version and OS
- Errica version (
pip show easecloud-errica) - Steps to reproduce the issue
- Expected vs actual behavior
- Any error messages or logs
This project is licensed under the MIT License — see the LICENSE file for details.