Aktivieren Sie die Integration mit einem benutzerdefinierten Connector

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 6 Minuten Lesedauer

    • Integrieren Sie den benutzerdefinierten Connector mit Ereignismanagement, indem Sie in der benutzerdefinierten Connector-Konsole einen Standard-Webhook hinzufügen. Richten Sie den benutzerdefinierten Connector ein, indem Sie den angezeigten URL-Wert in die Zwischenablage kopieren und damit den Webhook in der benutzerdefinierten Connector-Konsole konfigurieren.

    Vorbereitungen

    Stellen Sie sicher, dass das Plugin Ereignismanagement „ Connectors“ (sn_em_connector) in der Instanz Now Platform installiert ist.

    Stellen Sie sicher, dass Konfigurationselemente für die von Ihrem benutzerdefinierten Connector verwalteten Hosts in der Instanz Now Platform vorhanden sind. Diese CIs können physisch oder virtuell sein und entweder manuell erstellt oder mittels IP-Erkennung oder Cloud-Discovery erkannt werden.

    Erforderliche Rolle: evt_mgmt_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Konfigurieren Sie die Umgebung Ereignismanagement für die Erfassung von Events von Ihrem benutzerdefinierten Connector, indem Sie den benutzerdefinierten Connector als Datenquelle authentifizieren. Legen Sie in Ihrer benutzerdefinierten Connector-Konsole Ihre Now Platform -Instanz mithilfe eines Standard-Webhooks als REST-Endpunkt fest.

    Prozedur

    1. Wählen Sie auf der Registerkarte Integrationen durchsuchen die Dropdown-Liste Alle Integrationen und dann Benutzerdefiniertaus.
    2. Wählen Sie eine benutzerdefinierte Connector-Kachel aus.
    3. Geben Sie auf der Seite Details angeben die Details für den Connector an.
      1. Geben Sie im Feld Connector-Name einen eindeutigen, aussagekräftigen Integrationsnamen für den Connector-Typ ein.
      2. Wahlweise: Geben Sie im Feld Beschreibung Informationen zur Identifizierung dieses Connector-Typs ein.
      3. Wahlweise: Wählen Sie in der Dropdown-Liste Zuweisungsgruppe den Datensatz aus der Zuweisungsgruppentabelle aus, die die Zuweisungsgruppe des Connector enthält.
      4. Geben Sie im Feld Quelle den Lieferanten und das Protokoll ein, die zum Sammeln von Events aus der externen Event-Quelle verwendet werden.

        Diese Informationen werden als Bezeichner verwendet, um Events zu erkennen und die Quelle von Events und Warnungen leicht zu erkennen, nachdem der Connector aktiv ist.

    4. Wahlweise: Legen Sie Tags fest, die Events hinzugefügt werden sollen, um zu markieren und Connectors dieses Typs zu identifizieren und ihre Warnungen in Express-Listezu überwachen.
      1. Wählen Sie neben dem Feld Tags das Pluszeichen aus.
      2. Geben Sie im Popup-Menü einen Tag-Schlüssel und einen Wert ein.
      3. Wählen Sie Hinzufügen.
    5. Wahlweise: Ziehen Sie ein Logo aus Ihrem System , oder laden Sie es hoch, um es in Ihrer Connector-Kachel anzuzeigen.
      • Ziehen Sie ein Bild in das Feld.
      • Wählen Sie Bild hochladen aus, und wählen Sie das Bild aus Ihrem Dateisystem aus.
      Die maximale Upload-Dateigröße beträgt 1 MB.
    6. Legen Sie fest, ob Sie Events direkt mit der ITOM-Instanz oder über einen MID Serververbinden möchten.
      • Um s-End-Events an die ITOM -Instanz ] zu senden, wählen Sie Direkt zur ITOM-Instanz aus.
      • Um Events über einen MID-Server zu senden, der die Event-Nachricht verarbeitet und das Event dann an die Instanz übergibt, wählen SieÜber den MID-Serveraus.

        Wenn der MID Server vorhanden ist, wählen Sie ihn aus den verfügbaren MID Servern aus, die mit einem Events-Listener verbunden sind. Wenn Sie einen MID Server erstellen müssen, konfigurieren Sie die MID Web Server-Erweiterung oder den MID Web Service Event Collector Context. Weitere Informationen finden Sie unter MID-Webservererweiterung konfigurieren und MID-WebService-Event-Sammlerkontext konfigurieren.

    7. Wählen Sie Weiter.
    8. Wählen Sie eine Methode zum Sammeln von Event-Daten aus.
      Wenn Sie ein Live-System zum Streamen von Events haben, wählen Sie Echte Quell-Events sammeln, um Felder zu definieren. Wenn Sie ein JSON-Beispiel haben, wählen Sie JSON-Beispiel zum Zuordnen von Feldern verwenden aus.
      MethodeBeschreibung
      Sammeln Sie echte Quell-Events, um Felder zu definieren
      1. Wählen Sie Echte Quell-Events sammeln aus, um Felder zu definieren und die Genauigkeit von Events und Warnungen zu erhöhen, indem Sie mehrere Events als Referenz verwenden.
      2. Wählen Sie In Zwischenablage kopieren aus, und kopieren Sie die URL.
      3. Fügen Sie die URL in Ihr Webhook-Setup ein, um einen Webhook zu erstellen, der es Ihrem Drittanbieter-Connector ermöglicht, Events an die Instanz ServiceNow zu senden. Durch das Sammeln von Events aus echten Quellen von Ihrem Drittanbieter-Connector erhöhen Sie die Genauigkeit von Events und Warnungen, indem Sie mehrere Events als Referenz zum Definieren der Felder verwenden.
      4. Wählen Sie Nach Events suchen aus. JSON-Dateien werden erstellt.
      JSON-Beispiel für die Zuordnung von Feldern verwenden
      1. Wählen Sie JSON-Beispiel zum Zuordnen von Feldern verwenden aus.
      2. Kopieren Sie im Dialogfeld Payload eingeben eine JSON-Beispielnutzlast, und fügen Sie sie ein, um die Zuordnung zum Zuordnen der Felder zu erstellen und anzuzeigen.
      3. Wählen Sie JSON hochladen aus.
      4. Wählen Sie Bearbeiten oder neue JSON einfügen, um die hochgeladene JSON zu bearbeiten oder eine neue einzufügen.
    9. Wählen Sie Weiter.
    10. Aktivieren Sie auf der Seite „Zuordnungsfelder“ das System, um Events für die eingehenden Daten korrekt zu erstellen, indem Sie die Felder in Ihrem JSON-Codebeispiel den ServiceNow-Feldern zuordnen.
      1. Kopieren Sie das JSON-Codebeispiel aus Ihrer benutzerdefinierten Connector-JSON-Nutzlast, und fügen Sie es in das JSON-Codebeispiel aus der Spalte custom_test ein.
        Die Informationen zum Schweregrad und zum Nachrichtenschlüssel werden automatisch ausgefüllt, um Zeit und Aufwand zu sparen. Der Nachrichtenschlüssel stellt den korrekten Bezeichner der Events bereit, damit die Deduplizierung ordnungsgemäß funktioniert und keine redundanten Warnungen generiert werden, z. B.
      2. Geben Sie in der Spalte Connector-Feldnamen mindestens einen einzelnen Wert ein, der den Schweregradwerten entspricht, die in der Spalte ServiceNow für das Feld Schweregrad aufgeführt sind.

        Sie können den Schweregradwert aus dem JSON-Codebeispiel eingeben. Um einen Schweregradwert festzulegen, müssen Sie mit der Nutzlast Ihres Drittanbieter-Connectors und den vom Connector unterstützten Schweregradtypen vertraut sein. Die Schweregradwerte der empfangenen Events müssen mit den generierten Events in Ihrem System übereinstimmen.

    11. Wählen Sie Weiter aus, und speichernSie.
    12. Kopieren Sie im Bildschirm Push-Connector einrichten den automatisch generierten URL-Parameterwert in die Zwischenablage, indem Sie In Zwischenablage kopierenauswählen.
    13. Wahlweise: Geben Sie im Abschnitt „ Andere Felder “ in Ihrer Connector-Spalte Ereignisparameter von Drittparteien an, die nicht erforderlich sind, aber zusätzliche Informationen zum Ereignis bereitstellen.
      Wenn Sie die optionalen Informationen nicht angeben möchten, lassen Sie das Feld leer.
      1. Geben Sie im Feld Beschreibung eine aussagekräftige Warnungsbeschreibung ein.
      2. Geben Sie im Feld Metrikname den Namen einer Metrik ein, mit der [] es [ ermöglicht, Events den Leistungsmetriken oder KPIs zuzuordnen, die die Warnung ausgelöst haben.
      3. Geben Sie im Feld Knoten einen Knotenwert ein, der für die CI-Bindung verwendet werden soll.
      4. Geben Sie im Feld Event-Zeit die Erstellungszeit des Drittanbieter-Events ein.
        Wenn die Event-Zeit nicht zugeordnet ist, verwendet das System die Standard-Event-Zeit.
      5. Wählen Sie im Feld Event -Zeiteinstellungen das Zeitformat und die Event-Zeitzone aus.
        • 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.
    14. Wählen Sie Weiter.
    15. Wählen Sie im Bildschirm „Connector einrichten“ im Feld URL-Parameterwert die Option In Zwischenablage kopieren aus, um den automatisch generierten URL-Parameterwert in die Zwischenablage zu kopieren.
    16. Fügen Sie die URL in Ihr Webhook-Setup ein, und geben Sie Ihre Anmeldeinformationen für die Basic Authentication in die Webhook-Konfiguration des Überwachungssystems ein (z. B. Benutzername und Passwort).

      Mit dem Webhook kann Ihr Drittanbieter-Connector Events an die Instanz ServiceNow senden.

    17. Aktivieren und speichern Sie den Connector, indem Sie Aktivieren und dann OK im Popup-Fenster zur Bestätigung auswählen.
      Sie können die Connector-Details auf der Registerkarte „ Details “ und Ihre Feldzuordnungen auf der Registerkarte „Feldzuordnung“ anzeigen.
    18. Wahlweise: Vergewissern Sie sich, dass der Prozess erfolgreich abgeschlossen wurde und Events in das System einfließen, indem Sie die Registerkarte Zugehörige Events auswählen und die zugehörigen Events anzeigen.

    Ergebnisse

    Nachdem der Connector aktiviert wurde, werden -Events von Ihrer benutzerdefinierten Connector-Konsole in die Instanz ServiceNow übertragen. Das Plugin extrahiert Informationen aus der ursprünglichen benutzerdefinierten Connector-Event-Nachricht, um die erforderlichen Event-Felder auszufüllen, und fügt das Event in die Datenbank ein. Um die Events in Ihrer Instanz Now Platform anzuzeigen, navigieren Sie zu Alle Events. Weitere Informationen finden Sie unter Events anzeigen.

    Nächste Maßnahme

    Um eine Warnungsautomatisierung zu erstellen, wählen Sie Automatisierung hinzufügenaus. Weitere Informationen finden Sie unter . Die Quelle und die Zuweisungsgruppe werden in der Warnungsautomatisierung automatisch ausgefüllt.