Smart Plug-in for WebLogic Server User's Guide

5-12
Chapter 5: WebLogic Server SPI User Defined Metrics
Introduction to User Defined Metrics
"
count returns the number of instances of a multi-instance metric.
The following example could be used to define a metric that is a rate (number of
times per second) for Metric_1.
<Formula>(delta(Metric_1)/interval(Metric_1))*1000</Formula>
Create User-defined Metrics
Now that you have reviewed the structure required for creating UDMs, the
section below shows the tasks to complete. A sample WLS-SPI metric
definitions file follows this section to provide you with a reference for how the
syntax looks in an actual file and is included on the management server in
/var/opt/OV/wasspi/wls/conf/udmmerics_sample.xml.
TASK 1: CREATE A UDM METRIC DEFINITIONS FILE.
The UDM file must be an XML file that follows the format defined by the metric
definitions DTD file described in the preceding section. The DTD file is named
MetricDefinitions.dtd and is located in the /conf/ directory.
NOTE Because the WLS-SPI DTD file (MetricDefinitions.dtd)isusedat
runtime, you should not edit, rename, or move it.
In addition, refer to the sample metric definitions file on page 5-16
TASK 2: ADD THE FILE NAME AND LOCATION TO THE
CONFIGURATION FILE
.
In order for the UDM data collection to occur, the WLS-SPI configuration file
must include the name of the user-defined metrics file and its location, preceded
by the its identifying keyword as shown below:
UDM_DEFINITIONS_FILE = <full path of user metric definitions file>