Überwachung von ABAP-Web-Service-Messages

Messages auswählen

Starten Sie den Message-Monitor im Register Überwachung in SOA-Manager (Transaktionscode SOAMANAGER). Sie können den Message-Monitor auch im SAP-GUI-Einstiegsbild mit dem Transaktionscode SRT_MONI aufrufen. Auf dem Einstiegsbild des Message-Monitors definieren Sie die Selektionskriterien für die Messages, die Sie anzeigen möchten.

1. Wählen Sie die Ergebnisausgabe:

   • Wählen Sie Detail (Standardauswahl), um eine Liste aller einzelnen Messages anzuzeigen, die Ihren Suchkriterien entsprechen.

   • Wählen Sie ZusFassung, um eine Zusammenfassung der Messages anzuzeigen, die Ihren Suchkriterien entsprechen.

2. Wählen Sie eine Sicht aus.

   • Wählen Sie Basissicht, um nur die wichtigsten Message-Attribute anzuzeigen.

   • Wählen Sie Technische Sicht, um weitere Message-Attribute und mögliche Aktionen anzuzeigen.

3. Wählen Sie die Selektionskriterien aus, die Sie verwenden möchten. Weitere Informationen finden Sie unter Selektionskriterien für Web-Service-Messages im Message-Monitor.

4. Führen Sie die Message-Abfrage aus.

   Die Messages, die Ihren Selektionskriterien entsprechen, werden in der ausgewählten Sicht als Zusammenfassung oder als Detailliste angezeigt.

5. In der Detailliste können Sie Messages erneut auswählen, indem Sie am Listenanfang Neu auswählen wählen. Ihnen stehen dann ähnliche Selektionsoptionen wie auf dem Einstiegsbild zur Verfügung.

In der Detailliste werden die Messages einzeln gemäß Ihren Selektionskriterien aufgeführt. Wenn Sie eine Zusammenfassung gewählt haben, wird die Anzahl der Messages in diesem Status für jede Verarbeitungsstatusgruppe angezeigt. Sie können auf eine Zeile doppelklicken, um die Message-Liste mit Details zu jeder einzelnen Message zu erhalten.

Die Message-Liste wird entweder in der Basissicht oder in der technischen Sicht dargestellt. In der Basissicht wird eine festgelegte Anzahl von Message-Attributen angezeigt. In der technischen Sicht erscheinen weitere technische Attribute wie die eindeutige Message-Persistenz-ID. Standardmäßig enthält die technische Sicht nicht alle möglichen Attribute für eine Message. Sie können sich jedoch eine persönliche Sicht definieren, in der alle für Sie relevanten Attribute angezeigt werden.

Mit der Message-Liste arbeiten

• Für Messages, die Sie in der Liste auswählen, können Sie die folgenden dazugehörigen Messages anzeigen:

  Sequenz-Messages

  Zeigt als Erweiterung der aktuellen Selektion alle Messages an, die zur gleichen Sequenz gehören wie die ausgewählten Messages.

  Übergeordnete Messages

  Zeigt alle übergeordneten Messages der ausgewählten Messages an. Solche Hierarchiebeziehungen kommen z.B. in Ereignisszenarios vor, in denen ausgehend von einer ursprünglichen Ereignis-Message mehrere untergeordnete Messages erzeugt werden können.

  Untergeordnete Messages

  Zeigt alle untergeordneten Messages der ausgewählten Messages an.

• Message-Daten exportieren

  Sie können eine Message-Liste in unterschiedlichen Formaten exportieren. Dazu verwenden Sie die Standardfunktionen der Tabellen-Controls.

Messages aus Mappings

Ein Consumer-Proxy mit asynchronen Operationen kann so definiert werden, dass er entweder innerhalb des Anwendungsprogrammkontextes (im gekoppelten Modus) oder später in einem separaten Kontext (im entkoppelten Modus, mit asynchroner Grenze) läuft. Das Consumer-Mapping erbt diese Eigenschaft implizit vom Consumer-Proxy, und sie wird im Message-Monitor angezeigt.

Bei einem gekoppelten Mapping wird die Quell-Message auf die Ziel-Message abgebildet, ohne dass die Quell-Message gespeichert wird. Nur die tatsächliche gesendete Message wird gespeichert. Die Message wird daher als normale Message angezeigt. Anhand der Spalte Gekoppelt können Sie jedoch erkennen, dass eine Message von einem gekoppelten Mapping stammt.

Messages, die von entkoppelten Mappings stammen, werden mit dem Adaptertyp Mapping angezeigt. Bei einem entkoppelten Mapping wird die Message erzeugt und gesichert, bevor das Mapping stattfindet. Nach dem Mapping wird die Message erneut persistiert. Die ursprüngliche Message wird mit dem Adaptertyp Mapping gespeichert, während die Ziel-Message wieder eine normale Message ist. Im Monitor wird die Quell-Message dann als übergeordnete Message der Ziel-Message angezeigt.

Mit einzelnen Messages in der Message-Liste arbeiten

In der Message-Liste können Sie folgende Aktivitäten durchführen:

• Messages neu starten

  Sie können Messages mit Fehlerstatus erneut starten. Die Messages werden in die asynchrone Verarbeitungsqueue gestellt, damit sie erneut verarbeitet werden. Ein solcher Neustart kann z.B. sinnvoll sein, wenn die Konfiguration nach dem letzten Ausführungsversuch, der zu dem Kommunikationsfehler geführt hat, geändert wurde.

  Um mehrere Messages gleichzeitig neu zu starten, verwenden Sie das Programm SRT_UTIL_RESTART. Siehe ABAP-Web-Service-Messages neu starten und abbrechen.

• Message mit Debugging neu starten

  Hinweis Für das Debugging benötigen Sie Entwicklerberechtigung.

  Wenn Sie nur eine einzige Message mit Fehler auswählen, können Sie sie neu starten und den Debugger im Web-Service-Laufzeitquellcode starten. Beachten Sie, dass der Debugger nicht im Anwendungsquellcode gestartet wird.

• Werte für die benutzerdefinierte Suche anzeigen

  Wählen Sie BDS-Werte anzeigen, um die Werte für die benutzerdefinierte Suche anzuzeigen, die aus den ausgewählten Messages extrahiert wurden.

• Messages abbrechen

  Sie können Messages mit Fehlerstatus abbrechen. Wenn Sie eine Message abbrechen, erhält sie den finalen Status Abgebrochen und wird nicht mehr verarbeitet. In einigen Fällen kann eine Message nicht in der Message-Liste abgebrochen werden. Dann müssen Sie die betroffene Message in der Liste inkonsistenter Messages abbrechen.

  Um mehrere Messages gleichzeitig abzubrechen, verwenden Sie das Programm SRT_UTIL_CANCEL. Siehe ABAP-Web-Service-Messages neu starten und abbrechen.

• Konsistenzprüfung

  Die Konsistenzprüfung ist nur in der technischen Sicht verfügbar. Sie prüft die Konsistenz zwischen den Message-Statusdaten und den asynchronen Verarbeitungsdaten. Beachten Sie, dass Inkonsistenzen erst 5 Minuten nach der Ausführung der auslösenden Aktivität festgestellt werden.

  Bei der Konsistenzprüfung wird die Liste inkonsistenter Messages erstellt. Diese Liste ähnelt der allgemeinen Message-Liste, enhält jedoch weitere technische Details, da sie für Support-Zwecke vorgesehen ist. In der Liste der inkonsistenten Messages können Sie Messages nicht neu auswählen. Sie können jedoch eine Konsistenznachprüfung für die angezeigten Messages anstoßen. Sie können hier auch den Abbruch ausgewählter Messages erzwingen. Das System überspringt in diesem Fall einige Prüfungen, die beim Abbruch von Messages in der allgemeinen Liste ausgeführt werden.

• Message-Details anzeigen

  In der allgemeinen Message-Liste und der Liste inkonsistenter Messages können Sie Details für eine einzelne Message anzeigen, indem Sie auf die Message-ID klicken. Standardmäßig wird die Payload-View mit allen Message-Details angezeigt. Die Message-Payloads werden in einer Tabelle angezeigt. Bei Fehlern stehen sowohl die ursprüngliche Message-Version als auch die Fehlerversionen zur Verfügung. Sie können eine XML-Ansicht der Payload anzeigen, indem Sie Original-XML im oberen Menü wählen. Um weitere Details wie Header-Informationen und Message-Struktur anzuzeigen, können Sie die Sicht des Message-Detailbilds ändern. Sie können dann z.B. sehen, ob eine Payload als Attachment der eigentlichen Message gespeichert wird.

• Sequenzen überwachen

  Von der Message-Liste aus können Sie zum Sequenz-Monitor navigieren. Sie können den Monitor auch direkt mit dem Transaktionscode SRT_MONIS aufrufen. Weitere Informationen finden Sie unter Sequenzen überwachen.