Metric binding to resources

  • Release version: Zurich
  • Updated July 31, 2025
  • 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 in ServiceNow's Metric Intelligence allows you to bind metric series not only to Configuration Items (CIs) but also to specific resources within those CIs, such as disks or web pages. This enhances the granularity and efficiency of metric monitoring, especially when multiple similar resources exist within a single CI.

    Show full answer Show less

    Key Features

    • Two Binding Methods:
      • CI/Metric: Binds metrics directly to the CI (e.g., winserver001/responsetimemean).
      • CI/Resource/Metric (Resource Binding): Binds metrics to specific resources within a CI (e.g., winserver001/Disk — C/diskusage), enabling more detailed tracking.
    • Resource Binding Use Cases: Ideal for monitoring entities that do not exist as CIs in the CMDB, such as individual disks, processors, network interfaces, or KPIs for web pages within applications.
    • Aggregation Benefits: Enables meaningful aggregation across similar resources, like average disk usage across all disks on a host.
    • Automated Binding Process: The MID Server generates metric binding events that are processed to identify and bind to the appropriate CI and resource. If the resource does not exist, it is created automatically.
    • Resource Hierarchy and Tables: Resource binding relies on a hierarchy of resource tables derived from the CMDB, including tables like ciresourcehardware, ciresourceappl, and others installed with Metric Intelligence.

    Configuration and Management

    • Ensure the system property sa.metric.use.resource.binding is set to true (this is the default).
    • For metrics bound to resources, populate the resourcepath attribute either through event rules that add it to the additional information field or by including it as part of the CI identifier sent to the MID Server.
    • Review and adjust mappings between CI classes and resource classes in the CI Type To Resource Class [sacitypetoresourceclass] table before processing data. Managing this table requires the evtmgmtadmin role.

    Practical Benefits for ServiceNow Customers

    This capability allows you to monitor detailed metrics at a resource level within CIs, improving the accuracy and granularity of performance data. It supports effective metric aggregation and better insight into resource-specific issues, even when those resources are not represented as independent CIs in your CMDB. Proper configuration ensures seamless integration of resource metrics into your monitoring and analysis workflows.

    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 Creating 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