Skip to main content

Notifications

Stay informed about your service health with CuliUptime's email notification system. Get notified when issues occur and when services recover.

🔔 Notification Overview (v0.1.0)​

What are Notifications?​

Notifications are automated email messages sent when your monitors detect changes in service health. They help you:

  • React quickly to downtime incidents
  • Confirm recovery when services come back online
  • Track performance issues before they become critical
  • Monitor SSL certificate expiration dates

Current Features (v0.1.0)​

  • Email Notifications - Receive notifications via email
  • Notification History - View active and recent notifications in dashboard
  • Basic Configuration - Enable/disable email notifications per user
  • Notification Types - Downtime, recovery, and performance alerts

🎯 Notification Triggers​

Supported Triggers (v0.1.0)​

Downtime Events:

  • Service becomes completely unavailable
  • HTTP status codes indicate failure (4xx, 5xx)
  • Connection timeouts and network errors

Recovery Events:

  • Service returns to healthy state
  • Successful responses after downtime period

Performance Issues:

  • Response time exceeds configured threshold
  • Performance grade drops below acceptable level

Certificate Monitoring:

  • SSL certificate expiring within 30 days
  • SSL certificate expiring within 7 days (urgent)

📧 Email Notifications​

Current Capabilities​

What's Available:

  • HTML Email Templates - Well-formatted email notifications
  • Multiple Notification Types - Downtime alerts, recovery confirmations
  • User Preferences - Configure email notification settings
  • Notification History - View past notifications in dashboard

Email Configuration:

  • Configure your email preferences in User Settings → Notifications
  • Enable/disable notifications for different event types
  • Set your preferred email address for notifications

Email Content:

  • Subject Line - Clear indication of service and status
  • Service Details - Monitor name, URL, and current status
  • Incident Information - Error details, response time, timestamp
  • Dashboard Link - Direct link to monitor details

Email Types​

  • 🚨 Downtime Alerts - When a service goes offline
  • ✅ Recovery Notifications - When a service returns online
  • ⚠️ Performance Warnings - When response times are slow
  • 🔐 Certificate Expiry - SSL certificate renewal reminders

⚙️ Notification Configuration​

User Preferences​

Available Settings:

Email Notifications:
  Downtime Alerts: ✅ Enabled
  Recovery Notifications: ✅ Enabled  
  Performance Warnings: ❌ Disabled
  Certificate Expiry: ✅ Enabled
  Email Address: [email protected]

Monitor Settings​

Per-Monitor Options:

  • Notifications are automatically enabled for all monitors
  • Configure notification types through user preferences
  • All monitors respect your global notification settings

📊 Notification History​

Dashboard Integration​

View Notifications:

  • Active Notifications - Current unresolved issues
  • Recent Notifications - Last 20 notifications across all monitors
  • Notification Details - Click to view full notification information

Available Information:

  • Notification type and severity
  • Monitor details (name, URL, type)
  • Timestamp and duration
  • Error messages and context

🔍 Troubleshooting Notifications​

Common Issues​

1. Not Receiving Emails

  • Check your email preferences in User Settings
  • Verify your email address is correct
  • Check spam/junk folder for CuliUptime emails
  • Ensure notifications are enabled for the specific event type

2. Missing Notifications

  • Verify monitor is active and notifications are enabled
  • Check notification history in dashboard
  • Review user preference settings

Email Delivery​

Current Limitations:

  • Email is the only notification channel in v0.1.0
  • No real-time browser notifications
  • No mobile push notifications
  • No webhook or integration support

🚀 Future Versions​

Planned Features (v0.2.0+)​

Advanced Notification Channels:

  • Webhook Notifications - Send to custom HTTP endpoints
  • Team Chat Integration - Slack, Discord, Microsoft Teams
  • Mobile Push Notifications - Native mobile app support
  • SMS Notifications - Critical incident escalation

Enhanced Workflows:

  • Notification Acknowledgment - Mark notifications as acknowledged
  • Escalation Rules - Multi-level notification workflows
  • Quiet Hours - Schedule do-not-disturb periods
  • Maintenance Mode - Pause notifications during planned work

Team Features:

  • Team Notification Settings - Shared notification preferences
  • On-Call Scheduling - Rotation-based notification routing
  • Custom Notification Rules - Advanced filtering and routing

📋 Best Practices​

Email Notification Strategy​

  1. Start Simple

    • Enable downtime and recovery notifications first
    • Add performance notifications once comfortable with volume
    • Monitor your email for notification frequency

  2. Email Management

    • Use email filters to organize CuliUptime notifications
    • Consider separate email for monitoring notifications
    • Regular review of notification preferences

  3. Monitor Organization

    • Use descriptive monitor names for clear notifications
    • Group related services logically
    • Regular cleanup of unused monitors

🔧 Getting Started​

Quick Setup​

  1. Configure Email Preferences

    • Go to User Settings → Notifications
    • Enable desired notification types
    • Verify email address

  2. Create Your First Monitor

    • Add a monitor for your critical service
    • Notifications are automatically enabled
    • Test the setup by checking notification history

  3. Review Notification History

    • Check Dashboard → Notifications section
    • Verify notifications appear as expected
    • Adjust preferences if notification volume is too high

🚀 Next Steps​

Start with basic email notifications and monitor the volume. CuliUptime v0.1.0 provides a solid foundation for service monitoring notifications that will expand significantly in future versions! 📧