Protokolldetails für klassischen Datenerfasser

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 6 Minuten Lesedauer
  • Performance Analytics Die Punktzahlerfassung folgt dem hier beschriebenen Prozess. Zur Unterstützung der Fehlerbehebung wird eine Zuordnung zwischen Auftragsschritten und Protokolleinträgen bereitgestellt.

    Sammlungsübersicht

    Die Datenerfassungsaufgabe umfasst das Ausführen einer SQL-Abfrage für jede Indikatorquelle, die den Datensammler verwendet. Die Abfrage wird für jede Sammlungszeit vom Startdatum bis zum Enddatum wiederholt. Anschließend werden Abfragen für die nächste Indikatorquelle ausgeführt. Jeder Schritt zum Ausführen der Abfrage ist im Datensammlungsprotokoll dokumentiert.
    Abbildung : 1. Allgemeine Ansicht des Datensammlungsauftrags
    Flow-Diagramm, das die Beziehung zwischen den verschiedenen Ebenen von Prozessen in einem Datensammlungsauftrag anzeigt

    Optimierungseigenschaften, die im Protokoll angezeigt werden

    Der Datenerfasser verfügt über mehrere Optimierungen, die in den Systemeigenschaften aktiviert oder deaktiviert werden können. Der Anfang des Auftragsprotokolls enthält den Status dieser Eigenschaften.

    Hinweis:
    Verwechseln Sie diese Optimierungseigenschaften nicht mit dem neuen, optimierten Datenerfasser. Diese Eigenschaften gelten nur für den klassischen Datenerfasser. Der neue Datenerfasser ist auf einer grundlegenderen Ebene optimiert.
    Tabelle : 1. Eigenschaften der Datensammlungsoptimierung
    Optimierung Beschreibung Systemeigenschaft
    Geschachtelte Sammlung Ersetzt flache Zuordnung, um redundante Objekte zu reduzieren. Anstatt beispielsweise identische Indikatorobjekte für jede Aufgliederung und jedes Element für diesen Indikator zu erstellen, wird für den Indikator nur ein Objekt erstellt. com.snc.pa.dc.nested_collection

    Standardwert: wahr

    Leeren Sie Snapshots

    Die ServiceNow AI Platform Speichert eine maximale Anzahl von Performance Analytics SnapshotsIm Arbeitsspeicher, bevor sie in die Datenbank entladen werden.

    com.snc.pa.dc.flush_snapshot_count

    Standardwert: 1000

    Verwenden Sie Hashcode für eindeutige Anzahl Speichert die Anzahl eindeutiger Zusammenfassungen als Hashcode anstelle von separaten Werten. com.snc.pa.dc.use_hashcode_for_distinct

    Standardwert: wahr

    Sammlungsauftrag starten und schließen

    Befolgen Sie den Datenerfassungsprozess, wie in Protokollnachrichten angezeigt. Die Protokollnachrichten in jedem Subprozess wurden in ihre eigenen Tabellen getrennt.

    Hinweis:
    Dieses Protokoll gilt für den ursprünglichen Datenerfasser. Wenn Ihre Instanz diesen Datenerfasser verwendet, der Systemparameter com.snc.pa.dc.hsqlIst vorhanden und ist „falsch“. Andernfalls verwenden Sie den optimierten Datenerfasser wie unter beschrieben Datenerfassung wird optimiert. Weitere Informationen zu diesem Protokoll finden Sie unter Protokolldetails für optimierten Datenerfasser.
    Schritt des Sammlungsauftrags Beispiel für den resultierenden Protokolleintrag
    Zeigt die Domäne des Sammlungsauftrags „Als Benutzer ausführen“ an. Benutzer <Administrator> gehört zu Domäne „Global“
    Sammlung wird gestartet. Der Auftragsstart gibt an, ob Punktzahlen, Textverzeichnis oder beides erfasst werden soll. Nachrichten geben auch die Einstellungen der Optimierungseigenschaften der Datensammlung an. Sammlung von Punktzahlen und Textindex wird gestartet. Wert von Eigenschaften im System –

    Snapshot-Anzahl Leeren: 1.000

    Ist geschachtelte Sammlung: Wahr

    Hashcode für eindeutige Anzahl wird verwendet: Wahr

    Zeigt die Domänen an, für die Punktzahlen gesammelt werden. Zeigt auch andere relevante Details zu den Domänen an. DomainConfig: Testing Domain Config Collection logs - 3d359877b77000106886e664de11a97c, Type: conditions, RollUpType: roll_up_children, collectAggregate? Yes, collectChildren?: Yes, AggregateDomain: Name: 3d359877b77000106886e664de11a97c - SysID: d1659c77b77000106886e664de11a91e, Domains: Default,MSP,ACME,Cisco,Initech,Oceanic Airlines
    Listet Indikatorquellen auf, für die der Auftrag Daten sammelt, einschließlich ihrer eindeutigen IDs. Zu erfassende Indikatorquellen: Incidents.Neu: B54f2c23d7030100b96d45a3ce61032f, Incidents.Offen: B5cf2c23d7030100b96d45a3ce6103cc, Incidents.Geschlossen: 2ac8dd31ff2302001e68ffffffffffffffffffff3d, Incidents.gelöst: 4c23d70d70b9630103c23a3c23d70103c23d45103c3cc
    Listet jeden Indikator auf, der dem Auftrag zugeordnet ist, sowie die Indikatoreigenschaften, die sich auf die Datensammlung beziehen:
    • Werden Datensätze in einem Snapshot erfasst?
    • Werden Aufgliederungen ausgeschlossen?
    • Werden die Sammlungszeiträume in der Indikatorquelle überschrieben?
    • Wird die Aufgliederungsmatrix erfasst?
    • Werden bei der Erfassung der Aufgliederungsmatrix Aufgliederungskombinationen ausgeschlossen?
    JobIndicator: Anzahl der offenen Incidents – de537dc3d7131100b96d45a3ce610305 Auftragsindikatoreigenschaften: CollectIndicator?: Ja, BreakdownCollectionType: WITH_EXCLUDE Excluded Aufgliederungen: Zuweisungsgruppe, Statusindikatoreigenschaften => CollectRecords: Ja, überschriebene Sammlungszeiträume: Nein, Skripted?: Nein, Aufgliederungskombinationen?: Ja, Ausgeschlossene Aufgliederungskombinationen?: Ja, keine Kombination ist ausgeschlossen.
    Iterationsschritte für jede Indikatorquelle Siehe Tabelle Iterationsschritte für jede Indikatorquelle.
    Statistiken für den Datensammlungsauftrag anzeigen Statistiken: Einfügungen 184, Aktualisierungen 0, Löschungen 92, Fehler 0, Warnungen 0
    Auftrag abschließen Datensammlung beendet

    Iterationsschritte für jede Indikatorquelle

    Schritt des Sammlungsauftrags Beispiel für den resultierenden Protokolleintrag
    Indikatorquelle abrufen Indikatorquelle Incidents.Open wird verarbeitet...
    Listenindikatoren mit zusätzlichen Bedingungen, die über die von der Indikatorquelle geerbten Bedingungen hinausgehen. Indikator: Anzahl neu zugewiesener offener Incidents – ffb59561ff2302001e68ffffffffff33, zusätzliche Bedingungen: reassignment_count>0
    Gibt an, ob die Punktzahlerfassung der geschachtelten Datenstruktur folgt, anstatt eine flache Zuordnung zu verwenden. Geschachtelte Sammlung erstellt weniger redundante Objekte im Arbeitsspeicher.

    Die nicht geschachtelte Sammlung unterstützt die Batchverarbeitung von Punktzahlen.

    Verschachtelte Sammlung wird verwendet.

    Hinweis: Batch-Einfügungen von Punktzahlen werden mit geschachtelter Sammlung nicht unterstützt.

    Iterationsschritte für jeden Erfassungszeitraum. Siehe Tabelle Iterationsschritte für jeden Erfassungszeitraum
    Nächste Indikatorquelle abrufen Indikatorquelle Incidents.New wird verarbeitet

    Iterationsschritte für jeden Erfassungszeitraum

    Schritt des Sammlungsauftrags Beispiel für den resultierenden Protokolleintrag
    Startdatum der Sammelaufgabe Erfassung für 20191103 für Indikatorquellen-Incidents.Offen
    Rufen Sie die folgenden Felder ab:
    • Die eindeutigen Felder der Aufgliederungsquellen (normalerweise sys_ID)
    • Die Indikatorfelder, die in Aufgliederungszuordnungen verwendet werden
    • Die Tabellenfelder, die in geskripteten Aufgliederungszuordnungen verwendet werden
    • Die in Text Analytics verwendeten Indikatorquellenfelder, wenn der Textindex erfasst wird (enthält normalerweise „short_description“)
    „short_description,sys_id, opened_at, assignment_group, description, priority, category" wird von "incident“ abgerufen
    Generieren von SQL basierend auf den Bedingungen, die in der Indikatorquelle angegeben sind.
    Hinweis:
    Wenn die Indikatorquelle „Heute“ in einer der Bedingungen angibt, wird „Heute“ relativ zu dem Zeitraum betrachtet, für den die Datenerfassungsaufgabe ausgeführt wird. Beispielsweise enthält die Indikatorquelle Incidents.New die Bedingung [Geöffnet][am][Heute]. Wenn die Tage so definiert sind, dass sie um 07:00:00 beginnen, und Daten für 2019-10-28 gesammelt werden, erzeugt der Auftrag das SQL-Skript auf der rechten Seite.
    SELECT task0.`sys_id` FROM task task0 WHERE task0.`sys_class_name` = 'incident' AND (task0.`opened_at` >= '2019-10-28 07:00:00' AND task0.`opened_at` <= '2019-10-29 06:59:59')
    Zeigen Sie die Anzahl der von SQL abgerufenen Datensätze an. 150 Zeilen aus Indikatorquelle „Incidents.Offen“ abgerufen (Faktentabelle: Incident)
    Zuordnungs-/Reduzierungsfunktion ausführen, um Indikatorpunktzahlen zu berechnen. Siehe Tabellen Schritte der Zuordnungs-/Reduzierungsfunktion
    Wenn die Textindizierung aktiv ist und für die Indikatorquelle konfiguriert wurde, speichert der Datensammler den resultierenden Textindex. Textindex für Indikatorquelle Incidents.Open wird gespeichert
    Von Textindex verwendete Bytes: 41,984 für: Incidents.Open
    Beginnen Sie mit dem Speichern neu gesammelter Ergebnisse für die Indikatorquelle. Zu speichernde Punktzahlen: 374.842 (mit Ausnahme der verzögerten Anzahl eindeutiger Punktzahlen der Ebene 2 für Indikatoren – ID – alle Incidents mit allen 3 Aufgliederungen)
    Jeder Indikator mit einem NULL-Wert wird protokolliert. „Wert, wenn null“ gespeichert: 0,0 als Punktzahl für Indikator: Anzahl der durch Wissen vermiedenen Incidents
    Speichern der Ergebnisse abschließen. Gespeicherte Punktzahlen: 1.125.057
    Gespeicherte gesammelte Ergebnisse
    Festlegen für welche Indikatoren der Datensammler keine Punktzahlen sammelt. Nicht sammeln für Indikator: Summe des Alters der offenen Incidents mit ausgeschlossener Aufgliederung: Zuweisungsgruppe
    Beenden der Datensammlung für diese Indikatorquelle für diesen Zeitraum. Sammlung für 20200519 für Indikatorquellen-Incidents.Offen abgeschlossen
    Zeigen Sie die durchschnittliche Zeit an, die für einen Datensatz aufgewendet wurde, um zusätzliche Bedingungen zu verarbeiten, die für Indikatoren festgelegt wurden. Durchschnittliche Zeit, die für die Verarbeitung zusätzlicher Indikatorbedingungen für jeden Datensatz benötigt wird: 138 ms

    Schritte der Zuordnungs-/Reduzierungsfunktion

    Schritt des Sammlungsauftrags Beispiel für den resultierenden Protokolleintrag
    Die Zuordnungs-/Reduzierungsfunktion wird ausgeführt. Zuordnungs-/Reduzierungsfunktion wird für Indikatorquelle Incidents.Open angewendet ...
    Warnung, wenn die Textindizierung für den Auftrag aktiv ist, aber aufgrund einer fehlenden oder ungültigen Textindikatorkonfiguration nicht ausgeführt werden kann. Textindexsammlung wird übersprungen, da eine Textindexkonfiguration fehl oder ungültig ist
    Löschen früherer Punktzahlen für die Indikatoren und Aufgliederungen, die die Indikatorquelle verwenden. Vorherige Ergebnisse für die Indikatorquelle Incidents.Open werden gelöscht ...
    Vorherige Ergebnisse 38 für Indikator gelöscht: Externe Anmeldungen
    Vorherige Ergebnisse 21 für Indikator gelöscht: Fehlgeschlagene Anmeldungen
    Verarbeiten Sie jeden Datensatz in der Indikatorquelle, um Punktzahlen zu berechnen. Protokollnachrichten verfolgen die laufende Gesamtzahl der verarbeiteten Datensätze und die Arbeitsspeichernutzung. Die Verarbeitung für jeden Datensatz umfasst:
    • Führen Sie Skripts aus, oder bewerten Sie sie.
    • Indikatorbedingungen validieren
    • Indikatorwert berechnen
    • Für jede Aufgliederung:
      1. Berechnen der Aufgliederungs-Punktzahl oder Ausführen des Aufgliederungs-Skripts.
      2. Ermitteln aller eindeutigen Aufgliederungswerte.
      3. Erstellen oder aktualisieren des Array für Punktzahlen oder Snapshots. Das Array ist: Indikator, Aufgliederung 1, Artefakt 1, Aufgliederung 2, Artefakt 2, Domäne, Wert, Array von [sys_ID]
    18% % (1) Datensätze verarbeitet, Größe des Ergebnisobjekts: 5 MB
    Verarbeitet 42% (2) Datensätze, Ergebnisobjektgröße: 9 MB
    Verarbeitet 76% (3) Datensätze, Größe des Ergebnisobjekts: 14 MB
    Verarbeitet 100% (4) Datensätze, Größe des Ergebnisobjekts: 20 MB
    Die Zuordnungs-/Reduzierungsfunktion wird abgeschlossen. Angewendete Zuordnungs-/Reduzierungsfunktion