InfraWatts-Dokumentation
Daten, Empfehlungen und Grenzen verstehen, bevor Sie Ressourcen reduzieren, Änderungen vorbereiten oder Kapazität behalten.
Produktverhalten
InfraWatts führt Infrastrukturmetriken zusammen, um Verschwendung zu erkennen und Empfehlungen zu priorisieren. Die Sonde erkennt zuerst den Linux- oder Windows-Host, dann unabhängig Docker und Kubernetes. Ein Linux-Host bleibt auch mit diesen Runtimes ein Linux-Host.
Dashboard, Assistent, Warnungen, Empfehlungen und Exporte lesen denselben Serverzustand. Empfehlungen beruhen auf beobachteten Metriken und Kontext; ein Inventar allein belegt keine Einsparung. Die ausgewählte Sonde bleibt der Standardbereich.
Bereich des Assistenten
Der Assistent verwendet standardmäßig die ausgewählte Sonde. Eine globale Frage kann die Analyse auf mehrere Sonden erweitern; die ausdrückliche Nennung einer anderen Sonde kann den Bereich ändern, wenn diese zu Ihrem Konto gehört.
/infra, /alerts und /agent <name> präzisieren eine Anfrage. Der sichtbare Kontext kann Sonde, Runtimes und Kubernetes-Zustand umfassen. Eine Handlungsempfehlung belegt keine Ausführung.
Erkennung der Umgebungen
Die Hostplattform wird vor den Runtimes erkannt. Erkennung und Verfügbarkeit sind getrennt: Docker oder Kubernetes können erkannt und zugleich nicht verfügbar sein.
k8s_not_configured bedeutet, dass kein nutzbarer Kubernetes-Kontext vorliegt; k8s_unreachable bezeichnet einen konfigurierten, unerreichbaren Cluster; docker_unavailable einen unerreichbaren Docker-Daemon. Diese Hinweise bleiben ohne kritische Warnung sichtbar.
Warnungen und Schweregrad
critical umfasst etwa Sonden offline, unerreichbare konfigurierte Runtimes und schwere Risiken. warning umfasst Einschränkungen, CPU- oder Speicherdruck und Konfigurationsprobleme. info liefert Hinweise mit geringem Risiko.
Das Warnungszentrum bündelt Vorfälle und Runtime-Hinweise mit Sonde, Ursache und verfügbaren Details. Keine kritische Warnung bedeutet nicht, dass keine Hinweise bestehen. Das Ausblenden behebt die Infrastruktur nicht.
Effizienzbewertung
Der Wert von 0 bis 100 kombiniert beobachtete CPU-Auslastung und geschätzte oder verfügbare Leistungsdaten, um Unterauslastung, effiziente Bereiche und Überlastung aufzuzeigen. Sehr geringe CPU-Nutzung oder unverhältnismäßiger Verbrauch können den Wert senken.
Der Wert hilft, Optimierungen zu priorisieren. Er ersetzt keine Prüfung von Spitzen, Speicher, Abhängigkeiten und erforderlicher Kapazität.
Empfehlungen zur Dimensionierung
Empfehlungen verbinden CPU, RAM, Hostingkontext und gegebenenfalls einen Anbieterkatalog. Für physische Server oder unklare Anbieter bleiben allgemeine Empfehlungen möglich.
Eine Empfehlung zeigt Vertrauensniveau, Zielprofil, Grenzen und verfügbaren geschätzten Nutzen. Die Instanz ist ein Katalogbeispiel. Prüfen Sie Abhängigkeiten, Spitzen, Risiken und Rückkehrplan vor Änderungen; geschätzte Einsparungen sind keine realisierten Einsparungen.
Berichte und Exporte
JSON-, CSV- und PDF-Exporte verwenden denselben normalisierten Datensatz: Hosts, kumulierte Energie, kumuliertes CO₂ und Zeitreihen pro Sonde. Sie unterstützen Entscheidungen anhand verfügbarer Daten.
Wählen Sie alle Sonden oder eine Teilmenge und die Berichtssprache. Das PDF zeigt Annahmen und Messgrenzen. Beobachtungs-, Entscheidungs- und Strategiefenster sind getrennt.
API und OpenAPI
Die interaktive Dokumentation liegt unter /api/docs/, das Schema unter /api/schema/. Authentifizierte Zugriffe unterliegen den Kontoberechtigungen.
Der dokumentierte Bereich /api/v1/ umfasst GET /api/v1/agents (Sonden und Warnungsübersicht), GET /api/v1/metrics (Metriken), GET /api/v1/alerts (Warnungen), GET /api/v1/recommendations (Empfehlungen) und GET /api/v1/audit (Berichtsdatensatz).