SAP CPI Trace: Eine Nachricht Schritt für Schritt verfolgen, ohne den iFlow-Designer zu verlassen

Wenn ein iFlow das falsche Ergebnis liefert, lautet die Frage fast immer gleich: Wie sah die Nachricht direkt vor dem Schritt aus, der schiefging? SAP Cloud Integration (SAP CPI) kann das beantworten, aber nur für Nachrichten, die mit der Protokollstufe TRACE verarbeitet wurden, und die Antwort steht im Monitor, mehrere Bildschirme entfernt von dem Diagramm, das Sie bearbeiten.

Dieser Artikel erklärt, was ein Trace aufzeichnet, wie Sie ihn im Monitor von SAP lesen und wie Sie denselben Trace mit dem Kitegra Schritt für Schritt im Diagramm verfolgen.

Was ein Trace aufzeichnet

Jede Nachricht hinterlässt ein Message Processing Log (MPL): ihren Status, Beginn und Ende sowie die Schritte, die sie durchlaufen hat. Die Protokollstufe des iFlows bestimmt, wie viele Details hineinkommen.

Trace-Inhalte sind für die Analyse gedacht, nicht zur Archivierung. SAP bewahrt sie etwa eine Stunde auf, und die Stufe TRACE selbst fällt nach etwa 10 Minuten zurück; die Nachricht, die Sie lesen wollen, muss also kurz nach dem Setzen von TRACE laufen. Weil dabei echte Payloads im Tenant gespeichert werden, verwenden Sie es nach Möglichkeit mit Testdaten und halten Sie sich in der Produktion an die Regeln Ihres Unternehmens. Warum TRACE sich selbst abschaltet erklärt die Grenzen.

Einen Trace im Monitor von SAP lesen

1. Öffnen Sie im Monitor Manage Integration Content, wählen Sie den bereitgestellten iFlow und setzen Sie seine Protokollstufe auf Trace.
2. Senden Sie die Nachricht in den nächsten Minuten erneut.
3. Öffnen Sie die Nachricht in Monitor Message Processing und folgen Sie ihrem Trace-Link zum Verarbeitungslauf.
4. Wählen Sie im Diagramm des Laufs einen Schritt und öffnen Sie seinen Nachrichteninhalt: Header, Properties und Payload.

Das funktioniert, aber jeder Blick auf einen Schritt kostet einige Klicks, das Diagramm des Laufs ist nicht das, das Sie bearbeiten, und nach 10 Minuten muss die Protokollstufe erneut gesetzt werden.

TRACE aus dem Designer einschalten

Öffnen Sie mit dem Kitegra den iFlow im Designer, klicken Sie in der Werkzeugleiste des Diagramms auf „Kitegra-Werkzeuge“ und wählen Sie Nachrichten (oder drücken Sie Alt+Shift+M). Das Panel listet die letzten Nachrichten des iFlows auf der gewählten Laufzeit, nach Tagen gruppiert, mit Status, Startzeit und Dauer. Getracte Nachrichten tragen eine TRACE-Markierung, und neue blinken kurz auf, wenn sie eintreffen.

Der Schalter im Panel zeigt „Trace: aus“. Ein Klick setzt die Protokollstufe des iFlows auf TRACE, und der Schalter zeigt „Trace: an“ mit einem Minutenzähler. Solange er an ist und Sie im iFlow arbeiten, setzt die Erweiterung TRACE erneut, bevor SAP die Stufe zurücksetzt; 20 Minuten nach Ihrer letzten Aktivität hört sie damit auf. Aus stellt die Protokollstufe wieder her, die der iFlow vorher hatte.

Trace ist eine der vier Aktionen, die Ihren Tenant ändern, und wie die anderen läuft sie nur, wenn Sie darauf klicken.

Die Nachricht im Diagramm verfolgen

1. Senden Sie die Nachricht, oder warten Sie auf die nächste. Sie erscheint oben im Panel Nachrichten.
2. Wählen Sie bei einer getracten Nachricht „Im Diagramm“. Die durchlaufenen Schritte werden eingefärbt, ein fehlgeschlagener Schritt wird markiert, und nicht erreichte Schritte werden abgeblendet.
3. Klicken Sie auf einen eingefärbten Schritt. Das Panel „Inhalt vor dem Schritt“ zeigt Body, Header und Exchange-Properties, wie sie vor diesem Schritt waren, das Protokoll des Schritts und den Fehler, wenn der Schritt fehlschlug.
4. Mit Zurück und Weiter gehen Sie die Schritte in der Reihenfolge durch, in der sie liefen. Ein Schritt, der mehrmals lief, in einem Splitter oder einer Schleife, zeigt jeden Durchlauf, zum Beispiel „Durchlauf 2 von 3 dieses Schritts“.
5. Wenn Sie fertig sind, wählen Sie „Markierungen im Diagramm entfernen“.

Lief die Nachricht ohne TRACE, sagt das Panel es Ihnen: SAP speichert Body und Header einer Nachricht nur, wenn sie mit TRACE läuft, und nur etwa eine Stunde lang.

Mit den Ergebnissen arbeiten

• Der Payload-Viewer zeigt einen Body „Formatiert“ oder als „Eine Zeile“, bietet „Zeilen umbrechen“ und „Suchen“ und lässt Sie ihn mit „Kopieren“ oder „Herunterladen“ übernehmen.
• „Mit dem nächsten Schritt vergleichen“ öffnet zwei Bodies nebeneinander im Payload-Vergleich, sodass Sie genau sehen, was ein Schritt geändert hat.
• Laufzeiten färbt die Schritte nach ihrer Dauer ein, vom schnellsten (grün) bis zum langsamsten (rot); fahren Sie mit der Maus über einen Schritt, um seine Zeit zu sehen.
• Bei einem langen Lauf legt „Gelesene Schritte“ fest, wie viele Schritte für diesen iFlow gelesen werden, oder Alle.
• Bei einer fehlgeschlagenen Nachricht sagt die Registerkarte Übersicht, wo sie fehlschlug, und bei bekannten Fehlern „Was das meist bedeutet:“.

Um eine Nachricht zu öffnen, deren ID Sie kennen, aus diesem oder einem anderen iFlow des Tenants, lesen Sie eine SAP CPI Nachricht per Message ID oder Correlation ID finden.

Wie der Kitegra hilft

Der Message Monitor ist einer der fünf Bereiche des Kitegra. Trace-Inhalte sind Kundendaten: Die Erweiterung zeigt sie auf der Seite an und lässt Sie einen Body herunterladen, speichert, synchronisiert oder sendet sie aber nie an Kitegra.

Helper, Message Monitor, iFlow Inspector und iFlow Docs zählen jeweils die iFlows, für die Sie sie nutzen: 5 je Modul ohne Kitegra-Konto, 50 im Tarif Free, 100 mit Starter und 300 mit Pro; Business hat kein Limit. Die Toolbox und die Extras für den Arbeitsbereich sind kostenlos. Tarife vergleichen.

Probieren Sie ihn im nächsten iFlow aus

Lesen Sie, was der Kitegra rund um den Designer der SAP Integration Suite ergänzt, oder sehen Sie ihn neben den anderen Chrome-Erweiterungen von Kitegra.

Häufige Fragen