Error Log Root Cause

Reduces SAP message logs (Migration Cockpit, SLG1, message tables) to their primary cause groups: causal graph over objects, parent hierarchy, message order and message roles, affected objects, exact source rows and fix order

Inhalt geprüft am 26. September 2026

Engine: SAP_LOG_CAUSAL_ANALYZER
Domäne: Operations
Version: 1.1.0
Ziel-Releases: S4H_2022, S4H_2023, S4HANA_CLOUD_2402, S4HANA_CLOUD_2408
Akzeptierte Formate: CSV, TEXT, JSON

Eingabevertrag

SAP message log export: Migration Cockpit message log (including the Fiori 'SAPUI5-Export' with Typ, Nachrichtentitel, Nachrichtenklasse, Nachrichtennummer, Datum und Uhrzeit), SLG1 application log or any message table as CSV / TSV / semicolon / pipe (ALV list) text with a header row containing a message type column (Type, Msg Type, Typ, Meldungstyp, MSGTY) and a message class + number (ID / Message Class / Nachrichtenklasse / Arbeitsgebiet + Number / No. / Nummer) or a combined message column (Message: 'CNIF_PI 076'); optional object (Instance, Object Key, Source Record, WBS Element / PSP-Element, Project, Material, Customer, Supplier, Order …), parent (Parent, Superior, Higher-Level, Übergeordnet), migration object and timestamp columns. Without an object column the objects are read from the message texts (source-record groups, framework / wrapper message roles). JSON: an array of message objects or {'messages': [...]} with the same keys.

Erforderliche Eingabe

A message log with a message type column and a message id (class + number or combined)

Configuration options: known_objects (object inventory of the load; makes missing-parent findings RULE_DERIVED instead of INFERRED and resolves identifiers of message texts), family_min_objects (default 3), max_rows (default 1,000,000). Message types E/A/X = error, W = warning, S/I = information (Fehler / Warnung / Information / Erfolg); message ids are normalised to CLASS/NNN. The analysis is structural (object keys, parent references, message order, co-occurrence) plus the format knowledge of the versioned role catalog (src/knowledge/sap_message_roles.json); message texts are only read for object identifiers.

Befundcodes

Befundcodes (5)

CAUSAL_MISSING_PARENT_OBJECTStandard-Schweregrad: KritischKategorie: OBJECT_HIERARCHY
Übergeordnete Objekte fehlen in der Ladung, obwohl fehlerhafte Objekte darauf verweisen
Behebung: Nehmen Sie die fehlenden übergeordneten Objekte vor ihren abhängigen Objekten in die Ladung auf (oder prüfen Sie, ob sie im Zielsystem existieren) und simulieren Sie erneut. ERP Preflight stellt nur fest, dass die Objekte im analysierten Protokoll bzw. Objektbestand fehlen.
CAUSAL_PRIMARY_ROOT_CAUSEStandard-Schweregrad: HochKategorie: ROOT_CAUSE
Primäre Ursachengruppe einer Fehlerkaskade
Behebung: Beheben Sie zuerst die Ursache dieser Gruppe (siehe Behebungsreihenfolge und Beispielobjekte) und wiederholen Sie dann die Simulation bzw. den Ladelauf: Die Folgemeldungen ihrer Objekte sollten danach verschwinden. Arbeiten Sie die Folgemeldungen nicht einzeln ab.
CAUSAL_HIERARCHY_CYCLEStandard-Schweregrad: GeringKategorie: OBJECT_HIERARCHY
Verweise auf übergeordnete Objekte bilden einen Zyklus
Behebung: Korrigieren Sie die Verweise auf übergeordnete Objekte der aufgeführten Objekte, sodass kein Objekt sein eigener Vorfahre ist; bis dahin wird die kausale Richtung zwischen ihnen als UNKNOWN ausgewiesen.
CAUSAL_UNLINKED_ERRORSStandard-Schweregrad: GeringKategorie: DATA_COMPLETENESS
Fehler ohne Objektschlüssel lassen sich keiner Grundursache zuordnen
Behebung: Exportieren Sie das Protokoll erneut mit der Objekt- bzw. Instanzspalte (z. B. Instanz, Objektschlüssel, Quelldatensatz, PSP-Element), damit diese Fehler verknüpft werden können; prüfen Sie sie bis dahin einzeln.
CAUSAL_CONSEQUENCE_FAMILYStandard-Schweregrad: InfoKategorie: MESSAGE_FAMILY
Folgemeldungs-Familie (tritt nie allein auf)
Behebung: Analysieren Sie diese Meldung nicht isoliert: Sie tritt nur zusammen mit einem anderen Fehler am selben Objekt auf. Beheben Sie die begleitende primäre Meldung; diese Meldung sollte dann ebenfalls verschwinden.

Codes der Eingabeprüfung (5)

CAUSAL_ARCHIVE_REJECTEDStandard-Schweregrad: HochKategorie: INPUT_VALIDATION
Archiv durch Sicherheitsgrenzen der Datenaufnahme abgewiesen
Behebung: Das Archiv hat das Expansionsverhältnis von 100:1, die Gesamtgröße von 500 MB, die Eintragsanzahl oder die Verschachtelungstiefe von 2 Ebenen überschritten oder enthielt Pfadtraversierung bzw. verschlüsselte Einträge. Laden Sie ein flaches, unverschlüsseltes Archiv der Exportdateien hoch. Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Error Log Root Cause akzeptierten Formate (CSV, TEXT, JSON) und starten Sie die Analyse erneut.
CAUSAL_INVALID_INPUTStandard-Schweregrad: HochKategorie: INPUT_VALIDATION
Artefakt entspricht nicht dem Eingabevertrag der Engine
Behebung: Liefern Sie den für diese Engine dokumentierten Artefakttyp; fremde oder strukturell ungültige Dokumente werden abgewiesen. Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Error Log Root Cause akzeptierten Formate (CSV, TEXT, JSON) und starten Sie die Analyse erneut.
CAUSAL_PARSE_ERRORStandard-Schweregrad: HochKategorie: INPUT_VALIDATION
Artefakt konnte nicht geparst werden
Behebung: Beheben Sie den Syntaxfehler an der gemeldeten Zeile/Spalte (oder exportieren Sie die Datei unverändert erneut aus SAP). Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Error Log Root Cause akzeptierten Formate (CSV, TEXT, JSON) und starten Sie die Analyse erneut.
CAUSAL_PAYLOAD_TOO_LARGEStandard-Schweregrad: HochKategorie: INPUT_VALIDATION
Artefakt überschreitet die Größenbegrenzung
Behebung: Teilen Sie den Export auf (z. B. nach Paket, Buchungskreis oder Zeitraum), sodass jeder Upload unter der Nutzlastgrenze des Dienstes bleibt. Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Error Log Root Cause akzeptierten Formate (CSV, TEXT, JSON) und starten Sie die Analyse erneut.
CAUSAL_INSUFFICIENT_INPUTStandard-Schweregrad: InfoKategorie: INPUT_VALIDATION
Erforderliche Eingabe fehlt
Behebung: Liefern Sie alle Eingaben, die der Engine-Vertrag als erforderlich kennzeichnet (siehe Eintrag im Engine-Katalog). Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Error Log Root Cause akzeptierten Formate (CSV, TEXT, JSON) und starten Sie die Analyse erneut.

Zurück zur Dokumentation