IBM Support

PH38048: PROMETHEUS ENDPOINT ENHANCEMENTS FOR PERFORMANCE MONITORING INFRASTRUCTURE METRICS ON WEBSPHERE APPLICATION SERVER TRADITIONAL

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as new function.

Error description

  • This is a collection of enhancements to the metrics.ear
    application released in the previous fixpack.
    
    1. In addition to the pre-existing node and server labels for
    each metric, a cell label should be added as well.
    2. The ability to omit cell/node/server labels should be provide
    via a system property.
    3. Add a timeout for the server metrics scraping, so if one of
    the servers is particularly slow in responding, and the /metrics
    response time can be large and Prometheus times out, a response
    still be send back to Prometheus, even if that means some server
    data could be omitted from the response.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:  All users of IBM WebSphere Application      *
    *                  Server                                      *
    ****************************************************************
    * PROBLEM DESCRIPTION: Prometheus endpoint enhancements for    *
    *                      the                                     *
    *                      Performance                             *
    *                      Monitoring Infrastructure (PMI)         *
    *                      metrics.ear application                 *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    A collection of enhancements was added to the metrics.ear
    application:
    - In addition to the pre-existing node and server labels for
    each metric, a cell label was added to the Prometheus output.
    - The ability to omit cell/node/server labels via a system
    property
    (com.ibm.ws.pmi.prometheus.includeCellNodeServerLabels=false)
    - Added a timeout for server metrics scraping, so if one of
    the servers is particularly slow in responding, the /metrics
    response time will be large and Prometheus will eventually time
    out, with no response. With this timeout, a response will
    still be send back to Prometheus, even if that means some server
    data could be omitted from the response. The server scrape
    timeout
    value can be configured via a system property
    (com.ibm.ws.pmi.prometheus.serverScrapeTimeout), where the
    default
    is 8 seconds. If the value is set to 0 or a negative value, no
    timeout value is set for the server scrapes.
    

Problem conclusion

  • The code was updated to include the enhancements.
    
    The fix for this APAR is targeted for inclusion in fix pack
    8.5.5.20 and 9.0.5.9. For more information, see 'Recommended
    Updates for WebSphere Application Server':
    https://www.ibm.com/support/pages/node/715553
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH38048

  • Reported component name

    WEBS APP SERV N

  • Reported component ID

    5724H8800

  • Reported release

    850

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-06-11

  • Closed date

    2021-07-01

  • Last modified date

    2021-07-01

  • 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

    WEBS APP SERV N

  • Fixed component ID

    5724H8800

Applicable component levels

  • R850 PSY

       UP

  • R900 PSY

       UP

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"850"}]

Document Information

Modified date:
16 July 2021