Smart Plug-in for WebLogic Server User's Guide

Chapter 5: WebLogic Server SPI User Defined Metrics
Introduction to User Defined Metrics
5-3
The MetricDefinitions Element
Within the WLS-SPI MetricDefinitions.dtd file, the MetricDefinitions
element is the top-level element within the document. It contains one collection
of metrics, consisting of one or more metric definitions.
<!ELEMENT MetricDefinitions (Metrics)>
<!ELEMENT Metrics (Metric+)>
TheMetricElement
The Metric element represents one metric. Each metric has a unique ID (for
example, “WLSSPI_0701”). If a user-defined metric is an alarming or reporting
metric, the metric ID must be "
WLSSPI_0xxx"wherexxx must be a number
from 700 through 799. Otherwise, if the metric is used only within the
calculation of another metric, the metric ID must begin with a letter
(case-sensitive) and can be followed by any combination of letters, numbers, and
underscores.
A Metric element contains one or more elements that represent the metric data
source. Two data sources are supported: Mbeans and calculations.
<!ELEMENT Metric (MBean+ | Calculation+)>
<!ATTLIST Metric id ID #REQUIRED
name CDATA ""
alarm (yes | no) "no"
report (yes | no) "no"
graph (yes | no) "no"
previous (yes | no) "yes"
description CDATA #IMPLIED >
Metric element attributes are described in the following table.
Attribute Type Required Default Description
id
ID yes
--
ThemetricID.
name
Text no
"no"
The metric name, used for
graphing and reporting.