Ereignisse an einen REST-Webservice weiterleiten

Sie können Lenovo XClarity Orchestrator für die Weiterleitung bestimmter Ereignisse an einen REST-Webservice konfigurieren.

Vorbereitende Schritte

Achtung

Bei der Weiterleitung von Daten an diesen Service wird keine sichere Verbindung hergestellt. Die Daten werden über ein Klartextprotokoll gesendet.

Zu dieser Aufgabe

Wenn die ressourcenbasierte Zugriffssteuerung aktiviert ist, werden nur für die Ressourcen Daten weitergeleitet, auf die Sie über Zugriffssteuerungslisten zugreifen können. Wenn Sie keiner Gruppe angehören, der die vordefinierte Rolle Supervisor zugewiesen ist, müssen Sie den von Ihnen erstellten Weiterleitungen eine oder mehrere Zugriffssteuerungslisten zuweisen. Wenn Sie Daten für alle Ressourcen senden möchten, auf die Sie zugreifen können, wählen Sie alle Zugriffssteuerungslisten aus, die Ihnen zur Verfügung stehen. Wenn Sie einer Gruppe angehören, der die vordefinierte Rolle Supervisor zugewiesen ist, können Sie Daten für alle Ressourcen senden oder Zugriffssteuerungslisten zuweisen, um die Ressourcen einzuschränken.

Gängige Filter für die Datenweiterleitung werden verwendet, um den Umfang der weiterzuleitenden Ereignisse anhand von Ereigniscodes, Ereignisklassen, Ereignisschweregraden, Servicetypen und Ressourcen zu definieren, die das Ereignis generiert haben. Stellen Sie sicher, dass die Ereignis‑ und Ressourcenfilter, die Sie für diesen Weiterleiter verwenden möchten, bereits erstellt wurden (siehe Filter für die Datenweiterleitung erstellen).

Im folgenden Beispiel wird das Standardformat für Daten dargestellt, die zu einem REST-Webservice weitergeleitet werden. Worte in doppelten eckigen Klammern sind Attribute, die bei der Weiterleitung von Daten durch tatsächliche Werte ersetzt werden.

{\"msg\":\"[[EventMessage]]\",\"eventID\":\"[[EventID]]\",\"serialnum\":
\"[[EventSerialNumber]]\",\"senderUUID\":\"[[EventSenderUUID]]\",\"flags\":
\"[[EventFlags]]\",\"userid\":\"[[EventUserName]]\",\"localLogID\":
\"[[EventLocalLogID]]\",\"systemName\":\"[[DeviceFullPathName]]\",\"action\":
[[EventActionNumber]],\"failFRUNumbers\":\"[[EventFailFRUs]]\",\"severity\":
[[EventSeverityNumber]],\"sourceID\":\"[[EventSourceUUID]]\",
\"sourceLogSequence\":[[EventSourceLogSequenceNumber]],\"failFRUSNs\":
\"[[EventFailSerialNumbers]]\",\"failFRUUUIDs\":\"[[EventFailFRUUUIDs]]\",
\"eventClass\":[[EventClassNumber]],\"componentID\":\"[[EventComponentUUID]]\",
\"mtm\":\"[[EventMachineTypeModel]]\",\"msgID\":\"[[EventMessageID]]\",
"sequenceNumber\":\"[[EventSequenceID]]\",\"timeStamp\":\"[[EventTimeStamp]]\",
\"args\":[[EventMessageArguments]],\"service\":[[EventServiceNumber]],
\"commonEventID\":\"[[CommonEventID]]\",\"eventDate\":\"[[EventDate]]\"}"

Vorgehensweise

Gehen Sie wie folgt vor, um Daten an einen REST-Webservice weiterzuleiten.

Klicken Sie in der Menüleiste von XClarity Orchestrator auf Überwachung () > Weiterleitung und dann im linken Navigationsbereich auf Datenweiterleiter, um die Übersicht Datenweiterleiter anzuzeigen.
Klicken Sie auf das Symbol Erstellen (), um das Dialogfenster Datenweiterleiter erstellen anzuzeigen.
Geben Sie den Weiterleiternamen und optional eine Beschreibung ein.
Aktivieren oder deaktivieren Sie den Weiterleiter, indem Sie in der Spalte Status die Option zum Umschalten auswählen.
Wählen Sie REST als Weiterleitertyp aus.
Klicken Sie auf Konfiguration und geben Sie die protokollspezifischen Informationen ein.
- Geben Sie den Hostnamen oder die IP-Adresse des REST-Servers ein.
- Geben Sie den Port ein, der für die Ereignisweiterleitung verwendet werden soll. Der Standardwert ist 80.
- Geben Sie den Ressourcenpfad ein, auf dem der Weiterleiter die Ereignisse senden soll (z. B. /rest/test).
- Wählen Sie die REST-Methode aus. Es kann einen der folgenden Werte aufweisen.
  - PUT
  - POST
- Wählen Sie das Protokoll aus, das für die Ereignisweiterleitung verwendet werden soll. Es kann einen der folgenden Werte aufweisen.
  - HTTP
  - HTTPS
- Geben Sie den Timeout-Zeitraum (in Sekunden) für die Anforderung ein. Der Standardwert ist 30 Sekunden.
- Wenn eine Authentifizierung erforderlich ist, wählen Sie einen der folgenden Authentifizierungstypen aus.
  - Allgemein. Authentifiziert den angegebenen Server mithilfe der angegebenen Benutzer-ID und des Kennworts.
  - Token. Authentifiziert den angegebenen Server mithilfe des angegebenen Token-Header-Namens und ‑Werts.
Klicken Sie auf Filter und wählen Sie optional die Filter aus, die für diesen Weiterleiter verwendet werden sollen.
Sie können höchstens einen Ereignisfilter und einen Ressourcenfilter auswählen.
Wenn Sie keinen Filter auswählen, werden die Daten für alle Ereignisse weitergeleitet, die von allen Ressourcen generiert werden (Einheiten, Ressourcenmanager und XClarity Orchestrator).
Auf dieser Registerkarte können Sie auch ausgeschlossene Ereignisse weiterleiten, indem Sie die Umschalt-Schaltfläche Ausgeschlossene Ereignisse auf Ja setzen.
Klicken Sie auf Zugriffssteuerungslisten und wählen Sie eine oder mehrere Zugriffssteuerungslisten aus, die diesem Weiterleiter zugeordnet werden sollen.
Wenn der ressourcenbasierte Zugriff aktiviert ist, müssen Sie mindestens eine Zugriffssteuerungsliste auswählen.
Tipp
Benutzer, die einer Gruppe angehören, der die vordefinierte Rolle Supervisor zugewiesen ist, können optional Alles abgleichen auswählen, anstatt eine Zugriffssteuerungsliste auszuwählen, sodass weitergeleitete Daten nicht eingeschränkt sind.
Klicken Sie auf Erstellen, um den Weiterleiter zu erstellen.

Nach dieser Aufgabe

In der Übersicht Datenweiterleiter können Sie die folgenden Aktionen ausführen.

Aktivieren oder deaktivieren Sie einen ausgewählten Weiterleiter, indem Sie in der Spalte Status die Option zum Umschalten wählen.
Ändern Sie einen ausgewählten Weiterleiter, indem Sie auf das Symbol Bearbeiten () klicken.
Entfernen Sie einen ausgewählten Weiterleiter, indem Sie auf das Symbol Löschen () klicken.

Feedback geben