Generieren und Simulieren der Nutzlastausführung mithilfe der Identifizierungssimulation

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 6 Minuten Lesedauer
  • Die Identifikationssimulation ist ein zentraler Ort für die automatische Erstellung einer garantierten Vollständigkeit und Gültigkeit der Nutzdaten. Anschließend können Sie die Verarbeitung der Nutzlast durch die Engine für Identifizierung und Abgleich (Identification and Reconciliation Engine, IRE) simulieren und die Ergebnisse überprüfen, bevor Sie sie tatsächlich zur Ausführung durch IRE senden.

    Verwenden Sie die Identifizierungssimulation, um eine Eingabenutzlast zu erstellen und die Verarbeitung der Nutzlast durch IRE zu simulieren. Sie können dann die Ergebnisse überprüfen, gegebenenfalls die Identifikationsregeln anpassen und die Simulation der aktualisierten Payload erneut ausführen.

    Verwenden Sie die Identifizierungssimulation zu folgenden Zwecken:
    • Automatisches Erstellen von Eingabe-Payloads, die auf vorhandenen Identifizierungsregeln, Hosting- und Containment-Regeln basieren.
    • Simulieren der Ausführung einer Payload (die automatisch durch Identifikationssimulation oder manuell erstellt wurde)
    • Durchsuchen von Payload-Ausgabe und Ausführungsprotokollnachrichten nach einer simulierten Ausführung
    Hinweis:
    • Die Identifikationssimulation bestätigt keine Aktualisierungen an der CMDB.
    • Die Identifizierungssimulation unterstützt die Simulation der Verarbeitung von Nutzlasten, die bereitgestellt werden und Nicht-CMDB-Tabellen enthalten, unterstützt jedoch nicht die Generierung solcher Nutzlasten.

    Payloads automatisch mithilfe der Identifikationssimulation generieren

    Verwenden Sie die Identifikationssimulation, um automatisch eine Eingabe-Payload für eine angegebene Klasse zu erstellen. Die erstellte Nutzlast ist vollständig mit allen erforderlichen abhängigen CIs, korrekt strukturiert und syntaktisch gültig für die Verarbeitung durch die Identification and Reconciliation Engine (IRE).

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Die während der Identifikationssimulation erstellte Payload gilt für die angegebene Klasse. Für eine abhängige CI-Klasse werden Sie aufgefordert, Informationen zu allen Abhängigkeiten einzugeben. Nachdem Sie die erforderlichen Details angegeben haben, erstellt die Identifizierungssimulation die Payload basierend auf Ihrer Eingabe.

    Hinweis:
    Das automatische Generieren von Nutzlasten, die Nicht-CMDB-Tabellen enthalten, wird nicht unterstützt.

    Prozedur

    1. Navigieren zu Alle > Konfiguration > Identifikation/Abgleichund klicken Sie auf Identifizierungssimulation.
    2. Klicken Sie im Kasten Mit CI-Klasse beginnen auf Start.
    3. Wählen Sie im Formular „Nutzlastinformationen“ im Feld Datenquelle die Datenquelle aus, die dieser Klassenaktualisierung zugeordnet ist.
      Wählen Sie für die ServiceNow Discovery-Datenquelle ServiceNow aus.
    4. Wählen Sie die Klasse in der Payload aus.
      1. Wählen Sie im Bereich Kriteriumsattribute die CI-Identifier-Attribute aus, und geben Sie dann die Werte an, die ein CI eindeutig identifizieren.
      2. Geben Sie im Bereich Zusätzliche Attribute Attribute und Werte an, mit denen übereinstimmende CIs aktualisiert werden.
    5. Füllen Sie für abhängige CIs, die abhängigen Identifikationsregeln zugeordnet sind, die Abschnitte Kriterienattribute und Zusätzliche Attribute in allen angezeigten Abschnitten Containerebene aus.
    6. Klicken Sie auf Skript generieren.
    7. Wenn Fehler darauf hinweisen, dass Felder fehlen, füllen Sie die fehlenden Felder aus, und klicken Sie dann erneut auf Skript generieren.

    Nächste Maßnahme

    • Klicken Sie auf Simulation ausführen, um die Verarbeitung der Nutzlast durch IRE zu simulieren.
    • Untersuchen Sie die Ergebnisse der Simulation, passen Sie die Payload nach Bedarf an, und kombinieren Sie sie nach Bedarf mit anderen Payloads für andere Klassen. Verwenden Sie nach dem Finalisieren der Nutzlast die API „createOrUpdateCI()“, um die Nutzlast über IRE auszuführen. Dies führt zu tatsächlichen Aktualisierungen der CMDB.
    • Klicken Sie auf Skript kopieren, um das JSON-Skript in die Zwischenablage zu kopieren. Sie können dieses Skript dann in eine Drittanbietersoftware oder in einen anderen Bildschirm der Identifizierungssimulation einfügen.

    Payload-Verarbeitung mithilfe der Identifikationssimulation simulieren

    Verwenden Sie die Identifizierungssimulation, um den IRE-Prozess (Identification and Reconciliation Engine) der CI-Identifizierung für eine Eingabenutzlast zu simulieren. Geben Sie eine gültige Payload an, die mithilfe der Identifikationssimulation oder manuell erstellt wurde.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > Konfiguration > Identifikation/Abgleichund klicken Sie auf Identifizierungssimulation.
    2. Wahlweise: So führen Sie eine Simulation einer vorhandenen Nutzlast aus:
      1. Klicken Sie auf der Kachel Mit der vorhandenen Nutzlast beginnen auf Start.
      2. Wählen Sie auf der Seite „JSON-Nutzlast einfügen“ die Datenquelle aus, die dieser Klassenaktualisierung zugeordnet ist.
      3. Wahlweise: Wählen Sie Erweiterte Identifizierung verwenden aus, um die identifizierte CIErweiterte API für die erweiterte CI-Identifizierung anzuwenden, anstatt die Identifizierungs-API zu verwenden.
      4. Fügen Sie die JSON-Payload in das leere Canvas ein.
    3. Wahlweise: Um eine neue Nutzlast zu erstellen, klicken Sie auf der Kachel Startwith CI Class (Mit CI-Klasse beginnen).
    4. Klicken Sie auf Simulation ausführen, um die Verarbeitung der Nutzlast durch IRE zu simulieren.

    Nächste Maßnahme

    1. Untersuchen Sie die Ergebnisse der Simulation im Ergebnisbereich, und passen Sie die Payload nach Bedarf an:
      1. Klicken Sie auf Ausführung Nr. 1, um die Kontext-ID und die Ausführungs-ID der simulierten Ausführung anzuzeigen.
      2. Klicken Sie auf den Dropdown-Pfeil neben Ausführung Nr. 1, um zusätzliche Details anzuzeigen.
        • Eingabe: Zeigt die Payload für die Simulation an.
        • Protokolle: Zeigt alle protokollierten Nachrichten an, die IRE während der Simulation der Verarbeitung der Nutzlast gemäß der angegebenen Protokollierungsebene generiert hat.
        • Ausgabe: Zeigt die von IRE zurückgegebene Ausgabenutzlast an.
    2. Verwenden Sie nach dem Finalisieren der Nutzlast die API „createOrUpdateCI()“, um die Nutzlast über IRE auszuführen. Dies führt zu tatsächlichen Aktualisierungen der CMDB.

    Protokollierungsebene für Identifikationssimulation festlegen

    Die Identifizierungssimulation protokolliert jeden Schritt einer simulierten Payload-Verarbeitung. Sie können diese Ausführungsprotokolle anschließend untersuchen, um festzustellen, ob eine Payload wie erwartet verarbeitet wurde und ob die Identifikationsregeln wirksam sind. Sie können die Protokollierungsebene so anpassen, dass sie hilfreich ist und die Anzahl der Meldungen nicht zu hoch oder zu gering ist.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > Konfiguration > Identifikation/Abgleichund klicken Sie auf Identifizierungssimulation.
    2. Klicken Sie auf das Symbol für Einstellungen.
    3. Wählen Sie die Protokollierungsebene für die Engine „Identifizierung und Abgleich“ (Identification and Reconciliation Engine, IRE) unter „IE-Protokollebene“ und für den Service-Cache unter „Service-Cache-Protokollebene“aus.
      Die Protokollierungsebenen werden in aufsteigender Reihenfolge angezeigt, von der minimalen bis zur maximalen Protokollierungsebene.
    4. Klicken Sie erneut auf das Symbol für Einstellungen, um das Dialogfeld Einstellungen zu schließen.

    Untersuchen Sie die Ausführungsprotokolle

    Die Identifizierungssimulation stellt Ausführungsprotokolle bereit, die von der Identification and Reconciliation Engine (IRE) generiert werden. Sie können auf diese Ausführungsprotokolle zugreifen, um Nutzlastausführungen auszuführen, die Ergebnisse zu überprüfen und Debugging-Zwecke durchzuführen. Ausgabeprotokolle für IRE-Nutzlast werden in einem anwenderfreundlichen Format auf einer zentralen Seite angezeigt.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Außerdem können interne Anwendungen, die IRE verwenden (z. B. Discovery), eine interne API aufrufen, um eine URL zum Anzeigen von IRE-Ausführungsprotokollen bereitzustellen.

    Die Protokollierung erfolgt im Zusammenhang mit einer bestimmten Ausführung der Identifizierungs-Engine. Sie können die Protokollliste nach einer bestimmten Datenquelle und einem bestimmten Zeitbereich filtern. Bis zu 1000 Ausführungsprotokolle, die bis zu 2 Monate alt sind, werden aufgelistet und nach Kontext-IDs und Laufzeiten gruppiert. Mit der Eigenschaft glide.identification_logs.max_run_ids können Sie das Limit von 1000 ändern.

    Sie können die Protokollierungsebene steuern, indem Sie die Systemeigenschaft Discovery glide.discovery.identification.log_level verwenden und den Wert auf einen der folgenden Werte festlegen:
    • Information
    • Warnen
    • Fehler
    • Debuggen
    • DebugVerbose
    • DebugObnoxious
    Hinweis:
    IRE führt eine erste Verifizierung einer Nutzlast durch, bevor Identifizierungsregeln verarbeitet werden. Wenn IRE doppelte CIs basierend auf einem Klassenbezeichner erkennt, wird die Nutzlast abgelehnt, und die Verarbeitung wird angehalten.

    Prozedur

    1. Navigieren zu Alle > Konfiguration > Identifikation/Ausgleich > Identifizierungsprotokolle.
    2. Filtern Sie die Liste der Ausführungen wie folgt:
      1. Quelle: Wählen Sie die Datenquelle aus, für die Ausführungsprotokolle angezeigt werden sollen.
      2. Zeitbereich: Geben Sie einen Zeitbereich an, für den Ausführungsprotokolle angezeigt werden sollen.
      In der Liste Ausführungen werden alle Ausführungen für die angegebene Datenquelle im angegebenen Zeitbereich angezeigt.
    3. Klicken Sie in der Liste Ausführungen auf eine Ausführungsnummer, um deren Kontext-ID und Ausführungs-ID anzuzeigen.
      Jeder ausgeführten Payload ist eine eindeutige Kontext-ID zugeordnet. Jede Ausführung dieser Payload ist mit einer eindeutigen Ausführungs-ID verknüpft. Eine einzelne Kontext-ID für eine Payload, die mehrmals ausgeführt wird, ist mehreren Ausführungs-IDs zugeordnet.
    4. Klicken Sie auf den Dropdown-Pfeil für eine Ausführungsnummer, um zusätzliche Details anzuzeigen.
      • Eingabe: Zeigt die Payload für die Ausführung an.
      • Protokolle: Zeigt alle protokollierten Meldungen an, die die Identifizierungs-Engine beim Ausführen der Payload entsprechend der angegebenen Protokollierungsebene generiert hat.
      • Ausgabe: Zeigt die von der Identifizierungs-Engine zurückgegebene Ausgaben-Payload an.