ASAP 2.7 Extension Manual

Configuring the ASAP Extension
HP NonStop ASAP Extension Manual—425265-004
2-8
Configuring DataItems and Metrics
Configuring DataItems and Metrics
The ASAP Extension works with two forms of data:
•
The application data structure allocated to each registered domain within the
shared memory segments. This structure contains up to 12 DataItems—internal
counters or other data units that application processes can use to record statistics
about their registered domains.
•
The ASAP Extension-generated metric. This value is produced and reported for
each domain from the set of DataItems. Using ASAPX, you manipulate the
application DataItems to generate metrics.
For example, you define one DataItem to ASAPX, a transaction counter that is updated
by applications each time a transaction completes successfully. You can then
manipulate the transaction counter to produce metrics at each statistics interval. In this
example, you might define two metrics: the pure transaction count during the interval
and a transaction rate, which is the count of transactions over the number of seconds
in the interval.
Application DataItems and metrics are different:
•
DataItems are the application data structure values that the application updates
within the shared memory segment.
•
Metrics are the data values that the ASAP Extension generates at each sample
interval then stores in the ASAP database. The ASAP Client retrieves metrics for
display as graphs and reports to operations. Metrics are defined as EDL attributes.
Configuring DataItems
DataItems are the internal counters or other data units recorded by applications using
the API procedures of the ASAP Extension. DataItems can be any of:
•
Integer values, which can represent anything
•
Time units, in seconds, milliseconds, or microseconds
•
Constants, reported directly by applications
•
8-byte strings of printable ASCII text
You can predefine up to 12 DataItems using the EDL DataItems property. They are
defined across the application to provide commonality and consistency in reporting,
graph windows, and alerts.
ASAPX maintains all application DataItems in a common structured data format in
shared memory. The format consists of a header portion containing properties
pertaining to the entire structure, and a data portion containing the metrics.
The data portion of the application structure contains 12 64-bit DataItems that the
applications can use in many ways to provide service-level statistics. The 64-bit values