Leistungsdaten für Request Metrics

Diese Seite beschreibt, wie Sie Leistungsdaten für Request Metrics im Tracedatensatzformat interpretieren.

[AIX Solaris HP-UX Linux Windows][z/OS]Die Tracedatensätze für Request-Metrics-Daten werden in zwei Protokolldateien ausgegeben, in der Protokolldatei für das Web-Server-Plug-in und in der Protokolldatei für den Anwendungsserver. Die Standardnamen für die Protokolldateien sind SystemOut.log und http_plugin.log. Sie können die Namen und die Position dieser Protokolldateien jedoch auch anpassen. Die Standardverzeichnisse für diese Protokolldateien sind:
  • [AIX Solaris HP-UX Linux Windows][z/OS]plugin_install_root/logs/web_server_name/http_plugin.log und install_root/profiles/profile_name/logs/server_name
  • [IBM i]plugin_install_root/logs/web_server_name/http_plugin.log und profile_root/logs/server_name
und
Das Format der Tracedatensätze in der Protokolldatei von WebSphere Application Server ist:
PMRM0003I: parent:ver=n,ip=n.n.n.n,time=nnnnnnnnnn,pid=nnnn,reqid=nnnnnn,event=nnnn
-
current:ver=n,ip=n.n.n.n,time=nnnnnnnnnn,pid=nnnn,reqid=nnnnnn,event=nnnn
           type=TTT detail=some_detail_information elapsed=nnnn

Das Format der Tracedatensätze in der Protokolldatei des Web-Server-Plug-ins lautet wie folgt:
PLUGIN:
parent:ver=n,ip=n.n.n.n,time=nnnnnnnnnn,pid=nnnn,reqid=nnnnnn,event=nnnn 
- current:ver=n,ip=n.n.n.n,time=nnnnnnnnnn,pid=nnnn,reqid=nnnnnn,event=nnnn 
           type=TTT detail=some_detail_information elapsed=nnnn bytesIn=nnnn
           bytesOut=nnnn

Das Format eines Tracedatensatzes besteht aus zwei Korrelationswerten: einem übergeordneten Korrelationswert und einem aktuellen Korrelationswert. Der übergeordnete Korrelationswert stellt die aufwärts gerichtete Anforderung dar, während der aktuelle Korrelationswert die aktuelle Operation darstellt. Wenn der übergeordnete und der aktuelle Korrelationswert gleich sind, stellt der Satz eine Operation dar, die beim Eintritt in WebSphere Application Server ausgeführt wird.

Zum Korrelieren der Tracedatensätze für eine bestimmte Anforderung erfassen Sie die Datensätze mit der Nachrichten-ID PMRM0003I aus den Protokolldateien des entsprechenden Anwendungsservers und den Tracedatensatz PLUGIN aus der Protokolldatei des Web-Server-Plug-ins. Die Sätze werden korreliert, indem man aktuelle Korrelationswerte mit übergeordneten Korrelationswerten abgleicht. Der logische Baum kann erstellt werden, indem man die aktuellen Korrelationswerte übergeordneter Tracedatensätze mit den übergeordneten Korrelationswerten von untergeordneten Tracedatensätzen verbindet. Dieser Baum zeigt das Fortschreiten der Anforderung durch den Server-Cluster. Weitere Informationen finden Sie im Artikel Ein Beispiel für den Transaktionsablauf finden Sie im Artikel Einsatzmöglichkeiten für Request Metrics.

Der übergeordnete Korrelationswert steht in den durch Kommas getrennten Feldern nach dem Schlüsselwort "parent:". Dementsprechend steht der aktuelle Korrelationswert in den durch Kommas getrennten Feldern nach dem Schlüsselwort "current:".

Die Felder der übergeordneten und aktuellen Korrelationswerte lauten wie folgt:
  • ver: Die Version des Korrelationswertes. Der Einfachheit halber wird sie für die übergeordneten und aktuellen Korrelationswerte dupliziert.
  • ip: Die IP-Adresse des Knotens des Anwendungsservers, der den Korrelationswert generiert hat. Wenn das System mehrere IP-Adressen hat, verwendet Request Metrics eine der IP-Adressen, um das System zu identifizieren.
  • pid: Die Prozess-ID des Anwendungsservers, der den Korrelationswert generiert hat.
  • time: Der Startzeitpunkt des Anwendungsserverprozesses, der den Korrelationswert generiert hat.
  • reqid: Eine ID, die der Anforderung von Request Metrics nur für den Anwendungsserverprozess zugeordnet wird.
  • event: Eine zugeordnete Ereignis-ID zur Unterscheidung der tatsächlichen Traceereignisse.
Den übergeordneten und aktuellen Korrelationswerten folgen die Metrics-Daten für die zeitgesteuerte Operation:
  • type: Ein Code, der den Typ der zu steuernden Operation angibt. Die unterstützten Typen sind: HTTP, URI, EJB, JDBC, JMS, COMMONJ_WORK_POOLED, COMMONJ_TIMER, Web-Service-Anforderer und Web-Service-Provider.
  • detail: Der Name der zu planenden Operation. (Lesen Sie die folgende Beschreibung zu Universal Resource Identifier (URI), HTTP, EJB, JDBCJ, JMS, Asynchrone Beans und Web-Services.)
  • elapsed: Die gemessenen abgelaufenen <Zeiteinheiten> für diese Operation, einschließlich aller Teiloperationen, die für diese Operation aufgerufen werden. Die abgelaufene Zeit wird in Millisekunden gemessen.
  • bytesIn: Die Anzahl Bytes aus der vom Web-Server-Plug-in empfangenen Anforderung.
  • bytesOut: Die Anzahl Bytes aus der vom Web-Server-Plug-in an den Client gesendeten Antwort.
Die folgenden Typen- und Detailfelder werden beschrieben:
  • HTTP: Das Web-Server-Plug-in generiert den Tracedatensatz. Das Detail gibt den Namen des URI an, der zum Aufruf der Anforderung verwendet wird.
  • URI: Der von einer Webkomponente generierte Tracedatensatz. Der URI ist der verwendete URI-Name zum Aufrufen der Anforderung.
  • EJB: Der vollständig qualifizierte Paket- und Methodenname der Enterprise-Bean.
  • JDBC: Der Schnittstellenname und der Methodenname für diesen JDBC-Aufruf.
  • JMS: enthält Einzelheiten für verschiedene JMS-Parameter.
  • Asynchrone Beans: Das Detail gibt den Namen der asynchronen Beans an. Es gibt zwei Typen von asynchronen Beans: COMMONJ_WORK_POOLED und COMMONJ_TIMER.
  • Web-Services: Web-Services enthalten Einzelheiten zu verschiedenen Web-Service-Parametern. Es gibt zwei Typen von Web-Services: Web-Service-Anforderer und Web-Service-Provider.
  • SIB: Wird für die Instrumentierung im Service Integration Bus mit Nachrichtenübertragung (senden/empfangen) und Mediation verwendet.
  • JCA: J2EE Connector Architecture. Das Detail gibt den Namen der Klasse an, in der der JCA-Aufruf abgesetzt wird.
  • JNDI: Wird für JNDI-Namenssuchen verwendet. Das Detail gibt den JNDI-Namen an.
  • JMS send and receive: Generiert den Tracedatensatz aus Nachrichten zu JMS-Sende- und Empfangsoperationen.
  • SIB send and receive: Generiert den Tracedatensatz aus Nachrichten zu SIB-Sende- und Empfangsoperationen.

[z/OS]Wenn mehrere Servantregionen für einen Anwendungsserver vorhanden sind, sind auch mehrere Dateien SystemOut.log vorhanden, eine für jede Servantregion. Deshalb zeichnet Request Metrics die Tracedatensätze möglicherweise in mehreren Dateien SystemOut.log auf. Die Servantregion, die eine Anforderung bearbeitet, zeichnet die relevanten Datensätze in ihrer Datei SystemOut.log auf. Die PID im aktuellen Request-Metrics-Korrelator ist die PID für die zugehörige Servantregion. Wenn das System mehrere IP-Adressen hat, könnte die IP-Adresse im Korrelator eine dieser Adressen sein. Der Korrelator muss jedoch dieselbe IP-Adresse für die Servantregion verwenden.

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.

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



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