How to View the Java Metrics

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

• Database connection summary
• Discovery processing statistics
• Operations information

Performance Statistics

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

Log files are located in:

• UCMDB Browser Standalone: tomcat_folder\logs
• UCMDB Browser Embedded: UCMDB\UCMDBServer\runtime\log

By default, the interval at which the UCMDB Browser 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.

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)