Metric binding to resources

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 3 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Metric Binding to Resources

    Metric binding to resources allows you to simplify the binding of metric events to specific resources, such as disks or web pages, in addition to configuration items (CIs). This process utilizes two binding formats: 'CI/Metric' and 'CI/Resource/Metric' for more granular monitoring. The second format, known as resource binding, is particularly efficient for entities with multiple similar resources, enabling better data aggregation and querying.

    Show full answer Show less

    Key Features

    • Binding Formats:
      • 'CI/Metric': For binding metrics to a CI.
      • 'CI/Resource/Metric': For binding metrics to a specific resource within a CI.
    • Resource Binding Efficiency: Facilitates meaningful aggregations across similar metrics, such as average disk usage across all disks.
    • Automatic Resource Creation: If a resource does not exist during binding, it can be automatically created.

    Key Outcomes

    Utilizing metric binding to resources helps in accurately monitoring specific entities that may not exist in the Configuration Management Database (CMDB). This results in enhanced data aggregation and insights, especially for metrics pertaining to individual web pages or hardware components.

    Configuration Steps

    • Ensure the sa.metric.use.resource.binding system property is set to true.
    • Populate the resourcepath attribute through event rules or while sending data to the MID Server.
    • Review and adjust the mappings in the CI Type To Resource Class table to match your monitoring needs.

    Resource Tables

    Metric Intelligence installs several resource tables that extend the CI Resource table, enabling a hierarchical structure for resource management.

    Mapping CIs to Resources

    Mappings between CI classes and resource classes are stored in the CI Type To Resource Class table, which is crucial for effective metric binding.

    Bind metrics to resources to simplify metric events binding by enabling binding to resources such as specific disks or web pages, in addition to binding to CIs.

    Metric Intelligence models metric series in either of the following methods:
    • Binding a metric series to a CI and to the metric being monitored for that CI using a 'CI/Metric' format. For example, 'win_server_001/response_time_mean'.
    • Binding a metric series to a CI, a resource within that CI, and the metric being monitored for that resource, using a 'CI/Resource/Metric' format. For example, 'win_server_001/Disk — C/disk_usage'. This method is referred to as resource binding.
    The first method enables modeling, storing, aggregating, and querying data at the CI level. However, resource binding creates resource records for specific monitored entities, such as an individual web page or a disk. Therefore, resource binding is more efficient when there are multiple resources of similar types within a CI, and metrics applicable to a category of these resources are mapped to these resources.
    Use cases:
    • Common examples are disks, processors, and network interfaces. In cases in which these entities are being monitored but do not exist in the CMDB, using resources for metric binding is useful.
    • Some monitoring solutions capture metric data within services such as KPIs for individual web pages in an application. In such cases where the entity being monitored is not a configuration item, metric binding to resources can be helpful.
    In those situations, using resource binding results in more meaningful aggregations across similar metrics (such as: avg disk_usage for a host across all disks).

    Resource binding process

    The MID Server generates metric binding events that are processed by the instance. When processing a metric binding event, there is an attempt to identify the CI to which this metric binding event belongs. If this attempt is successful, then the metric binding event is bound to the identified CI and binding to a resource is attempted. The following steps describe the attempt to bind a metric binding event to a resource:
    1. Identify the CI class of the CI that was bound to the metric binding event.
    2. Locate the resource class which is mapped to that CI class (using the CI Type To Resource Class [sa_ci_type_to_resource_class] table).
    3. Read the resource_path attribute value in the additional_information field in the metric binding event.
    4. Check if a resource record exists in the resource class table, in which name is equal to resource_path and cmdb_ci is equal to the CI that was bound to the metric binding event.
    5. If such resource record exists, then the metric binding event is bound to that resource. Otherwise, a new resource record is created with the preceding values and the metric binding event is bound to the newly created resource.

    Configure resource binding

    • Ensure that the sa.metric.use.resource.binding system property is set to true (default).
    • For series intended to be bound to resources, ensure that the resource_path attribute is populated by doing either step:
      • Use an event rule to add the resource_path attribute to the Additional information field in events. For more information, see Create an event rule to map metrics to specific CIs.
      • Populate the resource_path attribute as a part of the respective CI identifier when data is sent to the MID Server for processing.
    • Review the default mappings in the CI Type To Resource Class [sa_ci_type_to_resource_class] table and adjust as needed. It is critical that mappings are set as desired prior to data processing.

      Managing the CI Type To Resource Class table requires the evt_mgmt_admin role.

    Resource tables

    Resource binding uses an underlying hierarchy structure of resources which is a subset of the [cmdb_ci] hierarchy. Metric Intelligence installs the following resource tables:
    • CI Resource [ci_resource] (parent table):
    • Tables that extend CI Resource [ci_resource]:
      • ci_resource_hardware
      • ci_resource_appl
      • ci_resource_service
      • ci_resource_vm_object
      • ci_resource_database

    Mapping CIs to resources

    Mappings of CI classes to resource classes are stored in the CI Type To Resource Class [sa_ci_type_to_resource_class] table. This table is installed with Metric Intelligence, and is used during metric binding to resources.

    Table 1. Mappings in the CI Type To Resource Class table (default)
    CI class Resource class
    cmdb_ci_hardware ci_resource_hardware
    cmdb_ci_appl ci_resource_appl
    cmdb_ci_service ci_resource_service
    cmdb_ci_database ci_resource_database
    cmdb_ci_vm_object ci_resource_vm_object