Nutzlastausführung wird mithilfe der Identifizierungssimulation generiert und simuliert

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 6 Minuten Lesedauer
  • Die Identifizierungssimulation ist ein zentraler Ort für die automatische Erstellung einer Nutzlast, die garantiert vollständig und gültig ist. Sie können dann die Verarbeitung der Nutzlast durch die Identifizierungs- und Abgleichsmodul (Ire) simulieren und die Ergebnisse überprüfen, bevor Sie sie tatsächlich zur Ausführung durch Ire übermitteln.

    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, Identifizierungsregeln bei Bedarf anpassen und die Simulation der aktualisierten Nutzlast erneut ausführen.

    Verwenden Sie die Identifizierungssimulation, um:
    • Erstellen Sie automatisch eine Eingabenutzlast, die auf vorhandenen Identifizierungsregeln, Hosting- und Containment-Regeln basiert.
    • Simulieren Sie die Ausführung einer Nutzlast (automatisch durch Identifizierungssimulation erstellt oder manuell erstellt).
    • Durchsuchen Sie Nutzlastausgabe und Ausführungsprotokollnachrichten für eine simulierte Ausführung.
    Hinweis:
    • Die Identifizierungssimulation schreibt keine Updates für die CMDB fest.
    • Die Identifizierungssimulation unterstützt die Simulation von Verarbeitungsnutzlasten, die bereitgestellt werden und nicht-CMDB-Tabellen enthalten, unterstützt jedoch nicht die Generierung solcher Nutzlasten.

    Nutzlast mithilfe der Identifizierungssimulation automatisch generieren

    Verwenden Sie die Identifizierungssimulation, um automatisch eine Eingabenutzlast für eine angegebene Klasse zu erstellen. Die konstruierte Nutzlast ist vollständig mit allen erforderlichen abhängigen CIs, korrekt strukturiert und syntaktisch gültig für die Verarbeitung durch die Identifizierungs- und Abgleichs-Engine (Ire).

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Die Nutzlast, die während der Identifizierungssimulation erstellt wird, 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 Nutzlast 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/Abgleich, Und klicken Sie auf Identifizierungssimulation .
    2. In Beginnen Sie mit CI-Klasse Klicken Sie auf das Feld Starten .
    3. Auf Nutzlastinformationen Formular, in Datenquelle Feld die Datenquelle auswählen, die dieser Klassenaktualisierung zugeordnet ist.
      Wählen Sie für die ServiceNow-Discovery-Datenquelle aus ServiceNow .
    4. Wählen Sie aus Klasse In der Nutzlast.
      1. In Kriteriumsattribute Bereich Wählen Sie die CI-Bezeichnerattribute aus, und geben Sie dann die Werte an, die ein CI eindeutig identifizieren.
      2. In Zusätzliche Attribute Bereich Geben Sie Attribute und Werte an, mit denen übereinstimmende CIs aktualisiert werden.
    5. Füllen Sie für abhängige CIs, die abhängigen Identifizierungsregeln zugeordnet sind, aus Kriteriumsattribute Und Zusätzliche Attribute Abschnitte in allen Containerebene Angezeigte Abschnitte.
    6. Klicken Sie Auf Skript Generieren .
    7. Wenn Fehler darauf hindeuten, dass Felder fehlen, füllen Sie die fehlenden Felder aus, und klicken Sie dann auf Skript Generieren Erneut.

    Nächste Maßnahme

    • Klicken Sie Auf Führen Sie Die Simulation Aus Um die Verarbeitung der Nutzlast durch Ire zu simulieren.
    • Überprüfen Sie die Ergebnisse der Simulation, optimieren Sie die Nutzlast nach Bedarf, und kombinieren Sie sie nach Bedarf mit anderen Nutzlasten für andere Klassen. Verwenden Sie nach Abschluss der Nutzlast CreateOrUpdateCI() API zum Ausführen der Nutzlast nach Ire, was zu tatsächlichen Aktualisierungen der CMDB führt.
    • Klicken Sie Auf Skript Kopieren Zum Kopieren des JSON-Skripts in die Zwischenablage. Sie können dieses Skript dann in eine Drittanbietersoftware oder in einen anderen Bildschirm der Identifizierungssimulation einfügen.

    Simulieren Sie die Nutzlastverarbeitung mithilfe der Identifizierungssimulation

    Verwenden Sie die Identifizierungssimulation, um den Identifizierungs- und Abgleichsmodul-Prozess (Ire) der CI-Identifizierung für eine Eingabenutzlast zu simulieren. Geben Sie eine gültige Nutzlast an, die mithilfe einer Identifizierungssimulation erstellt oder manuell erstellt wurde.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > Konfiguration > Identifikation/Abgleich, Und klicken Sie auf Identifizierungssimulation .
    2. Wahlweise: So führen Sie eine Simulation einer vorhandenen Nutzlast aus:
      1. Klicken Sie Auf Starten In Beginnen Sie mit vorhandener Nutzlast Kachel.
      2. Wählen Sie auf der Seite „JSON-Nutzlast einfügen“ die aus Datenquelle Das dieser Klassenaktualisierung zugeordnet ist.
      3. Wahlweise: Wählen Sie Aus Erweiterte Identifizierung Verwenden Zum Anwenden von IdentifyCIErweitert API für erweiterte CI-Identifizierung, anstatt die identifyCI-API zu verwenden.
      4. Fügen Sie die JSON-Nutzlast in die leere Canvas ein.
    3. Wahlweise: Klicken Sie zum Erstellen einer neuen Nutzlast auf Starten In Beginnen Sie mit CI-Klasse Kachel.
    4. Klicken Sie Auf Führen Sie Die Simulation Aus Um die Verarbeitung der Nutzlast durch Ire zu simulieren.

    Nächste Maßnahme

    1. Überprüfen Sie die Ergebnisse der Simulation im Ergebnisbereich, und optimieren Sie die Nutzlast nach Bedarf:
      1. Klicken Sie Auf Führen Sie Nr. 1 Aus Um anzuzeigen Kontext-ID Und Ausführungs-ID Der simulierten Ausführung.
      2. Klicken Sie auf den Dropdown-Pfeil neben Führen Sie Nr. 1 Aus Zum Anzeigen zusätzlicher Details.
        • Eingabe : Zeigt die Nutzlast 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 Abschluss der Nutzlast CreateOrUpdateCI() API zum Ausführen der Nutzlast nach Ire, was zu tatsächlichen Aktualisierungen der CMDB führt.

    Legen Sie die Protokollierungsstufe für die Identifizierungssimulation fest

    Die Identifizierungssimulation protokolliert jeden Schritt einer simulierten Nutzlastverarbeitung. Sie können diese Ausführungsprotokolle dann überprüfen, um festzustellen, ob eine Nutzlast wie erwartet verarbeitet wurde und ob Identifizierungsregeln effektiv sind. Sie können die Protokollierungsstufe anpassen, damit sie hilfreich ist und die Anzahl der Nachrichten nicht übermäßig oder unzureichend ist.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > Konfiguration > Identifikation/Abgleich, Und klicken Sie auf Identifizierungssimulation .
    2. Klicken Sie auf Einstellungen Symbol.
    3. Wählen Sie unter die Protokollierungsebene für die Identifizierungs- und Abgleichsmodul (Ire) aus IE-Protokollebene Und für den Servicecache unter Servicecache-Protokollebene .
      Die Protokollierungsebenen werden in aufsteigender Reihenfolge angezeigt, von der minimalen Ebene bis zur maximalen Protokollierungsebene.
    4. Klicken Sie auf Einstellungen Symbol zum Schließen von erneut Einstellungen Dialogfeld.

    Überprüfen Sie die Ausführungsprotokolle

    Die Identifizierungssimulation stellt Ausführungsprotokolle bereit, die von der Identifizierungs- und Abgleichsmodul (Ire) generiert werden. Sie können für Nutzlastausführungen, zur Untersuchung von Ergebnissen und zu Debugging-Zwecken auf diese Ausführungsprotokolle zugreifen. Ausgabeprotokolle der Ire-Nutzlast werden in einem anwenderfreundlichen Format auf einer zentralen Seite angezeigt.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Auch interne Anwendungen, die Ire verwenden (z. B. Discovery) Kann eine interne API aufrufen, um eine URL zum Anzeigen von Ire-Ausführungsprotokollen bereitzustellen.

    Die Protokollierung erfolgt im Kontext einer bestimmten Ausführung der Identifizierungs-Engine, und 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, gruppiert nach Kontext-IDs und Ausführungszeiten. Sie können verwenden glide.identification_logs.max_run_ids Eigenschaft zum Ändern des Grenzwerts von 1000.

    Sie können die Protokollierungsebene mit steuern glide.discovery.identification.log_levelDiscovery-Systemeigenschaft und Festlegen des Werts auf eine der folgenden Optionen:
    • Info
    • 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 Klassenbezeichnern erkennt, wird die Nutzlast abgelehnt, und die Verarbeitung wird beendet.

    Prozedur

    1. Navigieren zu Alle > Konfiguration > Identifikation/Abgleich > Identifizierungsprotokollean.
    2. Filtern Sie die Ausführungsliste 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.
      Die Wird Ausgeführt In der Liste werden alle Ausführungen für die angegebene Datenquelle während des angegebenen Zeitbereichs angezeigt.
    3. In Wird Ausgeführt Liste, klicken Sie auf A Ausführungs-Nr. Um anzuzeigen Kontext-ID Und Ausführungs-ID .
      Jeder spezifischen Nutzlast, die ausgeführt wird, ist eine eindeutige Kontext-ID zugeordnet. Jede Ausführung dieser Nutzlast ist einer eindeutigen Ausführungs-ID zugeordnet. Eine einzelne Kontext-ID für eine Nutzlast, die mehrmals ausgeführt wird, ist mehreren Ausführungs-IDs zugeordnet.
    4. Klicken Sie auf den Dropdown-Pfeil für ein Ausführungs-Nr. Zum Anzeigen zusätzlicher Details.
      • Eingabe : Zeigt die Nutzlast für die Ausführung an.
      • Protokolle : Zeigt alle protokollierten Nachrichten an, die die Identifizierungs-Engine während der Ausführung der Nutzlast generiert hat, gemäß der angegebenen Protokollierungsebene.
      • Ausgabe : Zeigt die von der Identifizierungs-Engine zurückgegebene Ausgabenutzlast an.