This section focuses on using the advanced search feature to search for resources, using the following:

  • Resource attributes
  • Values
  • Operators associated with the attribute

To navigate to the infrastructure search page:

  1. Log in to the portal.

  2. From All Clients, select a client.

  3. Go to Infrastructure > Search.

The advanced search page is displayed.

The NEW VIEW tab has an Advanced search box. A Recent Queries list is also displayed, if you searched for resources previously.

Example:

The following example describes the search process for the resources that have “host” in the beginning of the string in the name attribute.

  1. Type a query using the name of the attribute associated with the resource(s) you want to search. This example shows a search on the resource name attribute:

  2. As you start typing the attribute name, a drop-down list displays the native and custom attributes that match the characters you entered. Use the down-arrow key or mouse to highlight and select the attribute you want.

  3. Select the operator LIKE from the list of operators. Follow Query Language Reference syntax rules.


    The example begins with a search for the string “host” occurring in the beginning in the name attribute of managed resources.

    Note: The value entered in parentheses is case insensitive.

  4. Enter the attribute value (in this case, host) and suffix it with a %, delimited by quotes for string data types. All the strings that start with host are displayed as search results.

    Other examples:
    If you enter the attribute value as “%host”, all the strings that end with “host” are considered.

    For the attribute value “%host%”, all the strings that have “host” anywhere in name, are displayed.

    When you finish entering the value, a green tick appears indicating that the query entered is valid.

  5. Press Enter or click the search button. The search results display a summary list of resources that match the query:

To get the detailed information about a resource, click the resource Name:

Notes:

  • Your most recent query is added to the Recent Queries list, which shows the query string used for the search.
  • To repeat a previous query, click the (magnifying glass) search icon to create a new tab, and then click the tile for that search string

The search results are displayed as in the previous example.

For more information on how to use OpsQL, click here

RESOURCE OVERVIEW

The Resource Overview pane allows you to view resources that are discovered through an integration.

The installed apps are displayed under categories in the pane.

The following basic steps let you view the Resource Overview pane:

  1. Log in to the portal.

  2. From All Clients, select a client.

  3. Go to Infrastructure > Search. The Home tab displays the Resource Overview pane.

Note: The Home tab is available only at the client level.

All the installed apps are displayed under the categories.

For example: Public Cloud category will display the Apps: AWS, Azure, Google Cloud, Alibaba.

  1. Click the App under the category to view the discovered resources.

Note: Only monitorable resources are displayed in the resources listing page.

You can view the availability state of the resources (UP, DOWN, UNKNOWN, UNDEFINED, ALL) along with the count. If you want to know the list of resources that are in a specific availability state, click the number.

Resources details like Name, Ip Address, Os, Make, Model, Native Type, State are also displayed on the page. By default, 12 columns are displayed.

Use the Filters option to filter and search for resources. Use the Settings gear icon to include/exclude columns that you want to show up on the page.

  1. Click the resource name or anywhere in the row to view the resource details slide-out.

The slide-out has the following details:

  • Alerts: The number of alerts the resource has based on their current state: Critical, Warning, OK, INFO, OBSERVED, AND ALL (total number of alerts).

  • Tickets and Notes: The number of tickets on the resource and Notes (if any) are displayed.

  • OVERVIEW: The OVERVIEW tab is displayed by default. It has details like Make, Model, IP Address, OS, Resource Groups.
    Traits: Information related to the resource properties like agent/gateway connectivity information, resource type.

  • RELATED RESOURCES: If the resource has a relationship with other resources, then the count of those resources, along with their native types, is displayed in the RELATED RESOURCES tab. Click the count to get the list of resources that are related to the resource. The tab is grayed out if there are no related resources.

  • CUSTOM ATTRIBUTES: The custom attributes tab displays the attribute name, value and the Source.

  • ACTIONS: Use the ACTIONS button to:

    • Schedule maintenance period on the resource.
    • Launch Remote Session (this option appears only if Agent/Gateway is installed on the resources. It is applicable for Classic Gateway, Windows and Linux devices)
    • Execute Commands (this option appears only if Agent is installed on the resource.)
      Note: The Launch Remote Session and Execute Commands support is not provided for SDK related apps.

      You can also select bulk resources and perform the above actions.

  • Full Details: Click the Full Details link available at the upper-right corner of the slide-out to view the resource Overview page.

List of Resource Overview categories and sub-categories

CategoryType of IntegrationIntegration Name (sub-category)
Audio Video DevicesADAPTER_INTEGRATIONPolycom-Trio-8800
Crestron AV
NEC Displays
Poly AV - Group Series
Poly AV - Studio Series
Poly VVX/CCX Phone
Cloud-Based ApplicationsADAPTER_INTEGRATIONMicrosoft 365
Container PlatformsCOMPUTE_INTEGRATIONKubernetes
Mesosphere DC/OS
Red Hat OpenShift (OKD)
K3S
Prometheus Metrics
Data ProtectionADAPTER_INTEGRATIONDell Avamar
Dell PowerProtect Data Manager
Dell Cyber Recovery Manager
DatabasesADAPTER_INTEGRATIONInformix Database
Hyperconverged InfrastructureCOMPUTE_INTEGRATIONNUTANIX
Cisco HyperFlex
MiddlewareCOMPUTE_INTEGRATIONJava Virtual Machine
IBM Websphere
Redhat Jboss
WildFly
Servers and VMsCOMPUTE_INTEGRATIONVMware
XenServer
Cisco UCS
HPE OneView
Microsoft Hyper-V
Servers and VMsADAPTER_INTEGRATIONWindows Fail-over Cluster
Linux Fail-over Cluster
Veritas Cluster
IBM AIX Server
HP UX Server
IBM AS400
Solaris OS Server
Public CloudCOMPUTE_INTEGRATIONAzure Stack
Public CloudCLOUD_INTEGRATIONAzure
AWS
Google Cloud
Alibaba
Software Defined NetworksNETWORK_INTEGRATIONContrail Controller
Viptela
Software Defined NetworksADAPTER_INTEGRATIONVMware NSX-T
VMware NSX-V
Storage ArraysSTORAGE_INTEGRATIONPure Storage
NetApp Filer
Dell EMC VNX
Dell EMC VNXe
Dell EMC VMAX
Dell EMC CLARiiON
IBM STORWIZE
HP EVA
NetApp Cluster
Dell EMC XTREMIO
Dell EMC VPLEX
Dell EMC RPA
Hitachi VSP
Storage ArraysADAPTER_INTEGRATIONHitachi HCI
Hitachi HNAS
Hitachi VSP
Hitachi VSP Opscenter
Dell Power Store
Dell Power Max
DELL Data Domain
Dell PowerScale
NetApp ONTAP
NetApp Active IQ Unified Manager
NetApp SolidFire
HPE 3PAR
Switches and RoutersNETWORK_INTEGRATIONMeraki
Cradlepoint
Switches and RoutersADAPTER_INTEGRATIONBrocade Network Advisor
Dell Networker
TelephonyNETWORK_INTEGRATIONNEC IP-PBX
Web ServicesADAPTER_INTEGRATIONHTTP Endpoint Probe
DNS Response Probe

MY RESOURCES VIEWS

You can perform the following actions from the MY RESOURCE VIEWS slide-out:

Download Resources

The Download Resources functionality lets you download the resources from the Infrastructure > Search page. All the resources in the client will be downloaded in CSV format.

To export resources:

  1. Click Infrastructure > Search.

  2. Click the hamburger menu icon at the upper-left corner of the Infrastructure search page.

  3. From the slideout, click the Download Resources icon. All the resources will be downloaded in CSV format.

Save a View

Once you execute a query, you can save the query results as a view.

To save a view:

  1. Click the hamburger menu icon at the upper-left corner of the Infrastructure search page.

  2. From the slideout, click the + icon. The SAVE VIEW popup is displayed.

  3. Enter a name for the view and click ADD.

  4. The view is saved and displayed in the slide-out.

  • Use the up/down arrow icons to hide/show the views in the slide-out.
  • The Save and Restore icons appear after you create a view. Click them to perform the Save and Restore views respectively.

Set Favorite

  1. If you want to mark a view as favorite, hover over the view name on the slide-out.

  2. Click the star icon. The view is added as favorite and appears under the FAVORITE category. The blue colored star icon indicates that the view is added as favorite. If you want to unfavorite the view, click the blue colored star against the view. The view is removed from the Favorite category.

You can perform other actions on the saved view:

Restore

The Restore option reverts to the previous query.

Once you have made changes to a specific query, which is already saved as a view:

  1. Hover over the view name on the slide-out.
  2. Click the actions menu. The VIEW OPTIONS popup is displayed.
  3. Click the Restore option. The previous query automatically appears in the Search box.
    Note: You must not save the changes you made to the query for the view. Otherwise, the query will not be reverted.

Rename

The Rename option allows you to rename the name of the view.

To rename a view:

  1. Hover over the view name on the slide-out.
  2. Click the actions menu. The VIEW OPTIONS popup is displayed.
  3. Click the Rename option. The RENAME VIEW popup is displayed.
  4. Enter a new name for the view in the Name box and click SAVE. The view is renamed.

Copy

The Copy option allows you to create a copy of a view.

To create a copy of a view:

  1. Hover over the view name on the slide-out.
  2. Click the actions menu. The VIEW OPTIONS popup is displayed.
  3. Click the Copy option. The COPY VIEW popup is displayed.
  4. Enter a name for the view in the Name box and click SAVE. The view is copied and is displayed in the slide-out.

Set Default View

The Set Default View option allows you to set a view as a default view for the current user.

To set a view as a default:

  1. Hover over the view name on the slide-out.

  2. Click the actions menu. The VIEW OPTIONS popup is displayed.

  3. Click the Set Default View option. The Set Default View dialog box is displayed.

  4. Turn on the My Default View option.

  5. Click the SET DEFAULT button.

  6. Refresh the browser. You can see that the view is set as default for the current user.

  7. To set the default view for other users, share the view and make it default for the user you want to set as default.

Share

The Share option allows you to share a view with other users.

To share a view:

  1. Hover over the view name on the slide-out.

  2. Click the actions menu. The VIEW OPTIONS popup is displayed.

  3. Click the Share option. The Share View dialog box is displayed.

    Based on the scope of the user, the options appear.

    • For SP and Partner users:
      • Select the role from the PARTNER ROLES drop-down list. (The view is shared with all the partners with the role selected.)
      • Under CLIENT ROLES, select the client and the role from the drop-down lists. If you select All Clients, it will show the client-level roles that are available across all clients. If you select a specific client, it will show the roles that are available for that client.
      • Click + ADD CLIENT USERS if you want to share the view with multiple users.
    • For Client users:
      • Select the role from the drop-down list.

  4. Click SHARE. The view is shared.

Remove

The Remove option allows you to remove a view.

To remove a view:

  1. Hover over the view name on the slide-out.
  2. Click the actions menu. The VIEW OPTIONS popup is displayed.
  3. Click the Remove option. A confirmation dialog box is displayed.
  4. Click REMOVE. The view is removed.

The related resources are a group of resources that are related to a particular resource. For the resources to be related to each other, they should meet one of the following conditions:

  • runsOn: Indicates that a resource is running on another resource. For example, an application that is running on a server that is in the process of getting discovered.
  • connectedTo: Indicates that a resource is connected to another resource. For example, a port that is connected to a switch.
  • dependsOn: Indicates that one resource needs another resource to exist. For example, an ESXi host cannot exist without a vCenter.
  • componentOf: Indicates that one resource is a component of a group of resources. For example, a number of VMs that belong to a cluster. Each VM is a component of the cluster.

Concept of relationship

The following example demonstrates the concept of relationship among the resources:

There are three resources, namely Resource 1, Resource 2, and Resource 3.

  • If Resource 2 is connected (meets one of the four conditions of related resources) to Resource 1, it indicates that Resource 2 is related to Resource 1.
  • If Resource 3 is connected (meets one of the four conditions of related resources) to Resource 1, it indicates that Resource 3 is related to Resource 1.

The above example can be summarized in the following way:

  • Resource 2 and 3 are in a relationship with Resource 1.
  • Resource 2 and 3 are the related resources of Resource 1.

The Related Resources tab displays the number of related resources for a selected resource. It also displays the native type of the resources connected to the main resource.

For example: Main = Resource 1, native type = host
Related resources = Resources 2 and 3, native type = vm
The main resource displays the native type as vm and the associated count as 2.

Pre-requisites
The following conditions are a must for a resource to display the related resources count:

  • The Native Type attribute for the resource (1, according to the example) that shows the count must be defined .
  • One or more resources (2 and 3, according to the example) must be in a relationship with the resource (1).

Exceptions
The related resources will not be displayed under the following conditions:

Native Type AttributeRelationshipResult
DefinedResources not related
  • Related Resources tab is grayed out
  • Count is not displayed
Not definedRelated
  • Unknown is displayed as the native type
  • Count is displayed

To view the Related Resources tab, log in to the portal.

  1. From All Clients, select a client.

  2. Go to Infrastructure > Search.
    The Home Tab with the RESOURCE OVERVIEW and resources information is displayed.

    Home Tab Resource Overview Page

  3. Select the resources under the category and click.

  4. Alternatively, click the search icon to look for a specific resource.
    The NEW VIEW tab is displayed.

    New Tab View
  5. Search for the resource using the query Search field. From the list of resources displayed, select the target resource and click it.

    A slide-out screen that contains the RELATED RESOURCES tab and the following information is displayed:

    • Native types (Switch and Port as seen in the illustration) of the resources that are related to the main resource.
    • Associated count (4 switches and 384 ports as seen in the illustration) of native types.
    Related Resources Tab Overview
  6. Click the count of any category resources.
    A new tab that contains a query with the native type of the resource and topology UUID is displayed. The list of resources of the selected category are also displayed.

    Related Resources Count Display