The Default Metric Attributes page enables you to assign default values to the metric attributes. The values can be used when defining the policy rules on the Rules tab, and can also be overridden there.
Note: For examples and end-to-end workflow information on collecting metrics data, see Collecting and Viewing Metrics Data.
In the BSM Connector user interface, click in the toolbar. Then click Metrics >
Structured Log File.
Alternatively, double-click an existing policy to edit it.
Click Defaults to open the policy Default Metric Attributes page.
Each time a metric policy runs, it extracts raw data from its defined data source and builds a metric structure.
A metric structure consists of these attributes:
Basic attributes:
Data domain
The namespace of the integrated performance records, used in the Operations Agent store to avoid clashes.
Metric class
Defines the metric class under which the metric appears in the Operations Agent store and consumers.
Metric name
Defines the metric name under which the metric appears in the Operations Agent store and consumers.
Related CI
Used to identify an instance of a performance record and associates it with a concrete CI instance. For details on how to associate the Related CI with the values in the RTSM model, see Create a policy. For an example, see Example – Create a Metrics Policy.
Node
Used to identify a node-like CI to which the performance records are associated to.
Value
The actual performance value which is converted to 64-bit floating point number.
Time measured
The time stamp when the value was determined in the third-party system.
Advanced attributes:
Original metric name
The name of the metric as used on the third-party system.
Unit
The unit of the metric.
Integration id
An id, used to identify the source of the integration.
This task describes how to configure metric attribute defaults for all metrics collected by this policy.
Define the metric attributes common to all metrics collected by this policy, such as metric class and name. All metrics in the Basic tab marked with a * are required. Advanced attributes are optional.
Optional. Use the Sample Data tab to drag the input data references to the attribute boxes. Alternatively, you can type the reference directly into the attribute box.
Input data references use the following syntax: <$DATA:<InputReferenceField>>.
Field names originate from the structured log file pattern settings defined for the data source.
BSM Connector replaces the pattern matching field at runtime with the value of the specified field. If you insert a field value, the value will be used.
Note: The Sample Data tab is empty if no sample data has been loaded into the policy or if the sample data does not match the structured log file pattern specified in the source page. See also Configuring Data Source in Structured Log File Policies.
Optional. Use the Mappings tab to add mapping definitions to the attribute boxes.
Mappings are custom variables that you define in the Mappings page (see also Configuring Mappings in Structured Log File Policies (Event and Metrics Only) ).
Alternatively, type the custom variable into the attribute box using the following syntax:
<$MAP(<CustomVariable>)> where <CustomVariable> is the map name of the variable (for example, <$MAP(maphost)>
).
If the custom variable does not have a input data reference assigned, use the following syntax:
<$MAP(<CustomVariable>,<SourceValue>) where <SourceValue> can be one of the following:
Name of the input data reference, for example <$MAP(maphost)>,<$DATA:host>
The source value itself, for example <$MAP(maphost,Critical)>
Optional. Use the Operators tab to apply operators to the attribute values. Two functions are available:
<$MATCH()>
, to test a string or a variable against a pattern. The $MATCH function accepts three or four parameters:
- the input string
- the pattern definition
- the output string if pattern matches on the input string
- the output string if the pattern does not match (optional)
Example: The data of the input field hostname start always with "TEST" (for example "TESTABC"). The $MATCH function to use the string after "TEST" is as follows:
$MATCH(<$DATA:hostname>,TEST<*.prefix>,<prefix>)
<$DATETIME(FORMAT,VALUE)>
, to convert the format of dates from the common format to the UNIX systems time (Epoch time) format.
For detailed description of the format, see Pattern Matching in Policy Rules.
Note: To apply operators to the attribute values, you can drag and drop them to a text field in the left pane of the same policy editor page. The appropriate tooltips are shown while performing this operation, which describe the role of the dragged operator.
Optional. Use the Indicators tab to add indicators to the source or target value fields. After loading the indicators from the connected OMi server, the Indicators tab shows a hierarchy of configuration item types.
Optional. In the Policy Variables tab, add policy variables to
HP recommends to surround variables with quotation marks, for example "<$MSG_NODE>"
or "<$MSG_GEN_NODE>"
, at least for those variables whose values can contain space characters.
UI Element | Description |
---|---|
Data domain |
The namespace of the integrated performance records, used in the Operations Agent store to avoid clashes. Example: "BSMConnector" |
Metric class |
Defines the metric class. Metric class and metric name are concatenated as the metric name that appears in the Operations Agent store and consumers. Example: "Windows CPU Monitor" |
Metric name |
Defines the metric name. Metric class and metric name are concatenated as the metric name that appears in the Operations Agent store and consumers. Example: "CPU Utilization" |
Related CI |
Contains the CI that is related to the metric (for example, oraclesid01@@node.example.com or C:@@server.example.com). Use the format ![]() It is necessary to differentiate between CIs that have a Composition relationship to a node, and those that do not have such a relationship:
For more information about CI resolution in OMi, see the OMi User guide or online help. |
Node |
Used to identify a node-like CI to which the performance records are associated to. Example: "dbsys1.company.com" |
Value |
The actual performance value. It is automatically converted to a double-precision number. Example: 80 |
Time measured |
The time stamp when the value was determined in the third-party system, expressed in the following formats:
|
UI Element | Description |
---|---|
<Search Properties> ![]() ![]() |
Entered search string is used to find a pattern matching field . The list changes as you type; only matching items appear. To clear the search results, click |
![]() |
Find Matching Events. To find values that belong to more than one pattern matching field , select the value and click ![]() |
![]() |
Toggle Deduplication. Shows or hides duplicate values. |
Input Data Properties |
Shows all pattern matching fields that are extracted from the log file by using the OM pattern-matching language. Note: The Sample Data tab is empty if no sample data has been loaded into the policy or if the sample data does not match the structured log file pattern specified in the source page. See also Configuring Data Source in Structured Log File Policies. |
Values for <...> |
Displays the values of the pattern matching field selected in the Input Data Properties section. |
Description |
|
---|---|
<$MATCH(inputStr,patternDef,outputStr,outputStrNoMatch)> |
Tests a string or variable against a pattern. The $MATCH function accepts three or four parameters: - the input string - the pattern definition - the output string if pattern matches on the input string - the output string if the pattern does not match (optional) Example: The data of the input field hostname start always with "TEST" (for example "TESTABC"). The $MATCH function to use the string after "TEST" is:
|
<$DATETIME(FORMAT,VALUE)>
|
Converts regular dates to UNIX time (Epoch time). |
Description |
|
---|---|
![]() |
Refresh. Loads the configured indicators from the Note:
|
<Search …> |
Entered search string is used to search the indicators and highlight only the indicators containing the specified string. To search for indicators with specific text strings in the name, type the string in the <Search …> field and click the |
<Indicators> |
Hierarchy of configuration item types with associated health indicators (HIs), which are applicable for the event integration only, and event type indicators (ETIs). To insert an indicator with a state in a policy, drag and drop the indicator from the Indicators tab to the relevant field in the policy. |