Polycrate API 0.11.0

Polycrate API 0.11.0

Veröffentlicht am: 2026-01-07

Highlights

Dieses Release führt zwei zentrale neue Features ein: Downtime Detection & Logging für automatische Erfassung und SLA-Tracking von Service-Ausfällen, sowie ein Notification System für Multi-Provider-Benachrichtigungen (Mattermost, Slack, Email).

Artefakte

Docker Images

# Linux amd64
docker pull cargo.ayedo.cloud/polycrate/polycrate-api:0.11.0
docker pull cargo.ayedo.cloud/polycrate/polycrate-api:latest

Kubernetes Deployment

# Via Polycrate Block
polycrate run polycrate-api deploy

→ Installationsanleitung

Neue Features

Downtime Detection & Logging

Zentrale Erfassung und Tracking von Service-Downtimes mit vollständiger SLA-Integration.

Highlights:

  • Automatische Downtime-Erkennung: Downtimes werden automatisch erstellt wenn ManagedObjects in einen unhealthy State wechseln
  • SLA-Tracking: Berechnung der tatsächlichen Verfügbarkeit basierend auf Target-SLA
  • Multi-Object Support: Eine Downtime kann mehrere betroffene Objekte tracken
  • Activity-Aggregation: Alle Activities während einer Downtime werden automatisch verknüpft
  • Post-Mortem via Notes: Integration mit dem Notes-System für Post-Mortem-Dokumentation

Downtime-Kinds:

Kind Beschreibung SLA-Relevant
generic Generic ✅ Ja
planned-maintenance Planned Maintenance ❌ Nein
emergency-maintenance Emergency Maintenance ❌ Nein
customer-caused Customer Caused ❌ Nein
upstream-provider Upstream Provider Issue ❌ Nein
force-majeure Force Majeure ❌ Nein
false-positive False Positive ❌ Nein

Notification System

Zentrales Benachrichtigungssystem mit Multi-Provider-Support via Apprise.

Highlights:

  • Multi-Provider: Mattermost, Slack, Microsoft Teams, Email
  • Notification Sinks: Konfigurierbare Benachrichtigungs-Ziele pro Workspace oder Organization
  • Template-System: Jinja2-Templates für verschiedene Notification-Typen
  • Multiplexing: Eine Notification kann an mehrere Sinks gesendet werden
  • Retry-Logik: Automatische Wiederholung bei fehlgeschlagenen Benachrichtigungen

Unterstützte Provider:

Provider Konfiguration
Mattermost Webhook URL
Slack Webhook URL
Microsoft Teams Webhook URL
Email SMTP-Konfiguration

Automatische Notifications:

  • Downtime gestartet
  • Downtime beendet
  • Status-Änderungen (optional)

Workspace Template API Extensions

Erweiterungen der Workspace-API für Template-basierte Workspace-Erstellung.

Highlights:

  • Template-Support: Workspaces können aus Templates erstellt werden
  • secrets_poly_raw: Zugriff auf verschlüsselte Secrets via API
  • Template-Validierung: Automatische Validierung von Organization-spezifischen und System-weiten Templates

SystemConfig-Erweiterungen

Neue Konfigurationsoptionen für Downtime und Notifications:

{
    # Downtime
    "DEFAULT_TARGET_AVAILABILITY": 99.9,      # Standard SLA-Ziel in %
    "AVAILABILITY_CALCULATION_PERIOD_DAYS": 365,
    "DOWNTIME_AUTO_CLOSE_AFTER_HOURS": 24,
    "RECONCILE_DOWNTIMES": true,

    # Notifications
    "NOTIFICATIONS_ENABLED": true,
    "RECONCILE_NOTIFICATIONS": true,
    "NOTIFICATION_RETRY_DELAY_SECONDS": 60,
    "NOTIFICATION_MAX_RETRIES": 3,
    "NOTIFICATION_RETENTION_DAYS": 365,
}

Conditions

Neue Conditions für Monitoring und Alerting:

Condition Typ Beschreibung
DOWNTIME_ACTIVE Degrading Object hat eine aktive Downtime
DOWNTIME_POST_MORTEM_MISSING Degrading SLA-relevante Downtime ohne Post-Mortem
NOTIFICATION_SINK_INVALID_CONFIG Degrading NotificationSink hat ungültige Konfiguration

Voraussetzungen

Dieses Release erfordert Polycrate CLI >= 0.29.2 für korrekte Workspace-Synchronisation.

polycrate-api Block

Der polycrate-api Kubernetes-Deployment-Block wurde auf Version 0.3.0 aktualisiert:

polycrate pull cargo.ayedo.cloud/ayedo/k8s/polycrate-api
polycrate run polycrate-api deploy

Weitere Informationen