Zum Inhalt

Polycrate API 0.11.9

Release-Datum: 15. Januar 2026
Typ: Feature Release

Highlights

Dieses Release bringt ein komplettes Redesign der Agent Health-Daten mit direkter Speicherung auf dem Agent Model und Check Result Processing für schnellere Statusaktualisierungen.

  • 🔄 Agent Health Redesign - Health-Daten direkt auf Agent Model
  • 📊 Check Result Processing - Individuelle Check Results via Health Report
  • 🎯 EndpointAgentAssignment Status - Check-Status pro Agent-Endpoint-Zuweisung
  • ⚡ Prometheus Metrics Precompilation - Schnellerer /metrics Endpoint
  • 🧹 AgentHealthData Cleanup - Separates Model entfernt

Artefakte

Docker Images

docker pull cargo.ayedo.cloud/polycrate/polycrate-api:0.11.9

Installation & Update

# Block-Konfiguration aktualisieren
polycrate run polycrate-api install

→ Installationsanleitung

Neue Features

Agent Health Data Redesign

Die Health-Daten des Operators werden jetzt direkt auf dem Agent Model gespeichert statt in einem separaten AgentHealthData Model:

Neue Agent-Felder:

Feld Beschreibung
health_status healthy/degraded/unhealthy
monitored_endpoints_count Anzahl überwachter Endpoints
checks_per_minute Aktuelle Check-Rate
checks_in_queue Wartende Checks
failed_checks_total Fehlgeschlagene Checks (gesamt)
successful_checks_total Erfolgreiche Checks (gesamt)
total_checks_executed Alle Checks (gesamt)
last_health_report_at Zeitpunkt letzter Report

Vorteile: - Keine zusätzlichen DB-Joins für Health-Status - Kein Cleanup-Task für alte Health-Daten nötig - Direkter Zugriff auf aktuelle Metriken im UI

Check Result Processing

Der Health Report Endpoint (/api/v1/agent/health/) wurde erweitert um check_summary und check_results:

{
  "status": "healthy",
  "check_summary": {
    "monitored_endpoints": 16,
    "checks_per_minute": 12.5,
    "successful_checks": 150,
    "failed_checks": 2
  },
  "check_results": [
    {
      "endpoint_id": "uuid",
      "success": true,
      "status_code": 200,
      "duration_ms": 45
    }
  ]
}

Die API verarbeitet diese Check Results und aktualisiert die entsprechenden EndpointAgentAssignment Einträge.

EndpointAgentAssignment Status-Felder

Neue Felder auf der Agent-Endpoint-Zuweisung:

Feld Beschreibung
last_check_at Zeitpunkt letzter Check
last_check_success Erfolg (true/false)
last_check_status_code HTTP Status Code
last_check_error_code Error Code
last_check_error_name Error Name (human-readable)
last_check_duration_ms Check-Dauer in ms
checks_executed Anzahl Checks (gesamt)
checks_failed Fehlgeschlagen (gesamt)
checks_successful Erfolgreich (gesamt)

Diese Daten werden im Endpoint Detail UI und Agent Detail UI angezeigt.

Prometheus Metrics Precompilation

Der /api/v1/metrics Endpoint ist jetzt signifikant schneller durch Precompilation:

  • Celery Task berechnet Metriken alle 60 Sekunden
  • Redis Cache speichert vorberechnete Metriken (120s TTL)
  • Fallback auf Live-Berechnung bei Cache-Miss

Neue Metriken: - polycrate_io_api_metrics_precompute_duration_seconds - Berechnungsdauer - polycrate_io_api_metrics_cache_hits_total - Cache Hits - polycrate_io_api_metrics_cache_misses_total - Cache Misses

Bugfixes

Certificate ViewSet Agent Token Handling

Problem: Certificates wurden ohne Organization/Workspace erstellt wenn der Request über einen Agent Token kam.

Lösung: perform_create() und perform_update() setzen jetzt organization und workspace aus dem Agent Token - analog zu anderen ViewSets.

Backup/BackupSchedule Schema Fix

Problem: Go SDK konnte Backup-Responses nicht unmarshallen weil k8s_cluster als Objekt statt UUID serialisiert wurde.

Lösung: to_representation() Override in Serializer entfernt - API gibt jetzt konsistent UUID zurück.

Breaking Changes

AgentHealthData Model entfernt

Das separate AgentHealthData Model wurde komplett entfernt:

  • Model-Klasse entfernt
  • Admin-Klasse entfernt
  • Serializer entfernt
  • Cleanup-Task entfernt
  • Datenbank-Tabelle via Migration gelöscht

Migration: Keine manuelle Aktion erforderlich. Alte Health-Daten werden automatisch gelöscht.

Für Operator: Erfordert polycrate-cli 0.29.9+ für das neue Health Report Format.

UI-Änderungen

Agent Detail View

  • Checks/Minute Chart mit VictoriaMetrics Daten (24h)
  • Monitored Endpoints Table mit Check-Status pro Endpoint
  • Health-Felder direkt aus Agent Model

Endpoint Detail View

  • Check-Statistiken in Agent Monitoring Status Table
  • Success Rate mit Farbkodierung
  • Konsistente Darstellung zwischen Summary und Table

polycrate-api Block

Der polycrate-api Block wurde auf Version 0.5.13 aktualisiert:

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

Migration

Datenbank-Migration erforderlich:

# In Docker Container
python manage.py migrate

Die Migration: 1. Fügt neue Felder zu Agent hinzu 2. Fügt neue Felder zu EndpointAgentAssignment hinzu 3. Löscht die AgentHealthData Tabelle

Abhängigkeiten

  • polycrate-cli 0.29.9+: Erforderlich für Check Result Submission
  • Redis: Für Prometheus Metrics Cache

Weitere Informationen