Get Started > Configuration and Administration > How to View the Java Metrics

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.

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.