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¶

Polycrate API Übersicht - Allgemeine Dokumentation