Konfigurieren Sie einen anwenderdefinierten Ereignis-Connector

Authentifizieren Sie Ihren anwenderdefinierten Ereignis-Connector als Datenquelle, um die Übertragung von Ereignisinformationen an Ihren zu ermöglichen ServiceNow Instanz. Definieren Sie den anwenderdefinierten Connector, indem Sie seine Details und Zuordnungsfelder angeben. Dadurch können die extrahierten Informationen aus den Ereignisnachrichten Ihres anwenderdefinierten Connectors die erforderlichen Ereignisfelder ausfüllen. Erstellen Sie abschließend eine URL für den anwenderdefinierten Connector-Webhook, und geben Sie sie an.

Vorbereitungen

• Stellen Sie sicher, dass Ereignismanagement Plugin „Connectors“ (sn_em_Connector) ist auf installiert ServiceNow AI Platform Instanz. Weitere Informationen finden Sie unter Konfigurieren Ereignismanagement Connectors.
• Stellen Sie sicher, dass die Konfigurationselemente für die von Ihrem anwenderdefinierten Connector verwalteten Hosts in vorhanden sind ServiceNow AI Platform Instanz. Diese CIs können physisch oder virtuell sein und entweder manuell erstellt oder mittels IP-Erkennung oder Cloud-Discovery erkannt werden. Weitere Informationen finden Sie unter Auf Cloud-Umgebungen für ITOM-Produkte zugreifen.

Erforderliche Rolle: evt_mgmt_admin

Warum und wann dieser Vorgang ausgeführt wird

Um mit der Übertragung von Ereignisinformationen an Ihren zu beginnen ServiceNow-Instanz müssen Sie festlegen ServiceNow AI Platform Instanz als REST-Endpunkt mit einem Standard-Webhook in Ihrem anwenderdefinierten Connector.

Indem Sie Connector-Details und Zuordnungsfelder bereitstellen, definieren Sie den anwenderdefinierten Connector. Die extrahierten Informationen aus den Ereignisnachrichten des anwenderdefinierten Connectors füllen dann die erforderlichen Ereignisfelder aus und fügen das Ereignis in die Datenbank ein.

Die URL wird vom Code basierend auf generiert ServiceNow Instanz und der anwenderdefinierte Connector. Verwenden Sie diese URL, um einen Webhook zu erstellen, mit dem Ihr anwenderdefinierter Connector Ereignisse an den senden kann ServiceNow Instanz.

Prozedur

1. Navigieren zu Arbeitsbereiche > Service Operations-Arbeitsbereichan.
2. Wählen Sie im linken Bereich das Symbol Integrations Launchpad: .
3. In Integrationen Durchsuchen Wählen Sie die Registerkarte aus Alle Integrationen Dropdown-Liste, und wählen Sie aus Anwenderdefiniert .
   Nur anwenderdefinierte Connector-Kacheln werden angezeigt.

   Abbildung : 1. Push-Connectors

   

4. Wählen Sie eine Kachel vom anwenderdefinierten Connector-Typ aus.
5. Auf der Geben Sie Details an Seite, geben Sie die Details für den Connector an.

   Abbildung : 2. Detailseite für anwenderdefinierte Connectors

   

   1. In Connector-Name Geben Sie einen eindeutigen Integrationsnamen für den Connector ein.
   2. Wahlweise: In Tags Geben Sie Tags ein, um Connectors dieses Typs im zu finden und zu identifizieren Express-Liste.
      Um zusätzliche Tags hinzuzufügen, wählen Sie das Plus-Symbol ( ) Neben Tags Feld. Das Fenster Tags hinzufügen wird geöffnet.

      1. In Schlüssel Feld einen Tag-Schlüssel eingeben.
      2. In Wert Feld einen Tag-Wert eingeben.
      3. Wählen Sie Hinzufügen.
   3. Wahlweise: In Beschreibung Geben Sie kurze Informationen zu diesem Connector ein.
   4. In Quelle Geben Sie den Lieferanten ein, der zum Sammeln von Ereignissen aus der externen Ereignisquelle verwendet wird.

      Die Quelle Feld identifiziert den Connector und dient als Bezeichner, um die Quelle von Ereignissen und Warnungen zu erkennen, sobald der Connector aktiv ist.

   5. Wahlweise: Von Zuweisungsgruppe Wählen Sie in der Dropdown-Liste die Gruppe oder das Team aus, die bzw. das für die Verwaltung und Wartung des Connectors verantwortlich ist.
6. Wahlweise: Ziehen Sie ein Bild, oder laden Sie es hoch, um es in Ihrer Connector-Kachel anzuzeigen.
   • Ziehen Sie ein Bild in das Feld.
   • Navigieren Sie zur Bilddatei, indem Sie auswählen Bild hochladen Und wählen Sie dann die Datei aus.
   Die maximale Größe der Upload-Datei beträgt 1 MB.
7. Legen Sie fest, ob Sie Ereignisse direkt mit verbinden möchten ITOM Instanz oder über ein MID-Server.

   • Zum Senden von Ereignissen direkt an ITOM Instanz, wählen Sie aus Direkt zur ITOM-Instanz .

   • Zum Senden von Ereignissen über einen MID-Server, Das das Ereignis verarbeitet und dann an die Instanz übergibt, wählen Sie aus Über den MID-Server .

     Wenn ein MID-Server Ist vorhanden, aus Wählen Sie MID-Server aus Wählen Sie ein verfügbares Feld aus MID-Server Mit einem Ereignis-Listener verbunden.

     Wenn Sie erstellen müssen MID-Server, Und wählen Sie dann eine der folgenden Optionen aus.

     • MID-Webservererweiterung konfigurieren
     • MID-Webservice-Ereignis konfigurieren – Collector-Kontext

     Weitere Informationen finden Sie unter MID-Webserver erweiterung konfigurieren und MID-WebService-Event-Sammlerkontext konfigurieren.
8. Wählen Sie Weiter.

   

9. Auf der Richten Sie die Eingabemethode ein Wählen Sie eine Methode zum Sammeln von Ereignisdaten aus.

   Methode	Beschreibung
   Sammeln Sie echte Quellereignisse, um Felder zu definieren	Wählen Sie Aus Erfassen Sie echte Quellereignisse, um Felder zu definieren . Hinweis: Indem Sie Ereignisse aus echten Quellen aus Ihrem anwenderdefinierten Connector erfassen, erhöhen Sie die Genauigkeit von Ereignissen und Warnungen, indem Sie mehrere Ereignisse als Referenz zum Definieren der Felder verwenden. Wählen Sie Aus In Zwischenablage kopieren Und kopieren Sie die URL. Fügen Sie die URL in das Webhook-Setup Ihres anwenderdefinierten Connectors ein, um einen Webhook zu erstellen, mit dem Ihr anwenderdefinierter Connector Ereignisse an senden kann ServiceNow Instanz. Geben Sie Ihre Anmeldeinformationen für die Standardauthentifizierung in die Webhook-Konfiguration des Überwachungssystems ein (z. B. Anwendername und Passwort). Mit dem Webhook kann Ihr anwenderdefinierter Connector Ereignisse an die Instanz senden. Wählen Sie Aus Überprüfen Sie auf Ereignisse . Die Anzahl der Ereignisse wird angezeigt. Das Ereignis erstellt JSON-Dateien, die Sie nach der Auswahl durchsuchen können Als Nächstes .
   JSON-Beispiel für die Zuordnung von Feldern verwenden	Wählen Sie Aus Verwenden Sie ein JSON-Beispiel, um Felder zuzuordnen . Hinweis: Wählen Sie diese Option nur aus, wenn Sie ein Beispiel-JSON haben. In Geben Sie die Nutzlast ein Dialogfeld kopieren und fügen Sie Ihre JSON-Beispielnutzlast ein, um die Zuordnung zu erstellen und anzuzeigen, um die Felder zuzuordnen. Wählen Sie Aus JSON hochladen . Wählen Sie Aus Bearbeiten oder fügen Sie neues JSON ein Zum Bearbeiten der JSON, die Sie hochgeladen haben, oder zum Einfügen einer neuen. Wählen Sie Aus In Zwischenablage kopieren Und kopieren Sie die URL. Fügen Sie die URL in das Webhook-Setup Ihres anwenderdefinierten Connectors ein, um einen Webhook zu erstellen, mit dem Ihr anwenderdefinierter Connector Ereignisse an senden kann ServiceNow Instanz. Geben Sie Ihre Anmeldeinformationen für die Standardauthentifizierung in die Webhook-Konfiguration des Überwachungssystems ein (z. B. Anwendername und Passwort). Mit dem Webhook kann Ihr anwenderdefinierter Connector Ereignisse an die Instanz senden.

10. Wählen Sie Weiter.
    Die Seite wird geöffnet, auf der Sie Felder zuordnen können.

    

11. Auf der Felder zuordnen Seite geben Sie in der Spalte Connector-Feldnamen mindestens einen Wert ein, der den in aufgeführten Schweregradwerten zugeordnet ist ServiceNow Schweregrad Feldspalte.
12. Auf der Felder zuordnen Seite geben Sie in der Spalte Connector-Feldnamen mindestens einen Wert ein, der den in aufgeführten Schweregradwerten zugeordnet ist ServiceNow Schweregrad Feldspalte.

    Sie können den Schweregradwert aus dem JSON-Codebeispiel eingeben. Um einen Schweregradwert festzulegen, müssen Sie mit der Nutzlast Ihres anwenderdefinierten Connectors und den Typen des unterstützten Schweregrads vertraut sein. Die Schweregradwerte der empfangenen Ereignisse müssen mit den generierten Ereignissen in Ihrem System übereinstimmen.

    Aktivieren Sie das System, Ereignisse korrekt aus eingehenden Daten zu erstellen, indem Sie die Felder in Ihrem JSON-Codebeispiel dem zuordnen ServiceNow Felder. Die Schweregrad Und Nachrichtenschlüssel Informationen werden automatisch ausgefüllt, um Zeit und Aufwand zu sparen. Die Nachrichtenschlüssel Stellt den richtigen Bezeichner für die Ereignisse bereit, um sicherzustellen, dass die Deduplizierung ordnungsgemäß funktioniert und keine redundanten Warnungen generiert werden.

13. Wahlweise: Um mehrere JSON-Dateien anzuzeigen, wählen Sie den Pfeil über dem JSON-Beispiel aus.
14. Wahlweise: Im Abschnitt „andere Felder“ in Ihr Connector Spalte: Geben Sie anwenderdefinierte Ereignisparameter an, die optional sind, aber zusätzliche Informationen zum Ereignis bereitstellen.
    Wenn Sie die optionalen Informationen nicht angeben möchten, lassen Sie das Feld leer.
    1. In Beschreibung Feld eine aussagekräftige Warnungsbeschreibung eingeben.
    2. In Metrikname Geben Sie einen Metriknamen ein, mit dem Sie Ereignisse den Leistungsmetriken oder KPIs zuordnen können, die die Warnung ausgelöst haben.
    3. In Knoten Feld einen Knotenwert eingeben, der für die CI-Bindung verwendet werden soll.
    4. In Ereigniszeit Geben Sie die Erstellungszeit des anwenderdefinierten Connector-Ereignisses ein.
       Wenn die Ereigniszeit nicht zugeordnet ist, verwendet das System die standardmäßige Ereigniszeit.
    5. In Einstellungen für Ereigniszeit Feld das Zeitformat und die Ereigniszeitzone auswählen.
       • Zeitformat : Ein GlideDateTime-Feld im UTC- oder GMT-Format mit einer maximalen Länge von 40 Zeichen.
       • Zeitzone : Zeiten werden in Coordinated Universal Time (UTC) gespeichert und global basierend auf der Systemzeitzone angezeigt.
15. Aktivieren und speichern Sie den Connector, indem Sie auswählen Aktivieren Und wählen Sie dann aus OK Im Bestätigungs-Popup-Fenster.
    Sie können die Connector-Details in anzeigen Details Registerkarte und Ihre Feldzuordnungen auf der Feldzuordnung Registerkarte.

Ergebnisse

Nachdem der Connector aktiviert wurde, werden Ereignisse von Ihrer anwenderdefinierten Connector-Konsole in die übertragen ServiceNow Instanz. Das Plugin extrahiert Informationen aus der ursprünglichen anwenderdefinierten Connector-Ereignisnachricht, um die erforderlichen Ereignisfelder auszufüllen, und fügt das Ereignis in die Datenbank ein. Um die Ereignisse in anzuzeigen ServiceNow AI Platform Instanz, navigieren Sie zu alle Ereignisse. Weitere Informationen finden Sie unter Events anzeigen.

Nächste Maßnahme

Um sicherzustellen, dass der Prozess erfolgreich abgeschlossen wurde und Ereignisse in das System fließen, zeigen Sie die zugehörigen Ereignisse im an Zugehörige Ereignisse Registerkarte. Wenn das Setup erfolgreich ist, fahren Sie mit fort Fügen Sie Automatisierung hinzu Dient zum Einrichten einer Warnungsautomatisierung. Informationen zur Warnungsautomatisierung finden Sie unter Warnungsautomatisierung in Service Operations-Arbeitsbereich Für ITOM.