MFS BlackBox

Material Flow System / EWM telegram sequence, handshake, heartbeat, warehouse-task state and PLC release auditor with incident clustering and minimal reproduction

Inhalt geprüft am 26. September 2026

Engine: MFS_BLACKBOX
Domäne: Warehouse Automation
Version: 1.3.0
Ziel-Releases: S4H_2022, S4H_2023, S4HANA_CLOUD_2402, S4HANA_CLOUD_2408
Akzeptierte Formate: JSON, CSV, XLSX

Eingabevertrag

MFS telegram log: CSV/TSV/pipe log with a header row (type, hu_id, cp, to_cp, seq_no, sender_plc, receiver_plc, status, time_sec/timestamp, wt_id, plc_release; EDGE,<from>,<to> rows declare conveyor topology), the same table as the first worksheet of an XLSX workbook, or JSON {'telegrams': [...], 'conveyor_edges': [[from, to]], 'configuration': {ack_timeout_seconds, max_retries, heartbeat_timeout_seconds, completion_timeout_seconds, recurrence_threshold}}. Inline payloads are bounded by the service payload limit; delimited logs of any size (multi-GB) are streamed through POST /api/v1/analyze/stream and processed line by line with bounded memory.

Erforderliche Eingabe

At least one telegram with a 'type'

Telegram families: LIFE / HEARTBEAT (heartbeat timeout), WT / WTCR / TO (warehouse task created, destination to_cp), WTCO / CONF / DONE (completion, confirmed location cp). XLSX: first worksheet, max 200,000 rows, read through the hardened ZIP reader and defusedxml. No simulator adapter: the minimal reproduction is exported as a JSON regression fixture instead.

Befundcodes

Befundcodes (11)

MFS_FIRST_CAUSAL_DIVERGENCEStandard-Schweregrad: KritischKategorie: CAUSAL_DIAGNOSTICS
Erste kausale Abweichung in der Vorfallzeitleiste
Behebung: Beginnen Sie die Ursachenanalyse beim referenzierten Telegramm; spätere Auffälligkeiten sind wahrscheinlich Folgefehler.
MFS_HEARTBEAT_TIMEOUTStandard-Schweregrad: KritischKategorie: TELEGRAM_HANDSHAKE
Lebenstelegramm-Lücke überschreitet das Timeout
Behebung: Prüfen Sie die SPS-Verbindung des Kanals, das in der SPS-Schnittstelle konfigurierte Lebenstelegramm-Intervall und das Netzwerk; synchronisieren Sie den Kanal nach der Unterbrechung neu und prüfen Sie, ob in der Lücke Telegramme verloren gingen.
MFS_IMPOSSIBLE_TOPOLOGY_JUMPStandard-Schweregrad: KritischKategorie: CONVEYOR_TOPOLOGY
HU zwischen nicht benachbarten Fördertechnikpunkten bewegt
Behebung: Gleichen Sie die Definitionen der Fördersegmente / Kommunikationspunkte mit dem physischen Layout ab und prüfen Sie auf fehlende Scannerlesungen zwischen den beiden Punkten.
MFS_MISSING_ACK_TIMEOUTStandard-Schweregrad: KritischKategorie: TELEGRAM_HANDSHAKE
Telegramm nicht innerhalb des Timeouts quittiert
Behebung: Prüfen Sie die SPS-Verbindung und den ACK-Timeout des Kanals; nicht quittierte Bewegungen lassen Lageraufgaben offen.
MFS_WRONG_CONFIRMATIONStandard-Schweregrad: KritischKategorie: WAREHOUSE_TASK_STATE
Lageraufgabe für falsche HU / falsches Ziel oder doppelt quittiert
Behebung: Korrigieren Sie die HU-Position in EWM (/SCWM/MON), prüfen Sie die Ziel- bzw. HU-Zuordnung der SPS für die Aufgabe und das Layout des Quittierungstelegramms.
MFS_CORRUPTED_TELEGRAMStandard-Schweregrad: HochKategorie: DATA_INTEGRITY
Fehlerhafter Telegrammsatz
Behebung: Prüfen Sie die Telegrammstruktur-Definition der SPS / MFS (/SCWM/MFS-Telegrammstrukturen) und den Log-Export; fehlerhafte Sätze wurden von der Rekonstruktion ausgeschlossen.
MFS_DUPLICATE_TELEGRAM_SENDStandard-Schweregrad: HochKategorie: TELEGRAM_RETRY_STORM
Doppelte Telegrammübertragung (Retry-Sturm)
Behebung: Untersuchen Sie fehlende bzw. verspätete ACKs, die Wiederholungen auslösen; passen Sie Wiederholintervall und maximale Wiederholungen in der Kanalkonfiguration an.
MFS_MISSING_COMPLETIONStandard-Schweregrad: HochKategorie: WAREHOUSE_TASK_STATE
Lageraufgabe nie quittiert
Behebung: Lokalisieren Sie die HU, prüfen Sie, ob die SPS den Transport ausgeführt hat, und quittieren oder stornieren Sie die Lageraufgabe in EWM (/SCWM/MON); prüfen Sie das Quittierungstelegramm der SPS für das Ziel.
MFS_OUT_OF_ORDER_SEQUENCEStandard-Schweregrad: HochKategorie: TELEGRAM_ORDERING
Telegrammfolge vertauscht oder lückenhaft
Behebung: Prüfen Sie die Sequenznummernbehandlung und den Wiederholpuffer des Kommunikationskanals (Monitoring /SCWM/MFS_CP_CHANNEL); verlorene Telegramme müssen mit der SPS resynchronisiert werden.
MFS_PLC_RELEASE_REGRESSIONStandard-Schweregrad: HochKategorie: PLC_RELEASE_COMPARISON
Anomalierate nach Wechsel des SPS-Softwarestands gestiegen
Behebung: Vergleichen Sie das Telegrammverhalten beider SPS-Softwarestände mit dem SPS-Hersteller und testen Sie die betroffenen Szenarien auf einem Simulator erneut, bevor Sie den Softwarestand weiter ausrollen (das Ergebnis ist eine Korrelation, kein Beweis).
MFS_RECURRING_INCIDENT_PATTERNStandard-Schweregrad: HochKategorie: INCIDENT_CLUSTERING
Vorfall-Fingerabdruck wiederholt sich über HUs / Vorkommen
Behebung: Behandeln Sie den Fingerabdruck als ein systematisches Problem (Topologiedefinition, Kanal, SPS-Programm) und beheben Sie die gemeinsame Ursache; verfolgen Sie den Fingerabdruck in späteren Logs, um die Behebung zu bestätigen.

Codes der Eingabeprüfung (5)

MFS_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 MFS BlackBox akzeptierten Formate (JSON, CSV, XLSX) und starten Sie die Analyse erneut.
MFS_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 MFS BlackBox akzeptierten Formate (JSON, CSV, XLSX) und starten Sie die Analyse erneut.
MFS_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 MFS BlackBox akzeptierten Formate (JSON, CSV, XLSX) und starten Sie die Analyse erneut.
MFS_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 MFS BlackBox akzeptierten Formate (JSON, CSV, XLSX) und starten Sie die Analyse erneut.
MFS_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 MFS BlackBox akzeptierten Formate (JSON, CSV, XLSX) und starten Sie die Analyse erneut.

Zurück zur Dokumentation