Konfigurieren Sie einen anwenderdefinierten Connector

Authentifizieren Sie Ihren anwenderdefinierten Connector als Datenquelle, um die Übertragung von Ereignisinformationen an Ihren zu ermöglichen ServiceNowInstanz. 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 EreignismanagementPlugin „Connectors“ (sn_em_Connector) ist auf installiert Now PlatformInstanz. Weitere Informationen finden Sie unter Konfigurieren EreignismanagementConnectors.
• Stellen Sie sicher, dass die Konfigurationselemente für die von Ihrem anwenderdefinierten Connector verwalteten Hosts in vorhanden sind Now PlatformInstanz. Diese CIs können physisch oder virtuell sein und entweder manuell erstellt oder über IP-Discovery oder erkannt werden Cloud-Discovery. Weitere Informationen finden Sie unter Zugriff auf Cloud-Umgebungen für ITOMProdukte.

Erforderliche Rolle: evt_mgmt_admin

Warum und wann dieser Vorgang ausgeführt wird

Um mit der Übertragung von Ereignisinformationen an zu beginnen ServiceNowInstanz, müssen Sie festlegen Now PlatformInstanz als REST-Endpunkt mit einem Standard-Webhook in Ihrem anwenderdefinierten Connector.

Indem Sie Connector-Details und Zuordnungsfelder angeben, 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 ServiceNowInstanz und anwenderdefinierter Connector. Verwenden Sie diese URL, um einen Webhook zu erstellen, mit dem Ihr anwenderdefinierter Connector Ereignisse an senden kann ServiceNowInstanz.

Prozedur

1. Navigieren zu Arbeitsbereiche > Service Operations-Arbeitsbereichan.
2. Wählen Sie im linken Bereich das Startpad-Symbol für Integrationen aus ( )
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 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 auf zu finden und zu identifizieren Express-Liste.
      Um zusätzliche Tags hinzuzufügen, wählen Sie das Plussymbol ( ) 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 ITOMInstanz oder über ein MID-Server.

   • Dient zum direkten Senden von Ereignissen an ITOMInstanz, wählen Sie aus Direkt zur ITOM-Instanz .

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

     Wenn ein MID-ServerIst vorhanden, von Wählen Sie den MID-Server aus Wählen Sie ein verfügbares Feld aus MID-ServerMit einem Ereignis-Listener verbunden.

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

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

     Weitere Informationen finden Sie unter Konfigurieren Sie MID-WebserverErweiterung und Konfigurieren des MID-WebService-Ereignissammlerkontexts.
8. Wählen Sie Weiter.

   

9. Auf 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 echte Quellereignisse aus Ihrem anwenderdefinierten Connector erfassen, erhöhen Sie die Genauigkeit von Ereignissen und Warnungen, indem Sie mehrere Ereignisse als Referenz verwenden, um die Felder zu definieren. 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 ServiceNowInstanz. 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, die angezeigt werden. Das Ereignis erstellt JSON-Dateien, die Sie nach der Auswahl durchsuchen können Weiter .
   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 eine 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 neue JSON ein Dient 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 ServiceNowInstanz. 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 Felder zuordnen Geben Sie in der Spalte Connector-Feldnamen mindestens einen Wert ein, der den in aufgeführten Schweregradwerten zugeordnet ist ServiceNow Schweregrad Feldspalte.
12. Auf Felder zuordnen 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, um Ereignisse korrekt aus eingehenden Daten zu erstellen, indem Sie die Felder in Ihrem JSON-Codebeispiel dem zuordnen ServiceNowFelder. 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 Geben Sie eine aussagekräftige Warnungsbeschreibung ein.
    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 Geben Sie einen Knotenwert ein, 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, wählen Sie das Zeitformat und die Ereigniszeitzone aus.
       • Zeitformat : Ein GlideDateTime-Feld im UTC- oder GMT-Format mit einer maximalen Länge von 40 Zeichen.
       • Zeitzone : Zeiten werden in koordinierter Weltzeit (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 auf anzeigen Details Registerkarte und Ihre Feldzuordnungen auf Feldzuordnung Registerkarte.

Ergebnisse

Nachdem der Connector aktiviert wurde, werden Ereignisse von Ihrer anwenderdefinierten Connector-Konsole in übertragen ServiceNowInstanz. 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 Now PlatformInstanz, navigieren Sie zu allen Ereignissen. Weitere Informationen finden Sie unter Zeigen Sie Ereignisse an.

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 auf 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-ArbeitsbereichFür ITOM.