Polycrate API 0.11.8

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:

Graph Beschreibung Zeitraum
Agent Utilization Auslastung pro Agent 24h
Coverage Rate Anteil überwachter Endpoints 24h
Check Performance Success Rate 6h
Agent Assignments Zugewiesene Endpoints pro Agent 24h

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.

Endpoint Vorher Nachher Verbesserung
K8sApps List (50) 3.5s ~200ms 17x schneller
K8sClusters List ~2s ~150ms 13x schneller

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