With version 0.11.0, the Polycrate API gains two key new features: Downtime Detection & Logging for automatic capture and SLA tracking of service outages, and a Notification System for multi-provider notifications.
Downtime Detection & Logging
Centralized capture and tracking of service downtimes with full SLA integration.
Highlights:
- Automatic Downtime Detection: Downtimes are automatically created when ManagedObjects transition to an unhealthy state
- SLA Tracking: Calculation of actual availability based on target SLA
- Multi-Object Support: A downtime can track multiple affected objects
- Activity Aggregation: All activities during a downtime are automatically linked
- Post-Mortem via Notes: Integration with the notes system for documentation
Downtime Kinds:
| Kind | SLA Relevant |
|---|---|
generic |
✅ Yes |
planned-maintenance |
❌ No |
emergency-maintenance |
❌ No |
customer-caused |
❌ No |
upstream-provider |
❌ No |
force-majeure |
❌ No |
false-positive |
❌ No |
Notification System
Centralized notification system with multi-provider support via Apprise.
Supported Providers:
- Mattermost - Webhook URL
- Slack - Webhook URL
- Microsoft Teams - Webhook URL
- Email - SMTP configuration
Features:
- Notification Sinks: Configurable notification targets per workspace or organization
- Template System: Jinja2 templates for various notification types
- Multiplexing: A notification can be sent to multiple sinks
- Retry Logic: Automatic retry for failed notifications
Automatic Notifications:
- Downtime started
- Downtime ended
- Status changes (optional)
Workspace Template API Extensions
Extensions of the Workspace API for template-based workspace creation:
- Template Support: Workspaces can be created from templates
- secrets_poly_raw: Access to encrypted secrets via API
- Template Validation: Automatic validation of organization-specific and system-wide templates
Update Now
# In polycrate-api workspace
polycrate run docker build
polycrate run docker push
polycrate run polycrate-api install
Polycrate API is the backend for the Polycrate CLI, enabling centralized multi-cluster management. Learn more →