Thank you for your feedback.
Form temporarily unavailable. Please try again or contact to submit your comments.

CMDB groups

Log in to subscribe to topics and get notified when content changes.

CMDB groups

A CMDB group is a collection of CIs that lets you apply CI actions collectively to all the CIs that are members in the group. For example, a CMDB CI Lifecycle Management API can use a CMDB group scriptable API to retrieve the group's list of CIs, and then apply a CI Lifecycle Management action collectively to all the CIs.

Group type

A CMDB group is configured with a group type. If a CMDB group is set with the Health group type, then the CIs in the group can be monitored by CMDB Health, and the aggregated health is reported for the group as a whole in the CMDB group view dashboard. For example, you can monitor health only for CIs in a specific location.

Populate a CMDB group

Depending on the group type, you can populate a CMDB group by manually adding individual CIs, selecting saved CMDB queries, or building encoded queries in the CMDB group itself. The resulting CIs from each query are added as members to the group.

Before you begin

Roles required:
  • To view CMDB groups - itil
  • To use a CMDB queries - cmdb_query_builder on top of itil
  • To manually add CIs - itil or asset

Also, to populate a CMDB group using a CMDB query, a saved CMDB query must exist.


  1. Navigate to Configuration > CMDB Group.
  2. In the CMDB Groups pane click New.
  3. Fill out the form, right-click the title bar and select Save.
    Table 1. CMDB Group form
    Field Description
    Group Name A unique name for the group.
    Group type
    • Default: Basic group type which can be populated by manually adding CIs, saved queries, and encoded queries.
    • Health: Sets CMDB Health to monitor the health of the group CIs and aggregate health results for the group as a whole. Can be populated only by encoded queries.
      Note: Dynamic filters are not supported when populating this type of CMDB groups.
  4. To use saved CMDB queries:
    1. Click CMDB Group Contains Saved Queries and then click Add Query.
    2. Select a query from the Query Builder Saved Query list.
    3. Click Submit.
    The query that is used returns a list of CIs of the class in the start node of the query.
  5. To manually add CIs:
    1. Click CMDB Group Contains Configuration Items and then click Edit Manual CI.
    2. Optionally add filters.
    3. Select CIs in the Configuration Item list and click the '+' icon at the bottom.
    4. In the Group members list, select the CIs to add to the group.
    5. Click Save or Save and Exit.
    6. In the Save Confirmation dialog box, click OK.
    7. Click Submit.
  6. To use encoded queries:
    1. Click CMDB Group Contains Encoded Queries and then click New.
    2. Select a class for which the encoded query applies to and add conditions to build a query. The resulting CIs are included in the group.
      Note: Dynamic filters are not supported for CMDB health-type groups, even though it is possible to add them in a condition clause.
    3. Click Submit.

What to do next

Click Show All CI to display all CI members of the group.

Show CI Lifecycle Management details for CMDB group CIs

Display CI Lifecycle Management operational state and CI actions that apply to the CIs that are members of a CMDB group.

About this task

If the CMDB group is based on a CMDB query, then the query runs in real-time and displays the resulting CIs. If the query does not complete successfully due to timing out or for other reasons, then appropriate error messages are displayed.


  1. Navigate to Configuration > CMDB Groups.
  2. On the CMDB Groups page, click on a CMDB group.
  3. Click Show All CI.
    Field Description
    Configuration Item CI group member.
    Class Class of CI group member.
    Operational Status CI Lifecycle Management operational state of the CI such as 'Repair in Progress' or 'Operational'. Possible operational states are defined in the choice list of the Operational status field in the cmdb_ci table.
    Actions CI Lifecycle Management actions that apply to the CI such as 'Cloning' and 'Provision'. Possible actions are defined in the CMDB CI Actions [statemgmt_cmdb_actions] table.