Traceerstellung für Web-Services
Für die Laufzeitkomponenten von Web-Services können Sie einen Trace durchführen. Diese Komponenten können ein nicht verwalteter Client, ein verwalteter Client und eine Serveranwendung sein. Der Trace für die Laufzeitkomponenten kann den Eintritt in Prozeduren, den Austritt aus Prozeduren und die Verarbeitungsaktivitäten verfolgen. Sie können auch benutzerdefinierte Ausnahmen und SOAP-Nachrichten, die Web-Services mit Java™ Message Service (JMS) oder HTTP anfordern, in den Trace aufnehmen.
Vorbereitende Schritte
Informationen zu diesem Vorgang
Nachfolgend ist das Aktivieren des Trace für Web-Services beschrieben:
Vorgehensweise
- Aktivieren Sie den Trace für einen nicht verwalteten Web-Service-Client.
Erstellen Sie eine Traceeigenschaftendatei. Kopieren Sie dazu die Datei %Installationsstammverzeichnis\properties\TraceSettings.properties in das Verzeichnis, das die JAR-Datei Ihrer Clientanwendung enthält.
Erstellen Sie eine Traceeigenschaftendatei. Kopieren Sie dazu die Datei Stammverzeichnis_des_Anwendungsservers/properties/TraceSettings.properties in das Verzeichnis, das die JAR-Datei Ihrer Clientanwendung enthält.
Editieren Sie die Eigenschaftendatei, und ändern Sie den Wert von "traceFileName" so, dass die Tracedaten ausgegeben werden. Beispiel: traceFileName=c:\\temp\\myAppClient.trc.
Editieren Sie die Eigenschaftendatei, und ändern Sie den Wert von "traceFileName" so, dass die Tracedaten ausgegeben werden. Beispiel: traceFileName=/myDir/myAppClient.trc.
- Editieren Sie die Eigenschaftendatei. Entfernen Sie com.ibm.ejs.ras.*=all=enabled, und fügen Sie com.ibm.ws.webservices.engine.*=all=enabled hinzu.
- Fügen Sie der java-Befehlszeile, die zum Ausführen des Clients verwendet wird, die Option -DtraceSettingsFile=<Traceeigenschaftendatei> hinzu. Traceeigenschaftendatei steht hier für den Namen der Eigenschaftendatei, die Sie in den untergeordneten Schritten a bis c erstellt haben. Beispiel: java -DtraceSettingsFile=TraceSettings.properties myApp.myAppMainClass.
- Aktivieren Sie den Trace für einen mit Web-Services verwalteten Client, indem Sie
das Befehlszeilentool launchClient mit den folgenden Optionen aufrufen:
-CCtrace=com.ibm.ws.webservices.engine.*=all=enabled
-CCtracefile=traceFileName
Beispiel:%Installationsstammverzeichnis%\bin\launchClient MyAppClient.ear
-CCtrace=com.ibm.ws.webservices.engine.*=all=enabled -CCtracefile=myAppClient.trc
Weitere Informationen zu diesem Tool finden Sie im Artikel zum Tool "launchClient".Stammverzeichnis_des_Anwendungsservers/bin/launchClient MyAppClient.ear
-CCtrace=com.ibm.ws.webservices.engine.*=all=enabled -CCtracefile=myAppClient.trc
- Aktivieren Sie den Trace für eine Serveranwendung des Typs "Web Services for Java Platform, Enterprise Edition (Java EE)".
- Starten Sie WebSphere Application Server.
- Öffnen Sie die Administrationskonsole.
- Klicken Sie auf Server > Anwendungsserver > Server.
- Klicken Sie auf Detailstufe für Protokoll ändern.
- Fügen Sie im Textfeld die Tracezeichenfolge hinzu, bzw. löschen Sie sie.
Für diese Task löschen Sie die Tracezeichenfolge
*=info, und fügen anschließend die Tracezeichenfolge com.ibm.ws.webservices.engine.*=all=enabled
hinzu. Sie können die Tracezeichenfolge auf zwei Arten in das Textfeld eintragen:
- Geben Sie die Tracezeichenfolge direkt in das Textfeld ein.
Sie müssen die einzelnen Tracezeichenfolgen durch einen Doppelpunkt (:) ohne Leerzeichen
voneinander trennen.
Beispiel:
com.ibm.ws.webservices.trace.MessageTrace=finest:com.ibm.ws.webservices. engine.Message=finest
- Wählen Sie eine vordefinierte Tracezeichenfolge im Abschnitt aus.
Der Abschnitt mit den vordefinierten Tracezeichenfolgen beginnt mit *[All Components]. Die vordefinierten Tracezeichenfolgen für Web-Service-Komponenten sind im Abschnitt
com.ibm..ws.* aufgelistet.
- Klicken Sie auf das Pluszeichen (+), um den Abschnitt com.ibm.ws.* zu erweitern.
- Klicken Sie auf die vordefinierte Tracezeichenfolge. Wenn Sie beispielsweise eine vordefinierte Zeichenfolge für den SOAP-Messaging-Trace hinzufügen möchten, können Sie auf com.ibm.ws.webservices.trace.MessageTrace klicken.
- Klicken Sie in der Dropdown-Liste auf die Traceoption. Sie können zwischen off, fatal, severe, warning, audit, info, config, detail, fine, finer, finest
und all wählen.
Die Verwendung der Option finest wird empfohlen.
Wenn Sie auf die Option klicken, wird die Option am Ende der Tracezeichenfolge hinzugefügt.
Beispiel:
com.ibm.ws.webservices.trace.MessageTrace=finest
- Geben Sie die Tracezeichenfolge direkt in das Textfeld ein.
Sie müssen die einzelnen Tracezeichenfolgen durch einen Doppelpunkt (:) ohne Leerzeichen
voneinander trennen.
Beispiel:
- Klicken Sie auf Speichern und Anwenden.
- Aktivieren Sie den Trace für SOAP-Nachrichten und/oder benutzerdefinierte Ausnahmen. Für den Trace
von SOAP-Nachrichten werden die folgenden Tracespezifikationen verwendet:
- com.ibm.ws.webservices.trace.MessageTrace=all
Mit dieser Angabe wird der Inhalt einer SOAP-Nachricht, einschließlich der binären Anlage, erfasst.
Wenn als context-type der SOAP-Nachricht weder text noch xml angegeben ist, enthält die Nachricht möglicherweise Anlagen. In diesem Fall wird die Nachricht in der Tracedatei im hexadezimalen Speicherauszugsformat angezeigt. Das folgende Beispiel zeigt eine Zeile im hexadezimalen Speicherauszugsformat für SOAP-Nachrichten, die keine Textnachrichten sind:0000: 0D 0A 2D 2D 2D 2D 2D 2D - 3D 5F 50 61 72 74 5F 36 ..------=_Part_6
- In jeder Zeile der Tracedatei werden 16 Bytes der Nachricht angezeigt.
- Die ersten vier Stellen sind eine Hexadezimalzahl, deren Wert die relative Position des ersten Bytes der Zeile in der SOAP-Nachricht angibt.
- Die folgenden 16 zweistelligen Hexadezimalzahlen repräsentieren den Inhalt aller weiteren Bytes in der Nachricht an.
- Die ASCII-Darstellung der Bytes wird in den letzten 16 Zeichen der Zeile angezeigt. Zeichen, die nicht ausgegeben werden können, sind mit einem Punkt dargestellt.
- *=off:com.ibm.ws.webservices.*=all
Mit dieser Einstellung können Sie alle Web-Service-Informationen, einschließlich SOAP-Nachrichten und benutzerdefinierter Ausnahmen, erfassen.
Sie können die Protokollierung benutzerdefinierter Ausnahmen aktivieren, indem Sie die Tracezeichenfolge com.ibm.ws.webservices.trace.UserExceptionTrace=all angeben. Benutzerdefinierte Ausnahmen werden standardmäßig nicht protokolliert. Eine benutzerdefinierte Ausnahme ist eine in der WSDL-Datei für eine Operation definierte Ausnahme.
Oft gibt eine benutzerdefinierte Ausnahme einen fehlerfreien Zustand an. Die benutzerdefinierte Ausnahme "OverdrawnException" kann beispielsweise für die Servicendpunktimplementierung der Methode makeWithdrawl eintreten. Diese Ausnahme gibt eine Ausnahme an und weist nicht auf einen Fehler der Serviceendpunktimplementierung hin. Da solche Ausnahmen bei der ganz normalen Verarbeitung eintreten können, werden sie standardmäßig nicht protokolliert. Wenn eine benutzerdefinierte Ausnahme protokolliert wird, werden die Informationen an die Datei trace.log und nicht an die Datei SystemOut.log gesendet.
Anmerkung: Dieser Artikel referenziert eine oder mehrere Protokolldateien des Anwendungsservers. Alternativ dazu wird empfohlen, den Server so zu konfigurieren, dass er die HPEL-Protokoll- und -Traceinfrastruktur (High Performance Extensible Logging) verwendet und nicht die Dateien SystemOut.log , SystemErr.log, trace.log und activity.log auf verteilten oder IBM® i-Systemen. Sie können HPEL auch in Verbindung mit Ihren nativen z/OS-Protokolleinrichtungen verwenden. Wenn Sie HPEL verwenden, können Sie mit dem Befehlszeilentool LogViewer im Verzeichnis "bin" des Serverprofils auf alle Ihre Protokoll- und Tracedaten zugreifen. Weitere Informationen zur Verwendung von HPEL finden Sie in der Dokumentation zum Einsatz von HPEL für die Fehlerbehebung in Anwendungen.Wenn Sie den Trace für benutzerdefinierte Ausnahmen und andere Tracepunkte aktivieren möchten, können Sie die folgenden Tracezeichenfolgen verwenden:- com.ibm.ws.webservices.*=all
Aktiviert alle Traceprotokolle für die Web-Service-Laufzeit
- com.ibm.ws.webservices.trace.*=all
Aktiviert den MessageTrace und den UserExceptionTrace
Fehler vermeiden: Beachten Sie, dass, sobald dieser Trace aktiviert ist, sämtliche Nutzdaten der SOAP-Nachricht in die Tracedatei geschrieben werden. Sollten sich vertrauliche Daten (z. B. Benutzer-ID und Kennwort) als Bestandteil der Nutzdaten in der SOAP-Nachricht befinden, werden sie ebenfalls in Klartext ausgegeben. Planen Sie den Schutz Ihrer Daten sorgfältig.gotcha
Anmerkung: Für den JAX-WS-Web-Service gibt es zwei Möglichkeiten (normale Stufe und minimale Stufe), uum sowohl die Abgehende HTTP-SOAP-Nachricht als auch die Eingehende HTTP-SOAP-Nachricht in der Tracedatei auszugeben.- Einstellung für normale Stufe
- com.ibm.ws.websvcs.trace.*=all
- Einstellung für minimale Stufe
- com.ibm.ws.websvcs.trace.MessageTrace=all:com.ibm.ws.websvcs.trace.LogFilterInputStream=all
- com.ibm.ws.webservices.trace.MessageTrace=all
Ergebnisse
Nächste Schritte


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_tracewbscomp
Dateiname:twbs_tracewbscomp.html