Protokolldateien für Rational DOORS und Rational DOORS Web Access

Mit Protokolldateien können Sie Fehler beheben, die auf dem IBM® Rational DOORS-Datenbankserver, dem Client, dem Interoperation Server, dem Rational DOORS Web Access-Server oder dem Nachrichtenbroker auftreten.
Abhängig von der Konfiguration stehen die folgenden Protokollierungstools zum Diagnostizieren eines nicht erwarteten Verhaltens zur Verfügung:
  • Diagnoseprotokoll für den Client
  • Transaktionsprotokoll für den Datenbankserver
  • Transaktionsprotokoll für den Client
  • Protokolle für den Rational DOORS Web Access-Server, den Interoperation Server und den Nachrichtenbroker
  • Protokolle von Anwendungsnachrichten und das Dienstprogramm zur Datenerfassung

Diagnoseprotokoll für den Rational DOORS-Client

Der Client verfügt über einen integrierten Protokollierungsmechanismus, von dem nicht erwartete Ereignisse aufgezeichnet werden, die als Ergebnis eines internen Fehlers während einer Sitzung auftreten. Klicken Sie zum Anzeigen des Diagnoseprotokolls auf Hilfe > Protokoll der Diagnoseprogramme anzeigen. Bei Bedarf können Sie die Informationen aus dem Ausgabefenster kopieren und in einer lokalen Textdatei speichern.

Zum Aufzeichnen eines detaillierteren Protokolls können Sie auf dem Client und dem Datenbankserver eine zusätzliche transaktionsorientierte Protokollierung aktivieren. Weitere Informationen hierzu finden Sie in den folgenden Abschnitten.

Datenbankserverprotokollierung für Rational DOORS

Auf dem Datenbankserver wird eine Protokollierung bereitgestellt, mit der Aktivitäten auf unterschiedlichen Detaillierungsebenen aufgezeichnet werden können. Diese Protokollierung ist standardmäßig nicht aktiviert, weil sie die Prozessorauslastung für Transaktionen erhöhen und damit die Geschwindigkeit für die Ausführung einer erforderlichen Funktion reduzieren oder die Gesamtleistung vermindern kann. Welche Details im Ausgabeprotokoll erfasst werden, hängt von der Protokollebene ab, die Sie festlegen. Die Werte reichen von Ebene 1 für die knappste Protokollierung bis zu Ebene 6 für die ausführlichste Protokollierung. Überprüfen Sie vor der Aktivierung einer Serverprotokollierung gemeinsam mit dem Support, welche Ebene zur Lösung des Problems erforderlich ist.

Tabelle 1. Protokollebenen
Protokollebene Details der Protokollinformationen
1 Verbindungen, Verbindungstrennungen und fehlerhafte Pakete
2 Verbindungen, Verbindungstrennungen und Pakettypen
3 Verbindungen, Verbindungstrennungen, Pakettypen und Paketargumente im kompakten Format
4 Verbindungen, Verbindungstrennungen, Pakettypen und Paketargumente im ausführlichen Format
5 Nur Operationen des Datencache
6 Verbindungen, Verbindungstrennungen, Operationen des Datencache, Pakettypen und Paketargumente im ausführlichen Format
Zum Ermitteln eines unspezifizierten Fehlers kann es erforderlich sein, die Protokollierung auf Ebene 6 zu starten, um alle Aktivitäten zu erfassen. Senden Sie die generierte Protokolldatei nach der Aktivierung der Datenbankprotokollierung und der Reproduzierung des Verhaltens an den Support und inaktivieren Sie die Protokollierung wie im Hilfeabschnitt Transaktionsprotokoll im Rational DOORS-Datenbankserver aktivieren beschrieben.
Anmerkung: Aktivieren Sie die Datenbankprotokollierung nur für begrenzte Diagnosezeiträume, um Leistungseinbußen zu verhindern.

Clientprotokollierung für Rational DOORS

Sie können eine Protokollierung aktivieren, um Verbindungsfehler zum Datenbankserver zu beheben. Im Protokoll sind keine Modul- oder Objektdaten enthalten, die inhaltsbezogene Informationen sein können; es enthält nur Details zur Dateiübertragung. Öffnen Sie auf dem Computer mit dem Fehler den Rational DOORS-Client und führen Sie einen DXL-Befehl aus, um die Clientprotokollierung zu aktivieren und eine lokale Protokolldatei zu generieren. Senden Sie die generierte Protokolldatei nach der Reproduzierung des Verhaltens an den Support und inaktivieren Sie die Protokollierung wie im Hilfeabschnitt zur Clientprotokollierung Transaktionsprotokoll im Rational DOORS-Client aktivieren beschrieben.

Protokollierung für Rational DOORS Interoperation Server sowie Rational DOORS Web Access-Server und Nachrichtenbroker

Von den Rational DOORS Web Access-Komponenten werden standardmäßig Protokolleinträge auf Informationsebene bereitgestellt. Auf der Informationsebene enthalten die Protokolleinträge Informationsnachrichten, in denen der Status der Anwendung auf einer allgemeinen Ebene beschrieben wird. Um weitere Details einzubeziehen, müssen Sie die Komponenten so aktivieren, dass sie auf der Debugstufe ausgeführt werden.

Von Rational DOORS Interoperation Server, vom Rational DOORS Web Access-Server und vom Nachrichtenbroker werden in den folgenden Verzeichnissen Protokolleinträge auf Informationsebene bereitgestellt:
  • DWA-INSTALLATIONSVERZEICHNIS\broker\data\activemq.log
  • DWA-INSTALLATIONSVERZEICHNIS\server\festival\logs
Informationen zur Generierung ausführlicher Informationen mit Protokollierung auf Debugstufe finden Sie bei den zugehörigen Links zur Rational DOORS Web Access-Protokollierung. Im Verzeichnis 'logs' befinden sich mehrere Protokolldateien. Beginnen Sie bei der Diagnose eines Problems mit den folgenden Dateien:
  • festival.log enthält jede Protokollnachricht, die vom Rational DOORS Web Access-Server geschrieben wurde.
  • request.log wird zum Überprüfen des Empfangs von Anforderungen verwendet. Dieses Protokoll ist bei Diagnoseprozessen hilfreich, die sich auf mehrere Anwendungen erstrecken.
  • response.log wird zum Bestätigen der Rückgabe von Antworten an die aufrufende Anwendung verwendet. Dieses Protokoll ist hilfreich, wenn bestätigt werden soll, dass die empfangene Anforderung ausgeführt und ein Ergebnis zurückgegeben wurde.
Fehlernachrichten werden abhängig von ihrem Ursprung in unterschiedliche Protokolldateien geschrieben. Die meisten Fehler werden in exception.log geschrieben, es können jedoch auch die anderen Fehlerprotokolldateien verwendet werden. Es gibt die folgenden drei Protokolldateien:
  • exception.log
  • error_view.log
  • error_misc.log

Protokollierung von Anwendungsnachrichten und das Dienstprogramm zur Datenerfassung

Mit Version 9.4 wurde die Protokollierung von Anwendungsnachrichten eingeführt, die auf Apache-log4cxx-Protokollservices basiert. Sie können diese Tasks ohne Neustart des Servers durchführen:
  • Protokolldateigröße begrenzen
  • Automatische Bereinigung für ältere Dateien einrichten
  • Format von Ausgabeprotokolldateien auswählen
  • Protokollebene und Protokollkonfigurationen ändern
Die Konfigurationsdatei wird in Abständen von 60 Sekunden zur Erfassung von Änderungen überwacht.

Es gibt fünf Protokollebenen (aufgelistet in aufsteigender Reihenfolge ihrer Priorität): 'Debug', 'Info', 'Warn', 'Error' und 'Fatal'. Auf jeder Protokollebene werden die Informationen für diese Ebene und alle höheren Ebenen protokolliert. Bei Verwendung der Ebene 'Warn' sind zum Beispiel die Informationen der Modi 'Warn', 'Error' und 'Fatal' eingeschlossen.

In älteren Versionen von Rational DOORS waren zu Beginn der Fehlerbehebungsphase eine manuelle iterative Zusammenstellung von Umgebungs- und Ressourcendaten sowie Diagnoseprotokolle erforderlich. Mit der Einführung der Anwendungsnachrichtenerstellung in Version 9.4 können Sie in der Befehlszeile ein Datenerfassungstool ausführen, um Protokolle zu erfassen, die gemäß den Konfigurationsanweisungen für die Anwendungsnachrichtenerstellung generiert wurden. Vom Datenerfassungstool werden ebenfalls drei Textdateien erstellt:
  • readme.txt verdeutlicht die Verwendung, wenn das Problem auftritt.
  • problemDetails.txt ist eine Vorlagendatei, in die Sie Details zu einem Problem manuell eingeben können.
  • collectedInformation.txt ist ein Datensatz der automatisch erfassten Informationen zum Betriebssystem, zur Produktinformation von Rational DOORS, zu den unterstützten DLL-Dateien (DLL = Dynamic Linked Library) und zur Datei config.ini.
Informationen zum Einrichten von Protokolldateien finden Sie in den folgenden Abschnitten:

Videosymbol Videos ansehen

CLM-Playlist
Jazz.net-Kanal
Kanal für die Benutzerschulung

Lernsymbol Weitere Informationen

CLM-Lernkreis
Agiles Know-how - Lernkreis
Lernkreise

Fragesymbol Fragen stellen

Jazz.net-Forum
developerWorks-Foren

Unterstützungssymbol Unterstützung anfordern

Support Portal
Bereitstellungs-Wiki
Support-Blog