To create a health rule on a custom metric in a single business transaction, node, or overall application performance, you specify the health rule type as custom and when you configure the condition component, in the Select Metric window, choose to Specify a Metric from the Metric Tree and select the metric from the embedded metric browser.
A different use case is to create a rule that evaluates a custom metric that exists across various entities, for example across several nodes. You want to do this with one health rule; you do not want to create a separate health rule for each node. In this case, you need to specify the custom metric using the relative metric path to the metric instead of selecting the metric from the embedded metric browser.
First, get the relative path to the metric and then configure the health rule using that relative path.
To specify Hardware Resources, JVM, and CLR metrics in multiple entities using a wildcard, you can use the procedure described in Use Wildcards in Metric Definitions.
The wildcard feature is not supported for custom metrics.
- Navigate to the Metric Browser by selecting the Metric Browser in the left navigation pane.
- Select the metric that you want to use for the condition.
- Right-click and select Copy Full Path.
- Save this value in a file from which you can copy it later.
The following example gets the metric path for the CPU %Busy metric for the Inventory Server tier. The CPU %Busy metric would be appropriate to use in a health rule that affects all the nodes in that tier.
- In the Overview panel of health rule wizard choose the health rule type for the kind of entity that you are monitoring.
- In the Affected Entities panel select the affected entity.
- When you create the condition component that uses the metric, in the Select Metric window choose Specify a Relative Path Metric.
- Crop the relative metric path that you saved from the metric browser by doing one of the following:
- For all health rule types except Node Health-Hardware, JVM, CLR or Custom, crop the path to use the metric name alone, for example, Average Wait Time (ms).
- For Node Heath-Hardware, JVM, CLR and Custom health rule types, crop the path to use everything after the entity, for example, after the Node name. In the example below, the cropped path would look like this.
- Paste the cropped relative metric path in the relative metric path field of the Metric Selection window.
- Click Select Metric.
