How to View the Java Metrics for the UCMDB Browser module

You can use the Java Metrics to view the following information about the UCMDB Browser module:

  • Database connection summary
  • Discovery processing statistics
  • Operations information

Performance Statistics

The UCMDB Browser module automatically captures performance metrics and saves the data statistically in .csv files under the <CMS_UI_log_folder>\metrics folder.

Log files are located in:

  • CMS UI Standalone: tomcat_folder\logs
  • CMS UI Embedded: UCMDB\UCMDBServer\runtime\log

By default, the interval at which the UCMDB Browser module gathers performance metrics is 15 minutes.

To change the default interval (measured in minutes):

  • If Tomcat is started as a service:

    1. Run the CMS-Browserw.exe file.
    2. In the dialog box that opens, go to the Java tab, and add –DmetricInterval=X in the Java Options container, where X is a number of minutes.
  • If Tomcat is started by invoking .\ucmdbbrowser\bin\startup.bat:

    1. Create the setenv.bat file (if one has not already been created).
    2. Add the set CATALINA_OPTS=–DmetricInterval=X line to the setenv.bat file, where X is a number of minutes.

      Note If the variable CATALINA_OPTS already exists, just append the –DmetricInterval=X value to the variable, where X is a number of minutes.

  • If Tomcat is started by invoking ./ucmdbbrowser/bin/startup.sh:

    1. Create the setenv.sh file (if one has not already been created).
    2. Add the set CATALINA_OPTS=–DmetricInterval=X line to the setenv.sh file, where X is a number of minutes.

      Note If the variable CATALINA_OPTS already exists, just append –DmetricInterval=x to the existing value, where X is a number of minutes.

Note If you do not want the performance metrics to be gathered, the value of the –DmetricInterval parameter has to be 0.

The following table explains each column in the .csv files.

Column Information
t Timestamp (epoch)
count Number of invocations 1
max Max invocation duration 1
mean Average invocation duration 1
min Min invocation duration 1
stddev Standard Deviation of the values
p50 50% quantile 1 2
p75 75% quantile 1 2
p95 95% quantile 1 2
p98 98% quantile 1 2
p99 99% quantile 1 2
p999 99.9% quantile 1 2
mean_rate Average event rate (per second)
m1_rate Average event rate in the last minutes
m5_rate Average event rate in the last 5 minutes
m15_rate Average event rate in the last 15 minutes
rate_unit Unit for the rate (for example, calls/second)
duration_unit Unit for the durations (for example, seconds)

Note  

  1. All these values are collected since the last metric reset. Every 15 minutes after dumping the statistics to a CSV, the metrics (counters, durations) are reset to 0.
  2. A quantile is calculated by taking the entire data set, sorting it, and taking the value in the middle (or 1% from the end, for the 99th percentile). For example, the 75% quantile shows the median of the lower 75% values. These quantiles apply to the set of durations of each invocation.

Not all the counters are reset every 15 minutes, so their values keep growing and show overall counts since the system startup.

Captured Metrics

The following tables show the captured metrics.

Login statistics
Metrics

Measurement

Note
LoginService.<Step> Timer A breakdown of times in the Login process
LoginService.UIConfig.<Step> Timer A breakdown of times in the UIConfig process during login
LoginCount Counter A counter that shows the number of users that have logged in
SessionCount Counter The number of active sessions

 

Export statistics
Metrics

Measurement

Note
Export.Email.<Format> Timer A timer over the sending of scheduled reports/notifications by email
Export.UI.<Format> Timer A timer over the duration of exports

 

Search statistics
Metrics

Measurement

Note
Search.Legacy Timer A timer over the duration of a search using legacy search
Search.SOLR Timer A timer over the duration of a search using enhanced search
SearchCount Counter A counter over the number of searches

 

RPC calls statistics
Metrics

Measurement

Note
RPCCall.<Call> Timer A timer over the execution of specific RPC calls

 

EhCache statistics
Metrics Note
net.sf.ehcache.Cache.<ServerName> Shows information about the state of the Cache