Versions Compared

Old Version 1

changes.mady.by.user Nadja Pollard

Saved on

compared with

New Version Current

changes.mady.by.user Nadja Pollard

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Uptime Infrastructure Monitor WebSphere performance servlet uses WebSphere's Performance Monitor Interface (PMI) infrastructure to retrieve performance information from a WebSphere web application server, which it then saves to an XML file.

By default, PMI is , by default, enabled on the WebSphere server and set to collect the performance metrics used by Uptime Infrastructure MonitorUIM. However, before Uptime Infrastructure Monitor UIM can start collecting information from a WebSphere server, the performance servlet must be deployed in the WebSphere directory that contains your web application. 

...

Metrics collected per EJB

The following metrics are collected per Enterprise JavaBean (EJB) on a WebSphere server: .

Explanation
MetricDescriptionModule
CreateCountThe number Number of times that the Enterprise JavaBeans that are running on the server were created.beanModule.creates
RemoveCountThe number Number of times that the EJBs were removed.beanModule.removes
PassivateCountThe number Number of times that EJBs were removed from the cache. Note that passivation preserves the state of the EJBs on the disk.beanModule.passivates
MethodCallCountThe total Total number of method calls that were made to the EJBs.beanModule.activates
MethodResponse TimeThe average Average response time, in milliseconds, on the bean methods.beanModule.avgMethodRt

...

Metrics collected per connection pool

The following metrics are collected per connection pool on a WebSphere server:
.

MetricDescriptionModule
ConnectionPoolSizeSize

Connection PoolSize

The size of the connection pool to the data source.connectionPoolModu leconnectionPoolModule.poolSize
FreePoolSi zeFreePoolSizeThe number Number of free connections in the pool.connectionPoolModu leconnectionPoolModule.freePoolSize
PercentUsedThe percentage Percentage of the connection pool that is currently in use.connectionPoolModu leconnectionPoolModule.percentUsed
WaitTimeThe average Average time, in milliseconds, that a connection is used. The average time is the difference between the time at which the connection is allocated and the time at which it is returned.    connectionPoolModu leconnectionPoolModule.avgWaitTime
CloseCountThe total Total number of connections that were closed.connectionPoolModu leconnectionPoolModule.numDestroys
Connection PoolCountConnectionPoolCountThe total Total number of connections that were created.connectionPoolModu leconnectionPoolModule.numDestroys
WaitingThre adCountWaitingThreadCountThe number Number of threads that are currently waiting for a connection. 
UseTimeThe average Average time, in milliseconds, that a connection is used. The average use time is the difference between the time at which the connection is allocated and that the time at which it is returned.    Modulemodule.useTime

...

Metrics collected by other means

The following metrics are collected from the WebSphere system, the Java Virtual Machine, the thread pool, or servlets: .

MetricDescriptionModule
CPUUsageThe percent Percent of CPU resources that were used since the last query.systemModule.avgCpuUtilization
HeapSizeThe total Total amount of memory that is available for the Java Virtual Machine (JVM).jvmRuntimeModule.totalMemory
UsedMemoryThe amount Amount of memory that is being used by the JVM.jvmRuntimeModule.usedMemory
ActiveCountThe number Number of currently active threads which are concurrently active.threadPoolModule.activeThreads
CommittedCoCommittedCountThe total Total number of committed global transactions that have been committed.transactionModule.

unt

 

globalTransCommitted
RolledBackCo untRolledBackCountThe total Total number of global transactions that have been rolled back.transactionModule.globalTransRolledBack
LiveCountThe number Number of servlet sessions that are currently cached in memory.servletSessionsModule.liveSessions
TimeSinceLas tActivatedTimeSinceLastActivatedThe differenceDifference, in milliseconds, between the previous and current access time stamps of a servlet session. This counter does not include session time out values.servletSessionsModule.timeSinceLastActivated
ServletPoolSizeThe average Average number of threads in the servlet connection thread pool. 

To deploy the performance servlet:

  1. On the WebSphere server, locate the following file:

...

  1. Code Block
    languagesql
    [install_root

...

  1. ]/perfServletApp.ear

...

  1. where [install_root
...
  1. ] 
...
  1.  is 
...
  1.  the 
...
  1.  directory 
...
  1.  under 
...
  1.  which 
...
  1.  WebSphere 
...
  1.  is 
...
  1.  installed.
...
  2. Copy the perfServletApp.ear file to the directory in which your web application is installed. For example:
...

  1.  Code Block
    languagesql
  1. [install_root
...
  1. ]/installedApps/
...
  1. 
[cell_name
...
  1. ]/DefaultApplication.ear/DefaultApplication.war/WEB-INF/classes
...
  1. where:
    1. [install_root
...
    1. ] 
...
    1.  is 
...
    1.  the 
...
    1.  directory 
...
    1.  under 
...
    1.  which 
...
    1.  WebSphere 
...
    1.  is 
...
    1.  installed.
...
    2. [cell_name
...
    1. ] 
...
    1.  is 
...
    1.  the 
...
    1.  name 
...
    1.  of 
...
    1.  the 
...
    1.  WebSphere 
...
    1.  node 
...
    1.  under 
...
    1.  which 
...
    1.  your 
...
    1.  Web 
...
    1.  application 
...
    1.  is 
...
    1.  installed.

The   above   steps   must   be   completed   for   each  web Web application  server to be monitored by Uptime Infrastructure Monitor.
\\
\\
If you are using WebSphere Application Server version 6, youserver that you want monitored by UIM.
If you are using WebSphere Application Server version 6, you will need to change two settings in the WebSphere management console to avoid an Access Denied error when UIM attempts to connect to the servlet to collect  will need to change two settings in the WebSphere management console to avoid an Access Denied error when Uptime Infrastructure Monitor attempts to connect to the servlet to collect  metrics:
  1. In the WebSphere management console, modify the following settings:
      ...
        1. Under Security - Secure administration, applications, and infrastructure
      ...
        1. . Turn on Application Security
      ...
        1. .
      ...
        1. Under Enterprise Applications - perfServletApp - Security role to user / group mapping
      ...
        1. . Turn off Everyone
      ...
        1. .
      2. Restart the server. Uptime Infrastructure Monitor UIM should now be able to connect to the servlet and gather performance metrics.