Using the Groups feature, you can logically organize resources by resource attributes to perform actions collectively. You can create multiple resource groups or nested resource groups.

view resource group listing page

To navigate to the Groups page:

  1. Log in to OpsRamp.

  2. Go to Infrastructure > Groups from the top menu.

You can do the following from the Resource Groups page:

  • Create a resource group
  • View a resource group
  • Edit a resource group
  • Remove a resource group
  • View logs
  • Schedule maintenance periods

Create a resource group


Prerequisite: You must have Manage Device permission to create a resource group.

Follow these steps to create a resource group:

  1. Go to Infrastructure > Groups from the top menu.

  2. Click the Settings icon and then click Add. The CREATE RESOURCE GROUP page is displayed.

  3. In the Group Name field, give a name to the group.

  4. (Optional) In the Description field, add a description for the resource group.

  5. (Optional) Select the option Add members automatically using filter criteria to add resources to the resource group dynamically.

  6. Add resources to the group using the following filter criteria options:

    1. Click Any or All to match any one or all of the defined conditions for filtering.
    2. Select the options for the following filter criteria fields:
      • Resource Type: Lists all the supported resource types. Select a resource type from the list.
      • Attribute Name: Lists the attributes for the type of resource selected. Attributes vary according to the resource type chosen.
      • Logic condition: Logical match criterion to enhance search results. Options: Contains, Not Contains, Equals, Not Equals, Starts With, Ends With, and regex.
      • Value: Value corresponding to the attribute name and logic condition.
    3. Click +Add to include more filter criteria.
    4. Click Show Matching Members to see a list of all the devices matching the criteria.

  7. Add resources to the group using query language specifying your requirements, in the Add Using Query section. To enter a query: Type “$” followed by a resource attribute. Once you type “$” the resource attributes are auto-populated.
    Examples of resource attributes: IP Address, DNS Name, Host Name, and so on.
    Select the attribute followed by a space and key operator value.
    Examples of key operator value: “<”, “>”, “=”, “IS”, “contains”, “IS NOT NULL”, “IN”, and so on.
    Give a space after you select/enter the key operator value and enter the Value enclosed in double quotes. You can give multiple queries. Use AND or OR condition between the queries, as needed.
    A green tick after entering a query indicates that the query is valid. A forbidden icon indicates that the query is incomplete or the format is incorrect.
    Click the search icon. The number of resources that match the query is displayed. Click Show Matching Results. Resource list is displayed with Name, IP Address, and Resource Type details.
    Note: When using REGEX and REGEX NOT:

    • avoid using square brackets with \d or \s

      For example:

      • $name REGEX "a[\s+].*"
        This expression can be written as $name REGEX "a\s+.*"

      • $name REGEX "a[\d+].*"
        This expression can be written as $name REGEX "a\d+.*"

    • avoid using ^ and $ in attribute value.

      For example:

      • $name REGEX "^abc.*"
        This expression can be written as $name REGEX "abc.*"

      • $name REGEX ".*abc$"
        This expression can be written as $name REGEX ".*abc"

  8. Select one or multiple devices from the Add Device section, and click the right arrow to add to the resource group. You can also select the resource type from the dropdown and add the resources.

  9. Click Save.

The resource group is created.

The Groups page is divided into the following:

  • Category: The left pane displays the ungrouped category of resources. The number indicates the total number of resources that are not part of any group. Once a group is created, it will appear in the list.
  • Search box: Displays Search options. You can directly type the resource name or IP Address or enter the search criteria, to search for resources.
  • Settings: You can use the Settings option to add or remove columns. It provides options to add a device, unmanage a device, assign templates, and so on.
  • Refresh: To refresh the resource listing.
  • Resource attributes: Click on a group name or on the Ungrouped category. A list of resources is displayed. By default, details such as Name, Host Name, IP Address, Operating System, Consoles, Last Updated(IST), Traits are displayed.

Example

The following is an example of how Filter Criteria and Add Using Query features work:

Resource group filters

The resource group is created using two different resource types that are provided as filter criteria, along with a query.

Note: When two different Resource Types are selected using the ALL Rules criteria, the rules are applied individually on each Resource Type.

Resources will be filtered against each resource type.

The result of the search criteria and the query is shown below:

Resource group filters result

If a new device is created and it matches the filter criteria or the advance search query, it is automatically added to the resource group without the need for manually saving it again.

A new device is added. As it matches the query, it is automatically added to the resource group.

Updated resource group:

Resource group - device is added

View a resource group


Prerequisite: You must have Manage Device permission to view resource group details.

Follow these steps to view the resource group details:

  1. Go to Infrastructure > Groups.

  2. Click the resource group name. The details of the resource group and the resources belonging to the group are displayed.

Resource Group list page

Edit a resource group


Prerequisite: You must have Manage Device permission to edit a resource group.

Follow these steps to edit a resource group:

  1. Go to Infrastructure > Groups.

  2. Click the resource group name.

  3. From the left pane, click the Settings icon and click Edit. The UPDATE RESOURCE GROUP page is displayed.

  4. Make the required changes and click Update.

The resource group is updated and displayed in the list of resource groups.

Delete a resource group


Prerequisite: You must have Manage Device permission to delete a resource group.

Follow these steps to delete a resource group:

  1. Go to Infrastructure > Groups.

  2. Click the resource group name.

  3. From the left pane, click the Settings icon and click Remove. A confirmation popup appears.

  4. Click Yes to delete the resource group.

View logs


Prerequisite: You must have Manage Device permission to view logs of a resource group.

Follow these steps to view resource group logs:

  1. Go to Infrastructure > Groups.

  2. Click the resource group name.

  3. From the left pane, click the Settings icon and click Log. A window appears with the Logs data for each resource.

Schedule a maintenance period

Maintenance periods enable you to schedule a time period to carry out maintenance activities on a resource group. You can set up a time for the maintenance period of resource groups.

Prerequisite: You must have Manage Device permission to add a schedule maintenance period for a resource group.

Follow these steps to add a schedule maintenance period for a resource group:

  1. Go to Infrastructure > Groups.

  2. Click the resource group name.

  3. From the left pane, click the Settings icon and click Maintenance. A confirmation popup appears.

  4. Click Yes to add a maintenance period for the resource group. The Create New Maintenance Period window is displayed.

  5. Provide details to schedule a maintenance period.

  6. Click Save.

The resources go into the maintenance mode as defined in the schedule.