PH47518: INCORPORATE WEBSPHERE WEBSERVER PLUG-IN MODULE STATES INTO LOGGING

APAR status

• Closed as new function.

Error description

• Incorporate WebSphere WebServer Plug-in module states into
  logging
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:  All users of IBM HTTP Server                *
  ****************************************************************
  * PROBLEM DESCRIPTION: Extend diagnostic logging to            *
  *                      incorporate                             *
  *                      more detailed information about the     *
  *                      WebSphere Plug-in.                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  1. mod_mpmstats is enhanced to summarize the average elapsed
  response time and internal WebSphere Plugin
  processing state for running requests
  Example output:
  ´mpmstats: bsy: 7 in mod_was_ap2_http.c (AV 2462, CN 5, SR 0,
  SB
  0, WR 2, RR 0, RB 0)´
  Legend:
  - AV: The average time, in milliseconds, that the currently
  running requests in the WAS plugin have been executing
  - CN: The WAS Plugin is establishing a backend connection.
  - SR: The WAS Plugin is sending the request
  - SB: The WAS plugin is sending the request body
  - WR: The WAS plugin is reading the first line of the response
  - RR: The WAS plugin is reading the response headers
  - RB: The WAS plugin is reading and forwarding the response
  body
  In the example output above, there are 7 threads in the WAS
  Plugin that on average have been running for 2.4
  seconds. 5 of the 7 threads are establishing a connection, and
  2
  are waiting on the HTTP status code.
  Note: This information was already visible in /server-status on
  a per-request basis.
  2. A subset of the  WebSphere Plugin state information is
  available to log in the IHS access log by using the "TP"
  prefix on the state names seen above and can be added to
  LogFormat, CustomLog, or GlobalLog like other environment
  variables:
  %{TPCN}e
  %{TPSB}e
  %{TPWR}e
  %{TPRB}e
  When logged in this way, the value is the amount of time in
  milliseconds spent in this state for the request being
  logged. If a state is repeated, the time spent in each try will
  be comma-separated.
  The states SR and RR are not currently loggable in this way.
  

Problem conclusion

• IHS was updated to incorporate the state into mod_mpmstats outpu
  and to make the elapsed time of the most important states
  available for logging.
  
  The fix for this APAR is targeted for inclusion in IBM HTTP
  Server fix packs 8.5.5.23 and 9.0.5.14. For more information, se
  'Recommended Updates for WebSphere Application Server':
  https://www.ibm.com/support/pages/node/715553
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  IBM HTTP SERVER

• Fixed component ID

  5724J0801

Applicable component levels