Kapazitätsübersicht pro Cluster

?Hilfe zu Benutzer & Rollen Admin-Handbuch

Webhooks (Ereignisse an externe Systeme)

Bei einem Ereignis schickt das Dashboard einen HTTP-POST mit JSON an die hinterlegten Ziele — für ITSM (ServiceNow/Jira), Automatisierung (Ansible AWX, n8n), Pipelines (GitLab/GitHub) oder Chat (Slack/Teams). Jeder Payload wird mit dem Secret HMAC-SHA256-signiert (Header X-Kapa-Signature), damit der Empfänger die Echtheit prüfen kann. Secrets werden nie zurück angezeigt und liegen bewusst nicht im Backup.

Aktiv	Ziel-URL	Ereignisse	Secret	Beschreibung

Datenquellen (vROps, Kubernetes)

Die Datenquellen werden hier gepflegt. Beim ersten Start wurden die [quelle:*]-Sektionen der INI einmalig übernommen, danach wird die INI dafür ignoriert. Passwörter liegen getrennt in einer eigenen Datei (Modus 0600), werden nie zurück angezeigt und sind nie Teil eines Backups. Eine Quelle lässt sich nicht umbenennen – ihr Name steckt in den Reservierungen (Cluster-Schlüssel „Quelle/Name“); stattdessen neu anlegen und die alte deaktivieren. Speichern stößt einen Datenabruf an.

Ankündigung (Popup nach der Anmeldung)

Ist die Ankündigung aktiv, sieht jeder Benutzer sie einmal als Popup – nach dem Klick auf „Verstanden" erscheint sie nicht erneut. Eine Änderung an Titel oder Text zeigt sie allen Benutzern noch einmal. Beispiele: Neues aus einem Release, neue Datacenter/Cluster, Wartungsfenster.

Titel Text

Englische Fassung (optional)

Wird in der englischen Oberfläche statt der deutschen angezeigt. Leer = der deutsche Text bleibt stehen.

Titel (Englisch) Text (Englisch)

aktiv – Popup wird angezeigt

Benutzer und Rollen

Typ	Benutzer / Gruppe	Rolle	Team	Quellen	Aktion

Rollen-Bezeichnungen

Die angezeigten Namen der Rollen sind frei wählbar. Die Rechte bleiben an der internen Rolle (linke Spalte) gebunden und ändern sich dadurch nicht. Die englische Spalte ist optional — sie wird in der englischen Oberfläche überall dort verwendet, wo die Bezeichnung auftaucht.

Interne Rolle	Bezeichnung (Deutsch)	Bezeichnung (Englisch)

Genehmigungs-Teams (Prüfreihenfolge)

Anträge durchlaufen die Teams von oben nach unten. Erst wenn alle Teams freigegeben haben, ist ein Antrag genehmigt. Ohne Teams gilt einstufig (Admin genehmigt direkt). Reviewer werden oben ihrem Team zugewiesen. Die E-Mail/Verteiler je Team wird angeschrieben, sobald das Team im Workflow an der Reihe ist (siehe „Mail-Benachrichtigungen"); mit „Team-Adressen speichern" sichern.

Stufe	Team (Deutsch)	Team (Englisch)	E-Mail / Verteiler (Team ist dran)	Aktion

Aktive Sitzungen

Wer gerade angemeldet ist – zum Erkennen verwaister Sitzungen oder um eine Sitzung gezielt zu beenden (erzwingt die nächste Anmeldung).

Benutzer	Rolle	Team/Abteilung	angemeldet seit	zuletzt aktiv	läuft ab	Aktion

Anmeldung

Genau eine Anmeldeart ist aktiv; der lokale Admin bleibt immer als Notzugang. Werte, die das Deployment vorgibt (Parameter, INI, Umgebungsvariablen), gelten und sind hier gesperrt. Secrets lassen sich nur setzen, nie anzeigen, und sind nie Teil eines Backups. Beim Umstellen der Anmeldeart enden alle Sitzungen außer denen des lokalen Admins.

Cluster-Selektor (Filter nach vSphere-Tags)

Bis zu 3 Stufen, jede Stufe eine Tag-Kategorie. In der Kapazitätsübersicht erscheinen dann kaskadierende Auswahllisten (Stufe 2 zeigt nur Werte, die zur Wahl in Stufe 1 passen). Die Kategorien kommen aus den vorhandenen Cluster-Tags – sind noch keine Daten geladen, ist die Liste leer.

Bezeichnung der Quellen-Auswahl im Selektor
z. B. Datenquelle oder RZ-Standort

Stufe	Tag-Kategorie	Anzeigename (Deutsch)	Anzeigename (Englisch)

Auto-Freigabe (Schwellenwerte)

Erfüllt der Ziel-Cluster nach Abzug des Antrags alle Schwellen, gibt das System markierte Stufen automatisch frei (Freigebender: „Auto-Freigabe", vollständig im Audit-Log). Geprüft wird bei der Antragstellung und immer, wenn eine Stufe neu an der Reihe ist. Greift eine Schwelle nicht oder fehlen Daten (z. B. kein Workload-Wert), geht der Antrag ganz normal an das Team — die Auto-Freigabe lehnt nie ab.

aktiv – Auto-Freigabe einschalten

vCPU frei mindestens	%
RAM frei mindestens	%
Größte freie LUN mindestens frei	%
Workload höchstens	%

Kubernetes-Schwellen (optional)

Eigene Werte für Kubernetes-Cluster (laufen oft bewusst voller). Leeres Feld = der globale Wert oben gilt. Statt der LUN zählt das Budget der StorageClass, statt des Workload-Werts die tatsächliche Auslastung aus Prometheus.

CPU frei mindestens	%
RAM frei mindestens	%
StorageClass frei mindestens	%
Auslastung höchstens	%

Stufen mit Auto-Freigabe

Nur angehakte Teams werden automatisch freigegeben — z. B. Team 1 prüft manuell, die weiteren Stufen laufen automatisch durch. Ohne Teams gilt der Haken sinngemäß für die einstufige Freigabe.

Ausnahmen je Cluster

Einzelne Cluster können den globalen Schalter überschreiben — in beide Richtungen: einen Cluster von der Auto-Freigabe ausnehmen, obwohl sie global aktiv ist, oder ihn freischalten, obwohl sie global aus ist. Nicht gelistete Cluster folgen dem globalen Schalter. Einfach lostippen – alle Cluster werden vorgeschlagen.

Cluster	Auto-Freigabe

Sichtbarkeit (was sieht welche Rolle)

Haken = die Rolle sieht das Merkmal. Wirkt im UI und im Datenpaket (serverseitig entfernt). Administratoren sehen immer alles. Hier geht es nur um Sichtbarkeit — Rechte (Genehmigen, Verwaltung, Team-Sicht der Anforderer) bleiben fest an den Rollen.

Storage-Erweiterungen

Ist dies aktiv, können Freigebende beim Genehmigen und alle Berechtigten in der Storage-Übersicht eine LUN-Vergrößerung oder eine neue LUN anfragen. Das Storage-Team ruft die offenen Anfragen per API ab (/api/v1/storage-requests, auch CSV inkl. NAA) und meldet mit einem Token-Schreibrecht „Storage" die Umsetzung zurück.

Storage-Erweiterungen erlauben

Mindest-LUN-Größe

Datastores kleiner als dieser Wert werden komplett aus der Auswertung genommen — sie erscheinen nirgends (Storage-Übersicht, Cluster- Detail) und zählen auch nicht in die Storage-Kapazität/Auslastung. Praktisch, um kleine Boot-/ISO-/Scratch-Datastores auszublenden. 0 = alle anzeigen. Die Änderung löst gleich einen neuen Datenabruf aus.

Mindestgröße: GB

Namensfilter

Datastores, deren Name einen dieser Begriffe enthält, werden ebenfalls komplett ausgeschlossen (überall, inkl. Kapazität). Mehrere durch Komma trennen, Groß-/Kleinschreibung egal — z. B. iso, backup, scratch. Ein Begriff wirkt als Teiltreffer (service erwischt auch server-service-01); */? gehen als Platzhalter (*-iso, lun-??-tmp). Leer = kein Filter.

Maximale LUN-Größe (Anfrage-Limit)

Obergrenze für Storage-Anfragen (Vergrößerung und neue LUN). Größere Wünsche werden abgelehnt. Als internes Limit gedacht — Randnotiz: VMFS-6 unterstützt ohnehin höchstens 64 TB je Datastore. 0 = kein Limit.

Maximum: TB

vSAN-Kapazität (Policy-Faktor)

vROps liefert für vSAN keinen sauberen Nutzbar-nach-RAID-Wert, nur die physische Roh- und Belegt-Kapazität. Die Auslastung in % stimmt damit ohnehin; der Faktor rechnet nur die absolute nutzbare Kapazität aus der Policy (Annahme): RAID-1 ≈ 50 %, RAID-5 ≈ 75 % (3+1) bzw. 67 % (2+1), RAID-6 ≈ 67 %. Bei gemischten Policies je Cluster den passenden Standard wählen.

Standard-Policy: Faktor: (0,05–1,0 · z. B. 0,5 = 50 % nutzbar)

Override je Cluster (optional – für abweichende Policies). Einfach lostippen: vorgeschlagen werden nur Cluster mit vSAN-Datastores.

Cluster	Policy	Faktor

Ausfallreserve & Kapazitätsmodell

Wie viel CPU-/RAM-Kapazität als Ausfallreserve von jedem Cluster abgezogen wird. Wähle das globale Modell; einzelne Cluster lassen sich unten überschreiben. Änderungen lösen einen neuen Datenabruf aus.

N+1 (fix) – der größte Host je Cluster wird als Reserve abgezogen. Einfach und robust. N+m & Ziel-Auslastung – wähle die Anzahl Failover-Hosts und wie „scharf" du fährst (z. B. 80 % CPU konservativ, 120 % RAM mit Overcommit). Admission Control (vCenter/vROps) – übernimmt die im Cluster hinterlegten Failover-Prozente (CPU/RAM). Fehlen die Werte in vROps, greift automatisch N+1. Größen-Staffel – Reserve nach Anzahl Hosts im Cluster: kleine Cluster konservativer, große schärfer. Beliebig viele Stufen; greift keine, gelten die Grundwerte.

Gespeichert ist das Modell „Admission Control“. Es braucht eine vSphere-Datenquelle und ist hier deshalb ausgeblendet; für Kubernetes-Cluster gilt stattdessen N+1. Wähle ein anderes Modell und speichere, um es zu ersetzen.

Die erste passende Stufe gewinnt (kleinste Obergrenze ≥ Hostzahl, einschließlich). Cluster über der größten Stufe nutzen die Grundwerte darunter.

bis … Hosts	N+m	CPU %	RAM %

Grundwerte für alles darüber: N+ · CPU % · RAM %

Failover-Hosts (N+m):

Ziel CPU-Auslastung: % Ziel RAM-Auslastung: %

100 % = volle nutzbare Kapazität · <100 % = Puffer · >100 % = Overcommit (v. a. RAM).

Override je Cluster (optional). Einfach lostippen – alle Cluster werden vorgeschlagen.

Cluster	Modell	N+m	CPU %	RAM %

Fristen für Kapazitäts-Anfragen

Zwei getrennte Fristen, jeweils ab dem Anlagetag gerechnet: Die Gültigkeit bestimmt, wie lange eine genehmigte Anfrage Kapazität belegt — danach gilt sie als abgelaufen, die Kapazität ist sofort wieder frei und der Antrag wandert ins Archiv. Die Aufbewahrung bestimmt, wann der Datensatz endgültig gelöscht wird. Abgelehnte und stornierte Anträge laufen nie ab, unterliegen aber derselben Aufbewahrung.

Gültigkeit (belegt Kapazität)	Tage
Aufbewahrung (bis zur Löschung)	Tage

0 bei Gültigkeit = läuft nie ab · 0 bei Aufbewahrung = wird nie gelöscht. Die Aufbewahrung muss mindestens so lang sein wie die Gültigkeit.

Netzwerk-Filter (Portgruppen ausblenden)

Portgruppen, die hier zutreffen, werden komplett ausgeblendet — in der VLAN-Suche, im Netzwerk-Reiter der Cluster-Details und im Datenpaket. Die Änderung löst gleich einen neuen Datenabruf aus.

Namensfilter

Portgruppen, deren Name einen dieser Begriffe enthält. Mehrere durch Komma trennen, Groß-/Kleinschreibung egal — */? gehen als Platzhalter (*-uplink, PG-Test-?). Leer = kein Filter.

VLAN-ID-Filter

Portgruppen mit diesen VLAN-IDs. Einzelne IDs und Bereiche, durch Komma getrennt — z. B. 99, 205, 3900-3999. Wirkt nur auf Portgruppen mit einer einzelnen VLAN-ID (Trunk-Bereiche blendet bereits die Uplink-Erkennung aus). Leer = kein Filter.

Offline-Quellen (Cluster ohne vROps-Anbindung)

Für Bereiche ohne Netzanbindung an ein vROps: Ein Kollege führt das PowerCLI-Skript gegen das isolierte vCenter aus und lädt das erzeugte JSON hier mit einem Quellnamen hoch. Die Cluster erscheinen dann wie eine eigene vROps-Quelle — inklusive Kapazitätsanfragen, VLAN-Suche und Storage-Übersicht. Die Daten sind statisch (Stand = Import-Datum, als Tag am Cluster sichtbar); die Auto-Freigabe klammert diese Cluster bewusst aus. Ein erneuter Import unter demselben Namen ersetzt die Quelle.

PowerCLI-Skript (kapa_export.ps1) Aufruf: .\kapa_export.ps1 -Server vcenter.insel.local

JSON importieren

JSON-Datei wählen & importieren

Quelle	Cluster	Hosts	VMs	importiert am	durch	Aktion

Kapa-Anfragen aus CSV (XLS-Ablösung)

Übernimmt eure bestehende Excel-Liste: in Excel als CSV speichern und hier hochladen. Alle Zeilen kommen als genehmigt an (Freigebender „Import"); die Gültigkeit rechnet ab dem Original-Datum — ältere Einträge laufen entsprechend sofort ab (wird gemeldet). Bereits vorhandene Kapa-Nummern werden übersprungen, ein erneuter Import erzeugt also keine Duplikate. Spalten werden an der Kopfzeile erkannt — Reihenfolge egal, zusätzliche Spalten werden ignoriert:

Spalte (Kopfzeile)	Pflicht	Format	Beispiel
`Kapa-Nummer`	ja	wird die ID; muss eindeutig sein	KAPA-2024-017
`Projekt`	ja	Freitext (Name der Anfrage)	SAP-Erweiterung Q4
`Cluster`	ja	Cluster-Name wie im Dashboard	Cluster-01
`CPU`	ja	ganze Zahl (vCPUs)	16
`RAM`	ja	ganze Zahl in GB	128
`Storage`	ja	ganze Zahl in GB (Tausenderpunkt erlaubt)	2.000
`Datum`	ja	TT.MM.JJJJ (auch JJJJ-MM-TT)	15.06.2026
`Change`	–	Change-/Jira-Ticket	OPS-4711
`Anforderer`	–	Benutzer/Mail	anna.schmidt@firma.local
`Team`	–	Team-Name wie im Dashboard	Team Betrieb

Beispiel-CSV (Vorlage) CSV-Datei wählen & importieren

API-Tokens für externe Anwendungen (Endpunkte unter /api/v1/; Schreibrechte je Token per Klick)

API-Dokumentation öffnen (interaktiv, mit „Ausführen") · OpenAPI-Spec zum Import in Swagger/Postman.

Anwendung	Token-Anfang	erstellt	von	zuletzt benutzt	Schreibrechte	Aktion

Neues API-Token – wird nur EINMAL angezeigt, jetzt kopieren:

Mail-Benachrichtigungen (je interner Rolle)

Legt fest, bei welchem Ereignis eine Mail rausgeht. Anforderer = der jeweilige Antragsteller (automatisch). Admin/Auditor = die eingetragene Verteiler-Adresse. Reviewer / „Team ist dran" = die Team-Adresse aus der Teams-Tabelle (Reiter „Benutzer & Rollen"). Voraussetzung ist ein konfigurierter SMTP-Server. „Freigabe" meint die endgültige Genehmigung. „Erinnerung" mailt das gerade zuständige Team (bzw. den Admin-Verteiler), wenn ein Antrag zu lange auf seine Freigabe wartet.

Interne Rolle	Verteiler-Adresse	Anlage	Ablehnung	Freigabe	Team ist dran	Erinnerung

Erinnerung nach Tagen Wartezeit – danach alle so viele Tage erneut, bis entschieden ist.

Mail-Vorlage (HTML)

Betreff und HTML-Text der Reservierungs-Mails. Verfügbare Variablen unten einfach anklicken, um sie an der Cursor-Position einzufügen. Leer lassen = eingebaute Standardvorlage. Die Vorschau rechts rendert beim Tippen live mit Beispieldaten.
Sprache: Die eingebaute Vorlage ist englisch — eine Fassung für alle Empfänger, unabhängig davon, in welcher Sprache jemand die Oberfläche nutzt. Eine eigene Vorlage darf natürlich in jeder Sprache geschrieben werden.

Betreff HTML-Text

Vorschau (Beispieldaten) · Betreff:

SMTP / Versand (aus der Konfiguration)

Datenabruf-Intervalle (gestaffelt)

Wie ein Cronjob: jeder Teilbereich hat seinen eigenen Takt — so muss nicht alles bei jedem Abruf gelesen werden. Kapazität (VMs bzw. Pods, CPU/RAM/Disk, Tanzu), Netzwerk (Portgruppen/VLANs) und Storage (Datastores/LUNs). Cluster, Hosts und Tags laufen immer mit. Leer oder 0 = Standard-Intervall. Der ⟳-Knopf oben kann jederzeit alles oder einen einzelnen Bereich sofort aktualisieren.

Kapazität	min
Netzwerk (Portgruppen)	min
Storage (Datastores)	min

Zeitzone der Anzeige

Alle angezeigten Zeiten (Stand, Log, die Abgleich-Uhrzeiten im ⟳-Menü, Mail-Zeitstempel) erscheinen in dieser Zeitzone. Der Abruf-Takt selbst ist davon unberührt (er rechnet in Sekunden). Leer = Zeitzone des Servers. IANA-Name, z. B. Europe/Berlin – die Sommer-/Winterzeit wird damit automatisch berücksichtigt.

Backup

Sichert alle Laufzeitdaten (Reservierungen, Rollen, Teams, Selektor, Log, Tokens) als tar.gz auf das konfigurierte SFTP-Ziel. Läuft automatisch nach dem konfigurierten Intervall – hier lässt sich ein Backup sofort auslösen.

Konfiguration (schreibgeschützt)

Die im System gesetzten Werte (aus INI, kapa.env bzw. Kommandozeile). Nur zur Ansicht – Änderungen erfolgen in der Konfiguration und erfordern einen Neustart. Passwörter werden nie angezeigt (nur, ob gesetzt).

Kapazitätsübersicht pro Cluster

Neue Kapazitätsanfrage

Kommentar