Sie können benutzerdefinierte Skripts in der Zielmaschine ausführen und benutzerdefinierte Daten erfassen, die dann als Metrik verwendet werden können.
Vorbedingungen
- Alle Skripts, die Sie mit dem benutzerdefinierten Skript ausführen, müssen einen einzelnen ganzzahligen Wert ausgeben. Wenn die Ausgabe kein einzelner ganzzahliger Wert ist, wird in der Benutzeroberfläche ein Fehler angezeigt.
- Das benutzerdefinierte Skript verwendet das exec-Plug-in von Telegraf, um Skripts auf dem Betriebssystem einer Zielmaschine auszuführen. In Linux-Betriebssystemen wird ein spezieller Benutzer mit dem Namen arcuser und mit Sonderberechtigungen für die Installation des Telegraf-Agenten erstellt. Das exec-Plug-in führt deshalb Skripts unter Verwendung dieses arcuser-Benutzers aus. Stellen Sie sicher, dass der arcuser die Skripts, die das benutzerdefinierte Skript verwenden, ausführen kann (der arcuser muss über die Berechtigungen zum Ausführen des Skripts verfügen). Der arcuser, der automatisch vom Cloud-Proxy erstellt wurde, hat zum Beispiel keine Berechtigungen zum Ausführen von Skripts, die im /root-Verzeichnis gespeichert sind.
- In Windows-Betriebssystemen wird ein Systembenutzer für die Installation des Telegraf-Agenten verwendet. Das exec-Plug-In führt die Skripts deshalb unter Verwendung dieses Systembenutzers aus. Stellen Sie sicher, dass der Systembenutzer über Berechtigungen verfügt und das benutzerdefinierte Skript ausführen kann.
- Das Skript muss im Ordner /opt/vmware abgelegt sein.
- Die Umgebungsvariable PATH muss festgelegt werden, damit PowerShell-Skripts auf dem Windows-Betriebssystem ausgeführt werden können, wenn der Benutzer das Präfix powershell -File verwendet hat. Beispielsweise "%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\" in der Umgebungsvariable PATH.
So führen Sie benutzerdefinierte Skripts aus
- Filtern Sie auf der Registerkarte Telegraf-Agents verwalten nach .
- Erweitern Sie den Dropdown-Pfeil für die Zielmaschine, auf der der Agent installiert ist. Der Abschnitt Benutzerdefinierte Überwachung wird angezeigt.
- Klicken Sie für die Option Benutzerdefiniertes Skript auf die vertikale Ellipse und dann auf Hinzufügen.
- Im Dialogfeld Benutzerdefinierten Dienst verwalten können Sie die zu überwachenden Windows-Dienste hinzufügen und konfigurieren.
Instanzeinstellungen
| Option | Beschreibung |
|---|---|
| Status | Aktivieren Sie die Ausführung des benutzerdefinierten Skripts. |
| Anzeigename | Geben Sie einen geeigneten Namen für das Skript an. * ist ein ungültiges Zeichen und darf nicht im Namen verwendet werden. |
| Dateipfad | Geben Sie den Pfad zur Skriptdatei auf der Zielmaschine ein. Beispiel:
Für Linux-Maschinen:
/opt/vmware/scripts/customscript.pyFür Windows-Maschinen: c:\scripts\customscript.ps1 |
| Präfix | Geben Sie bei Bedarf ein Präfix ein. Beispiel: Für Linux-Maschinen: python2.7, /bin/bash oder perl usw. Für Windows-Maschinen: powershell -File |
| Args | Führen Sie die Argumente im Skript auf. |
| Zeitüberschreitung | Legen Sie eine Zeitüberschreitung für die Ausführung des Skripts auf der VM fest. |
Nachdem Sie das Skript gespeichert haben, wird es unter Benutzerdefiniertes Skript angezeigt. Sie können Skripts bearbeiten oder löschen, indem Sie über die vertikale Ellipse für das von Ihnen hinzugefügte benutzerdefinierte Skript auf die Optionen Bearbeiten oder Löschen klicken. Nachdem die Skripts hinzugefügt und gespeichert wurden, klicken Sie auf den Dropdown-Pfeil neben Benutzerdefiniertes Skript, um die Liste der Skripts und deren Status anzuzeigen.
- Das benutzerdefinierte Skript muss alle Fehler im Format ERROR|<Error_message> ausgeben, damit die Fehlerpropagierung funktioniert. Wenn das Skript einen Fehler nicht in diesem Format ausgibt, zeigt VMware Aria Operations in der Benutzeroberfläche die folgende Fehlermeldung an: Unable to parse the error message. Please check the endpoint. Dies ist so vorgesehen, bis der Cloud-Proxy die genaue Fehlermeldung weitergibt.
- Das Bash-Skript muss mit
shebang (#!/bin/bash)beginnen.
Registerkarte „Alle Metriken“
Wenn Daten erfolgreich erfasst werden, können Sie das Skript auf der Registerkarte Alle Metriken als Metrik für die Zielmaschine anzeigen. Die Skript-Metriken werden in einem Objekt mit dem Namen Benutzerdefiniertes Skript erstellt (ein einzelnes Objekt pro Zielmaschine). Alle Metriken der Skripts für die Zielmaschine werden in diesem Objekt vom Typ Benutzerdefiniertes Skript abgelegt, das alle von Ihnen erstellten benutzerdefinierten Skripts enthält. Sie können die Ausgabe für die spezifische Metrik anzeigen. Der Metrik-Name in dem Ordner Skripts ist der Anzeigename, den der Benutzer beim Erstellen der Skriptkonfiguration angibt. Wenn Sie beispielsweise für den Anzeigenamen Python-Skript angegeben haben, wird eine Metrik mit dem Namen Python-Skript erstellt, wenn Daten erfolgreich gesammelt werden.
