Polycrate API 0.11.8¶

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

Highlights¶

Dieses Release bringt das Endpoint Monitoring Dashboard mit historischen Graphen basierend auf VictoriaMetrics. Zusätzlich wurden kritische Performance-Probleme behoben und die Endpoint/Agent Detail UIs signifikant verbessert.

• 🎯 Endpoint Monitoring Dashboard mit VictoriaMetrics Graphen
• 📊 24 neue Prometheus Metriken für Agent Capacity, Coverage und Check Performance
• ⚡ 17x schnellere API Performance durch N+1 Query Fix
• 🖥️ Verbesserte Endpoint & Agent UIs mit Uptime-Bars und Latency-Graphen

Artefakte¶

Docker Images¶

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

Installation & Update¶

# Block-Konfiguration aktualisieren
polycrate run polycrate-api install

→ Installationsanleitung

Neue Features¶

Endpoint Monitoring Dashboard mit VictoriaMetrics Graphen¶

Das Endpoint Monitoring Dashboard (/ui/system/endpoint-monitoring/) zeigt jetzt historische Daten als interaktive Graphen:

Farbkodierung: - 🟢 Grün: OK (Utilization <75%, Coverage 100%) - 🟠 Orange: Warning (Utilization 75-90%, Coverage 80-100%) - 🔴 Rot: Critical (Utilization ≥90%, Coverage <80%)

→ Endpoint Monitoring Dokumentation

24 neue Prometheus Metriken¶

Neue Metriken für Endpoint Monitoring werden via /api/v1/metrics exportiert:

Agent Capacity: - polycrate_io_api_agent_capacity - Maximale Kapazität pro Agent - polycrate_io_api_agent_assigned_endpoints - Zugewiesene Endpoints - polycrate_io_api_agent_utilization_percent - Auslastung in % - polycrate_io_api_agent_checks_per_minute - Checks/Minute

Coverage: - polycrate_io_api_endpoint_coverage_total{coverage_status} - Endpoints nach Status - polycrate_io_api_endpoint_coverage_rate_percent - Coverage-Rate - polycrate_io_api_endpoint_multi_coverage_rate_percent - Multi-Coverage-Rate

Check Performance: - polycrate_io_api_endpoint_check_latency_avg_ms - Durchschnittliche Latenz - polycrate_io_api_endpoint_checks_total{status} - Checks nach Status - polycrate_io_api_endpoint_check_success_rate_percent - Erfolgsrate

Assignment Stability: - polycrate_io_api_assignment_churn_rate - Änderungen/Minute - polycrate_io_api_assignment_avg_duration_hours - Durchschnittliche Zuweisungsdauer

Summary: - polycrate_io_api_endpoint_monitoring_summary{metric} - Zusammenfassende Metriken

Verbesserte Endpoint & Agent Detail UIs¶

Die Detail-Ansichten für Endpoints und Agents wurden mit visuellen Komponenten erweitert:

Endpoint Detail: - Uptime-Bars (3h, 5-Minuten-Intervalle) - Latency-Graph mit Threshold-Linien - Agent-Zuordnung mit Status

Agent Detail: - Checks/Minute Graph - Health-Status Metriken - Endpoint-Zuweisung mit Capacity-Anzeige

Bugfixes¶

Backup/BackupSchedule Serializer¶

Problem: Der Operator konnte keine Backups/BackupSchedules erstellen, weil k8s_cluster als read-only Feld definiert war.

Lösung: k8s_cluster ist jetzt als PrimaryKeyRelatedField writable.

N+1 Query Performance (17x schneller)¶

Problem: API List-Endpoints waren extrem langsam (3.5s für 50 Objekte) durch fehlende Query-Optimierungen.

Lösung: Automatische select_related Erweiterung in ManagedObjectBaseViewset für alle ViewSets.

APM Stack Admin Delete Permission¶

Problem: Superuser konnten APM Stacks im Django Admin nicht löschen.

Lösung: Delete-Permission für Superuser aktiviert.

Refactoring¶

Activity Tracking Whitelist¶

Das Activity Tracking wurde von Blacklist auf Whitelist umgestellt. Nur explizit definierte Model-Änderungen werden jetzt getrackt.

polycrate-api Block¶

Der polycrate-api Block wurde auf Version 0.5.9 aktualisiert:

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

Migration¶

Keine Migration erforderlich. Das Update kann ohne Datenbankänderungen durchgeführt werden.

VMAgent Konfiguration: Falls VictoriaMetrics genutzt wird, muss ein neuer Scrape-Job hinzugefügt werden:

- job_name: 'polycrate-api'
  static_configs:
    - targets: ['polycrate-api:8000']
  scrape_interval: 60s
  metrics_path: /api/v1/metrics

Weitere Informationen¶

• Polycrate API Übersicht - Allgemeine Dokumentation
• Endpoint Monitoring - Dashboard Dokumentation
• Vollständiger Changelog