XCT für die Behebung von Anwendungsfehlern verwenden

Sie können Cross Component Trace Logging (XCT) verwenden, um Probleme in WebSphere Application Server zu diagnostizieren.

Informationen zu diesem Vorgang

Administratoren, die WebSphere Application Server verwenden, müssen Protokoll- und Tracedateien verwenden, um festzustellen, ob ihre Anwendungen und der Server ordnungsgemäß ausgeführt werden.

Je nach Spezifik Ihrer Anwendungen werden möglicherweise innerhalb eines Anwendungsservers mehrere Threads zum Verarbeiten von Anforderungen, z. B. HTTP-Anforderungen oder JMS-Anforderungen, verwendet. Einige Anforderungen werden möglicherweise von mehren Anwendungsservern verarbeitet, z. B. wenn ein Anwendungsserver bei einer Web-Service-Anforderung eine Anforderung an einen anderen Anwendungsserver sendet.

Mithilfe von XCT können Sie Ihre Protokoll- und Tracedateien mit Korrelationsinformationen erweitern. Mit diesen Korrelationsinformationen wird verdeutlicht, welche Threads und welche Anwendungsserverprozesse an der Verarbeitung der einzelnen Anforderungen mitgewirkt haben.

Vorgehensweise

  1. Aktivieren Sie XCT, sofern Sie dies noch nicht getan haben.
    1. Melden Sie sich an der Administrationskonsole an.
    2. Wenn Sie eine Topologie mit einem Verwaltungsagenten verwenden, wählen Sie einen Knoten aus, den Sie verwalten möchten, und navigieren Sie zu diesem Knoten.
    3. Wählen Sie im Navigationsabschnitt in der Konsole Fehlerbehebung > Protokolle und Trace.
    4. Wählen Sie den Server aus, für den Sie XCT aktivieren möchten.
    5. Wählen Sie Detailstufe für Protokoll ändern aus.
    6. Wählen Sie die Registerkarte Konfiguration aus, wenn Sie statische Konfigurationsänderungen vornehmen möchten, oder wählen Sie die Registerkarte Laufzeit aus, wenn Sie Änderungen am Laufzeitstatus des Servers vornehmen möchten.
    7. Aktivieren Sie das Kontrollkästchen Protokoll- und Tracekorrelation aktivieren.
    8. Wählen Sie Anforderungs-IDs in Protokoll- und Tracedatensätze einschließen, Anforderungs-IDs in Protokoll-, Trace- und Korrelationsprotokolldatensätze einschließen oder Anforderungs-IDs in Protokoll- und Tracedatensätze einschließen, Korrelationsprotokolldatensätze erstellen und Datenmomentaufnahmen erfassen aus.
    9. Klicken Sie auf OK.
    10. Wenn Sie auf der Registerkarte "Konfiguration" Änderungen vorgenommen haben, speichern Sie sie, und starten Sie den Anwendungsserver erneut.
      Bewährtes Verfahren Bewährtes Verfahren: Aktivieren Sie XCT, um Anforderungs-IDs in Protokoll- und Tracedateien einzuschließen, wenn Sie anzeigen möchten, welche Protokoll- und Traceeinträge in allen Threads und Anwendungsserverprozessen sich auf dieselbe Anforderung beziehen. Anforderungs-IDs werden nur bei Verwendung des Modus für die Protokoll- und Traceerstellung erfasst und können mit dem Befehl "logViewer" angezeigt oder zur Filterung verwendet werden. bprac
      Bewährtes Verfahren Bewährtes Verfahren: Aktivieren Sie XCT, um Korrelationsprotokolldatensätze zu erstellen, wenn Sie die Anforderungsverzweigungen zwischen Threads und Prozessen protokollieren und zusätzliche Informationen zu jeder Anforderung anzeigen möchten. Die Aktivierung von XCT zur Erstellung von Korrelationsprotokolldatensätzen kann einen erheblichen Einfluss auf die Systemleistung zur Folge haben, daher sollte diese Option am besten für Test- und Implementierungsumgebungen verwendet werden.bprac
      Bewährtes Verfahren Bewährtes Verfahren: Aktivieren Sie XCT, um Datenaufnahmen zu erfassen, wenn Sie Anforderungs- und Antwortteile in ihrer Gesamtheit im Dateisystem speichern möchten. Die Aktivierung von XCT zur Erfassung von Datenmomentaufnahmen kann einen erheblichen Einfluss auf die Systemleistung zur Folge haben, daher sollte diese Option am besten für Test- und Implementierungsumgebungen verwendet werden. XCT erfasst Datenmomentaufnahmen für Nachrichtenanforderungen und -antworten, die vom SIBus verarbeitet werden.bprac
      Fehler vermeiden Fehler vermeiden: Datenmomentaufnahmen werden erfasst und in das Verzeichnis $SERVER_LOG_ROOT/snapdata geschrieben. Der Anwendungsserver entfernt Dateien, die sich in diesem Verzeichnis befinden, nicht automatisch. Wenn die Erfassung von Datenmomentaufnahmen aktiviert ist, müssen Sie die Dateien in regelmäßigen Abständen aus diesem Verzeichnis löschen. Datenmomentaufnahmen speichern den gesamten Inhalt von Anforderungen und Antworten und können sensible Daten enthalten. Daher ist die Verwendung dieser Option in Produktionsumgebungen möglicherweise nicht angebracht.gotcha
  2. Verwenden Sie die XCT-Anforderungs-IDs, um Anforderungen zu verfolgen.
    1. Stellen Sie sicher, dass Sie den HPEL-Modus (High Performance Extensible Logging) für die Protokoll- und Traceerstellung verwenden, da im Basismodus für die Protokoll- und Traceerstellung keine Anforderungs-IDs gespeichert werden. Weitere Informationen finden Sie im Artikel zum Wechsel vom Basismodus zum HPEL-Modus für die Protokoll- und Traceerstellung.
    2. Aktivieren Sie XCT, sofern Sie dies noch nicht getan haben.
    3. Filtern Sie Ihre Protokolle mithilfe des HPEL-Befehlszeilentools "LogViewer" nach wichtigen Informationen, z. B. nach Fehlern oder Warnungen. Geben Sie Ihre Protokolle im erweiterten Format aus, sodass Sie Anforderungs-IDs in den Protokollen sehen können. Verwenden Sie den Befehl beispielsweise wie folgt:[Windows]
      logViewer -minLevel WARNING -format advanced
      [Linux][AIX HP-UX Solaris][IBM i]
       logViewer.sh -minLevel WARNING -format advanced
      [z/OS]
      logViewer.sh -minLevel WARNING -format advanced -instance <Instanz-ID>
    4. Wenn Sie Protokolleinträge gefunden haben, die für Sie von Interesse sind, notieren Sie sich die Anforderungs-ID, die diesen Einträgen zugeordnet ist.

    5. Filtern Sie Ihre Protokolle mithilfe des HPEL-Befehlszeilentools "LogViewer" und der Anforderungs-IDs, die Sie sich im vorherigen Schritt notiert haben, wie folgt nach der Anforderungs-ID: [Windows]
      logViewer -includeExtensions requestID=<Anforderungs-ID>
      [Linux][AIX HP-UX Solaris][IBM i]
      logViewer.sh -includeExtensions requestID=<Anforderungs-ID>
      [z/OS]
      logViewer.sh -includeExtensions requestID=<Anforderungs-ID> -instance  <Instanz-ID>
      Nähere Informationen finden Sie im Artikel zum Befehlszeilentool "LogViewer".
  3. Bestimmen Sie mithilfe von XCT-Korrelationsprotokolldatensätzen die Hierarchie von Aufrufketten.
    1. Aktivieren Sie XCT, sofern Sie dies noch nicht getan haben. Wählen Sie Anforderungs-IDs in Protokoll-, Trace- und Korrelationsprotokolldatensätze einschließen aus, um sicherzustellen, dass XCT Korrelationsprotokolldatensätze erstellt.
    2. Wenn Sie HPEL verwenden, konvertieren Sie Ihre Protokolle mit dem Befehlszeilentool "LogViewer" in Text. Verwenden Sie den Befehl beispielsweise wie folgt:[Windows]
      logViewer -outLog myLog.txt
      [Linux][AIX HP-UX Solaris][IBM i]
      logViewer.sh -outLog myLog.txt
      [z/OS]
      logViewer.sh -instance <Instanz-ID> -outLog myLog.txt
      Nähere Informationen finden Sie im Artikel zum Befehlszeilentool "LogViewer".
    3. Verwenden Sie das Tool "IBM® WebSphere Cross Component Trace Logviewer", das mit IBM Support Assistant zur Verfügung stellt wird, zum Laden von Protokoll- und Tracedateien von allen Anwendungsservern, die an der Verarbeitung Ihrer Anforderungen beteiligt sind, und zum Anzeigen der Hierarchie von Anforderungsaufrufketten. Weitere Informationen finden Sie im Artikel "IBM Support Assistant verwenden".

Ergebnisse

Der Server ist jetzt für XCT konfiguriert.

Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ttrb_usingXCT
Dateiname:ttrb_usingXCT.html