Database Reference
In-Depth Information
The root element is
TargetCollection
, and its
TYPE
attribute should match the type attribute of the
TargetMetadata
root element from the target type metadata XML file (
sample_host1
). The
TargetCollection
element contains a number of
CollectionItem
elements, and each
CollectionItem
element matches to a
Metric
element in the target type metadata file. The
NAME
attribute of
CollectionItem
should match the metric name.
There is also a way to group the collection of multiple metrics in the same collection item when the same
collection frequency or metric collection order is required. This is done by including
MetricColl
elements (one
per metric) inside a
CollectionItem
(for example, the collection item
"Perf")
. In this case, the
NAME
attribute of
the child
MetricColl
elements should match metric names as in the example (
"CPUPerf"
,
"MemoryPerf"
, and
"CPUProcessorPerf")
. See the
Oracle Enterprise Manager Cloud Control Extensibility Programmer's Reference
(Chapter 3, Section 3.5.1).
For each collection item, we can define a
Schedule
child element that typically includes an
IntervalSchedule
child element indicating the frequency of the collection by using the numerical attribute
INTERVAL
and string attribute
TIME_UNIT
. The latter can be set to
Sec
,
Min
,
Hr
, or
Day
, and default to
Min
. As this is a default collection definition,
this setting represents the initial default frequency. EM12c users can modify collection intervals, as for any other
metrics, and plug-in developers can set the limits on those settings by using the
MIN_INTERVAL
and
MAX_INTERVAL
attributes of the
IntervalSchedule
element. Other scheduling options are also available, such as running on a certain
day of the month or week. They are not documented in the extensibility guides, but you can see the XML Schema
documentation from
<EDK>/doc/partnersdk/mrs/emcore/default_collection
for additional options, and you can
also see them in the console when modifying a collection schedule.
If the schedule is not defined for a metric, this metric will not be automatically collected by the agent except
when an EM12c user opens the real-time metric view, in which case OMS requests the collection from the agent each
time the real-time view is refreshed. Whether or not the initial collection schedule is defined in the default collection
file, the schedule can be customized in the EM12c console. You use the All Metrics view of a target, as shown in
Figure
10-11
for the collection item named
"Perf"
(shown earlier in Listing 10-13).