VMware-Datacollector-Sheet

Einleitung

Die Einbindung von Hard-/Software – im Folgenden „System" – ins CIO Cockpit erfordert neben der Erfassung im CIO Cockpit die Konfiguration der Datacollection. Die Datensammlung wird zentral über das Datacollection-Management (DCM) eingerichtet.

Kompatibilität

Unterstützte Systemversionen

Es werden die Versionen ab vCenter 6.0 unterstützt. Für den License-Job werden Versionen ab vCenter 6.5 unterstützt.

Systemzugang

Netzwerk und Firewall

Für die Kommunikation des Datacollectors mit dem System sind folgende Kommunikationswege erforderlich:

Source Destination Port (default) Protocol Direction
datacollector-vm vCenter 443 TCP outbound

Systemzugriff

Benutzer und Berechtigungen

Für den Zugriff auf das vCenter ist ein Benutzerkonto (Empfehlung: cockpit_svc) mit den folgenden Berechtigungen und Eigenschaften auf dem vCenter erforderlich. Erforderliche minimale Berechtigung: "Read only" mit der zusätzlichen Berechtigung "Global.Licenses", falls Lizenzen gesammelt werden sollen.
Ggf. ist es notwendig, eine neue Rolle im vCenter anzulegen, um dem user die benötigten Rechte einzuräumen. Dazu können Sie z.B. die Rolle "Read only" klonen und dieser zusätzlich die Berechtigung "Global.Licenses" zuweisen.

Konfigurationshinweise für das Datacollection-Management

Die folgenden Felder sind für das VCenter einzutragen:

Feldname Erforderlicher Inhalt
Hostname FQDN oder IP des VCenters (z.B. vcenter.mycompany.local)
Username Username des CIO Cockpit-Users für die Datensammlung
Password Passwort des CIO Cockpit-Users für die Datensammlung

Anlegen des Systems im CIO Cockpit

Für die Einrichtung der Datensammlung ist vorab die Anlage des Systems im CIO Cockpit durchzuführen (siehe FAQs). Die Anlage kann entweder im CIO Cockpit-Webfrontend oder im Datacollection-Management (empfohlen) durchgeführt werden.

Folgende Komponeten werden im CIO Cockpit abgebildet:

  • VCenter als Hypervisor im CIO Cockpit
  • Cluster der VCenter als VCluster im CIO Cockpit
  • Hosts der Cluster als Compute-Hardware-Assets im CIO Cockpit
  • VMs der Cluster als VMs im CIO Cockpit

Neuanlage im Datacollection-Management (empfohlen)

Das Datacollection-Management verfügt über eine Discovery-Funktionalität. Diese bietet dem Nutzer eine weitestgehend automatische Anlage der Komponenten eines VCenters im CIO Cockpit. Anleitung:

  1. Quick-Start -> Vendor: VMWare, Product: VCenter auswählen
  2. Unterhalb der Auswahl erscheint unter "Use existing element" die Schaltfläche "Start Autodiscovery instead". Diese Schaltfläche auswählen.
  3. VCenter-Hostnamen eintragen. Die Erreichbarkeit des VCenters wird geprüft. Falls es erreichbar ist, Usernamen und Passwort eintragen. Falls die Einträge Username und Passwort nicht erscheinen, kann das VCenter nicht gefunden werden. In diesem Fall ist zu prüfen, ob der Hostname korrekt ist und ob die Konnektivität zum VCenter durch das Netzwerk per HTTPS besteht.
  4. In der gleichen Ansicht unter "Core Link" "Create new" auswählen und einen Namen vergeben.
  5. In der folgenden Ansicht kann der Cluster ausgewählt werden, der angelegt werden soll. Außerdem werden alle Hosts, die diesem Cluster zugeordnet sind, als Compute-Hardware-Assets angelegt.
  6. In der folgenden Ansicht den Standort des VCenters unter "Location" auswählen.
  7. "Save" speichert die Konfiguration. Die Anlage der Datensammlung ist beendet.

Konfiguration für bestehendes System im Datacollection-Management

Falls das VCenter im CIO Cockpit bereits angelegt ist und die Datensammlung nachträglich konfiguriert werden soll, sind folgende Schritte durchzuführen.

  1. Quick-Start -> Vendor: VMWare, Product: VCenter auswählen
  2. Unterhalb der Auswahl unter "Use existing element" die Auswahl "Select the desired entity Type". Hier "Virtualization Cluster" auswählen. Ein Klick auf die "Select"-Schaltfläche eines bereits erstellten Clusters führt zu einem Formular, in dem die Datensammlung für einen Cluster konfiguriert wird.
  3. Hostnamen, Usernamen und Passwort des VCenters eintragen, zu dem der Cluster gehört. Dieses VCenter außerdem unter "Cockpit VCenter reference" auswählen.
  4. Nach dem Klick auf Schaltfläche "Add Cluster Configuration" öffnet sich ein Popup, in dem der Cluster, der im CIO Cockpit angelegt wird, auf Korrektheit geprüft werden kann. Außerdem kann ein VSAN-Asset definiert werden, das diesem Cluster zugeordnet wird. Das VSAN-Asset ist ein generisches Storage-Asset, das über VSAN angebundenen Storage eines VClusters abbildet. Falls kein VSAN genutzt wird, muss hier auch nichts eingetragen werden.
  5. "Save" speichert die Konfiguration. Die Anlage der Datensammlung ist beendet.

Neuanlage im CIO Cockpit-Webfrontend

Falls die VCenter-Komponenten im CIO Cockpit-Webfrontend angelegt werden, wird damit die Datensammlung noch nicht konfiguriert. Daher muss für die Datensammlung der Punkt "Konfiguration für bestehendes System im Datacollection-Management" anschließend durchlaufen werden.

  1. Für jeden Host im VCenter: Konfiguration -> Assets -> Hinzufügen, dort das Formular ausfüllen. Als Assetname muss exakt der Name gewählt werden, der dem Host im VcCenter zugeordnet ist. Unter Hersteller, Typ, Produkt muss VMWare -> Virtualization -> ESXi ausgewählt werden. "Speichern" beendet das Anlegen pro Host.
  2. Falls VSAN genutzt wird, muss außerdem für jeden Cluster, bei dem dies der Fall ist, ein Storage-Asset unter Konfiguration -> Assets -> Hinzufügen angelegt werden.
  3. Für jeden Cluster im VCenter: Konfiguration -> Virtualisierung -> vCluster -> Hinzufügen und im sich öffnenden Popup die vorher eingetragenen Hosts markieren, die diesem Cluster zugeordnet sind. Falls vorher ein Storage-Asset für VSAN eingerichtet wurde, muss dieser unter "Speichersystem" ausgewählt werden. Die Zuordnung von Hosts und Speichersystemen ist exklusiv. Das heißt, dass ein Host und Speichersystem maximal einem Cluster zugewiesen werden kann.
  4. Konfiguration -> Virtualization -> Instanzen -> Hinzufügen und im sich öffnenden Popup die vorher eingetragenen Cluster markieren

Umfang der Datacollection

LicenseJob

Datacollection pro vCenter

Der CIO Cockpit VMWare Datacollector unterstützt die Datensammlung sowohl von vCentern, die in einem Single-Sign-On Modus verbunden sind, als auch von Standalone-vCentern. Lizenzen werden pro vCenter gemäß folgenden Regeln abgeholt.

  • Lizenzen, die weder auf dem aktuellen, noch auf einem anderen vCenter ein Assignment haben, werden mit Usage = 0 ausgegeben.
  • Lizenzen, die ausschließlich Assignments auf andere vCenter haben, werden ignoriert (Diese Lizenzen werden den anderen vCentern zugeordnet).
  • Für Lizenzen, die Assignments auf dem aktuellen vCenter und anderen vCentern haben, werden die Assignments auf anderen vCentern ignoriert (diese werden den anderen vCentern zugeordnet).
  • Dedizierte vRealize-Lizenzen und Product Evaluation-Lizenzen (mit Key 00000-00000-00000-00000-00000) werden ignoriert.

Durch die Datensammlung übermittelte KPIs

VM-Inventory

KPI Information
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)
clusterID Die CIO Cockpit-interne ID des Clusters
vCenterInstanceUUID Weltweit eindeutige ID des VCenters
vms Liste von VMs auf diesem Cluster (siehe unten)

VMs

KPI Information
externalID VCenter-interne ID der VM (Managed object ID)

VM-Usage

KPI Information
clusterID Die CIO Cockpit-interne ID des Clusters
externalID VCenter-interne ID der VM (Managed object ID)
isTemplate true, falls die VM ein Template ist, false sonst
name Vom VCenter-User vergebener Name der VM
powerState "poweredOn" falls eingeschaltet, "poweredOff" falls ausgeschaltet und "suspended" falls angehalten
ramProvisioned Größe des der VM zur Verfügung gestellten Arbeitsspeichers [B]
storageProvisioned Größe des der VM exklusiv zur Verfügung gestellten Festspeichers [B]
threads Anzahl von Threads, die der VM zugeordnet sind
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)
usages Liste von Nutzungsdaten dieser VM (siehe unten)
vCenterInstanceUUID Weltweit eindeutige ID des VCenters

VM-Nutzungsdaten

KPI Information
cpuClockUsed Menge der genutzten Rechenleistung [Hz]
ramUsed Menge des genutzten Arbeitsspeichers [B]
storageUsed Menge des genutzten Festspeichers [B]
timestamp Zeitstempel des Datenpunkts

Host-Inventory

KPI Information
hostName Der im VCenter durch den Nutzer vergebene Name des Hosts
hostType "computeHardware"
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)
Liste von RAM-Modulen Datensätze zur Beschreibung der im Host verbauten RAM-Module (siehe unten)
Liste von CPUs Datensätze zur Beschreibung der im Host verbauten CPUs (siehe unten)

RAM-Module

KPI Erläuterung
ramType Typ des Speichers (z.B. „DRAM“)
ramClock Nominelle Taktfrequenz des RAM-Moduls
ramSize Größe des verbauten RAM-Moduls

CPUs

KPI Erläuterung
cpuType Vom Hersteller definierter Bezeichner (z.B. „Intel Xeon E5-2609 @ 2.50 GHz“)
cpuThreads Anzahl der Threads der CPU
cpuCores Anzahl der CPU-Kerne in der CPU
cpuClock Die nominelle Taktfrequenz der CPU

Host-Usage

KPI Information
hostName Der im VCenter durch den Nutzer vergebene Name des Hosts
threads Summe aller verfügbaren Threads aller CPUs des Hosts
cpuClockCapacity Summe der leistbaren Taktfrequenz aller verfügbaren Cores aller CPUs des Hosts
ramCapacity Summe des gesamten Arbeitsspeichers des Assets
usages Liste von Nutzungsdaten dieses Hosts (siehe unten)
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)
uptime Zeit seit dem letzten Reboot in Sekunden
version Betriebssystem-Version
model Modellbezeichnung des Servers, z.B. „Cisco Systems Inc UCSB-B200-M3“

Host-Nutzungsdaten

KPI Information
cpuClockUsed Menge der genutzten Rechenleistung [Hz]
ramUsed Menge des genutzten Arbeitsspeichers [B]
timestamp Zeitstempel des Datenpunkts

Cluster-Usage

KPI Information
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)
clusterID Die CIO Cockpit-interne ID des Clusters
cpuClockCapacity Summe der leistbaren Taktfrequenz aller verfügbaren Cores aller CPUs aller Hosts des Clusters
ramCapacity Summe des gesamten Arbeitsspeichers aller Hosts des Assets
usages Liste von Nutzungsdaten dieses Clusters (siehe unten)

Cluster-Nutzungsdaten

KPI Information
cpuClockUsed Menge der genutzten Rechenleistung [Hz]
ramUsed Menge des genutzten Arbeitsspeichers [B]
timestamp Zeitstempel des Datenpunkts

VM-Storage

KPI Information
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)
clusterID Die CIO Cockpit-interne ID des Clusters
vCenterInstanceUUID Weltweit eindeutige ID des VCenters
dataStores Liste von VMFS(SAN)- und VSAN-Datenspeichern (siehe unten)
usages Liste von Festspeicher-Nutzungsdaten durch VMs (siehe unten)

Datenspeicher

KPI Information
dataStoreMOID VCenter-interne ID des Datenspeichers (Managed Object ID)
name Name des Datenspeichers
dataStoreBackings Liste von Datenspeicher-Backings (siehe unten)

Datenspeicher-Backings

KPI Information
ident VMFS(SAN)-Datenspeicher: WWN; VSAN-Datenspeicher: VCenter-UUID und Datenspeicher-MOID; NFS(NAS)-Datenspeicher: Remote-Host und Remote-Path

Festspeicher-Nutzungsdaten durch VMs

KPI Information
externalID VCenter-interne ID der VM (Managed object ID)
rawMappingDisks Liste von Raw Device Mappings, die diese VM nutzt (siehe unten)
usageOnDataStores Liste von Datenspeicher-Nutzungsdaten durch diese VM (siehe unten)

Datenspeicher-Nutzungsdaten durch VMs

KPI Information
dataStoreMOID VCenter-interne ID des Datastores (Managed object ID)
sizeProvisioned Maximal exklusiv nutzbarer Festspeicher auf diesem Datenspeicher
sizeUsed Aktueller exklusiv genutzter Speicher auf dem Datenspeicher
vscsiUids Liste eindeutiger IDs, falls der Datenspeicher ein VSCSI-Laufwerk ist

Raw Device Mappings

KPI Information
externalID NAA-Identifier (Eindeutiger Identifier innerhalb des VCenters für dieses Mapping)
ident WWN des vom Raw Device Mapping verwendeten storageExports

VSAN-Storage-Inventory

KPI Information
assetID Die CIO Cockpit-interne ID des Storage-Assets, das den VSAN-Speicher abbildet
disks Alle Disks, die dem VSAN-Speicher angehören (siehe unten)
pools Alle Pools, die für den VSAN-Speicher definiert sind (siehe unten)
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)

VSAN-Disks

KPI Information
type SAS (Capacity) oder EFD (Cache). Es werden keine NL-SAS-Disks ausgegeben.
capacity Speicherkapazität der Disk
count Anzahl der Disks mit der Konfiguration {type, capacity}

VSAN-Pools

KPI Information
name VCenter-UID und Datenspeicher-MOID
disks Liste aller Disks in diesem Pool (siehe unten)
storageExports Alle Exporte, die diesem Pool angehören (siehe unten)

Disks eines Pools

KPI Information
type SAS (Capacity) oder EFD (Cache). Es werden keine NL-SAS-Disks ausgegeben.
capacity Speicherkapazität der Disk
count Anzahl der Disks mit der Konfiguration {type, capacity} in diesem Pool

Exporte eines Pools

KPI Information
sizeCommissioned Exklusiv dem Export zugeteilte nutzbare Speicherkapazität
sizeUsed Nutzung des Exports auf dem VSAN-Storage-Asset (Bei Thin Provisioning der tatsächlich genutzte, bei Thick Provisioning der reservierte Speicherplatz)
id VCenter-UID und Datastore-MOID

VSAN-Storage-Usage

KPI Information
assetID Die CIO Cockpit-interne ID des Storage-Assets, das den VSAN-Speicher abbildet
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)
version VCenter-Version
storageCapacity Nettokapazität des VSAN-Datenspeichers
storageUsed Genutzter Speicher des Datenspeichers (Bei Thin Provisioning der tatsächlich genutzte, bei Thick Provisioning der reservierte Speicherplatz)

Licenses

KPI Information
timestamp Mikrosekundengenauer Zeitstempel des Host-Betriebssystems, auf dem der Datacollector läuft (UTC)
entityCollectionID Die CIO Cockpit-interne ID der Lizenzsammung des vCenters
licenses Inventar der Lizenzen; siehe unten

Lizenzen

KPI Information
name Name des lizenzierten Produkts
licenseKey Lizenzschlüssel
licenseType Kostenelement, nach dem lizenziert wird, z.B. pro Socket oder pro VM
used Anzahl aller in diesem vCenter genutzten Kostenelemente an dieser Lizenz
total Anzahl der maximal auf dieser Lizenz nutzbaren Kostenelemente an dieser Lizenz
usages Die Komponenten, von denen die Lizenz in diesem vCenter genutzt wird; siehe Lizenznutzung

Lizenznutzung

KPI Information
name Name des Kostenelements
used Anzahl der durch diese Komponente genutzten Kostenelemente

Troubleshooting

Keine aktuellen Daten in den Verlaufsgraphen bei Hosts und VClustern

Mögliche Ursache: Es werden keine Usage-Metriken gesammelt.

Analyse: Zur Analyse werden die Log-Dateien aus dem Support-Bundle im DCM herangezogen.

Falls es in den Log-Dateien folgende Fehlermeldung gibt, ist der Fehler bekannt und kann mit den untenstehenden Maßnahmen behoben werden.

could not retrieve counter map tuple. retrieved null or empty array for cluster

Lösung: Die Lösung wird von VMWare in einem Eintrag in der Knowledge Base ausführlich beschrieben. VMware Artikel

Kurzanleitung:

  1. Login per Webbrowser in den vSphere-Web-Client ein.
  2. Navigation zum vCenter-Server, dort "Manage"-Ansicht öffnen.
  3. Im "Settings"-Tab"Advanced Settings" öffnen
  4. "Advanced vCenter Server Setting": "Edit" auswählen
  5. Navigation zum Eintrag "config.vpxd.stats.maxQueryMetrics" oder - falls der Eintrag nicht vorhanden ist - diesen Eintrag anlegen. Der Wert muss auf 300 gesetzt werden. Bis die Änderung vom vCenter ohne einen Neustart übernommen wird, können einige Stunden vergehen.
Nach oben