Skip to content

Search

The Search tab (Inventory > Search) allows you to search for nodes and files across your Cloudhouse Guardian (Guardian) instance, by filtering according to Scan Results or File Contents. Using the search bar, you can enter a search query that defines key attributes related to the content you want to find. Then, Guardian will search the database and return all results that match the attributes defined in your query. This topic describes how to use the search filter options to locate nodes and file contents, export the search results, and analyze the results. Depending on what you are searching for, the display results will vary.

Using the search bar, you can enter key words to locate nodes and configuration items that meet the stipulated search query. Additionally, there are several filters you can apply to narrow down your results.

To search for nodes and files across your Guardian instance, complete the following steps:

  1. In the Guardian web application, navigate to the Search tab (Inventory > Search).

  2. In the search bar, enter the identifying information or key words that will help Guardian locate the nodes or files you are looking for. For example, 'system' or 'Linux'.

    Note: You must enter a term that contains at least three characters. If you don't, the following error message is displayed: 'Please enter 3 or more characters to search'.

  3. Use the drop-down options to filter your results. If you don't want to select any filter options, you can skip this step.

    Warning: If you don't select any filters, the Scan Results search option is used by default. Meaning, results are sourced from the scanned nodes in the Monitored tab (Inventory > Monitored). If you want to search within files, you need to select File Contents from the Search Option drop-down list.

    Filter Option Description
    Search Option drop-down list The location Guardian searches using your query. Here, you can select one of the following options: - Scan Results – Data collected during node scans in the Monitored tab. This includes data regarding policies, benchmarks, and more. This option is selected by default. - File Contents – Files present on individual nodes monitored by Guardian. This includes data regarding files stored locally on the scanned nodes.
    Exact Match checkbox Option to retrieve results that are an exact match only. If selected, Guardianonly displays results that meet the specified criteria exactly. If not selected, Guardian displays results that meet some of the criteria.
    Type drop-down list The type of the node(s) you want to search for. For example, 'files', 'services', 'inventory', and more. Select an option from the drop-down list to retrieve results that are configured as the type you selected.
    Node Group drop-down list The node group you want to search. Select an option from the drop-down list to retrieve results that belong to the group you selected.
    Environment drop-down list The environment you want to search. Select an option from the drop-down list to retrieve results that belong to the environment you selected.

  4. Once complete, click the Search button.

The search results are displayed in a table. If no results are returned, the following message is displayed: 'No results found.' For more information on how to analyze the results, see below.

Results

Once you click Search, Guardian retrieves the results and displays them in a table, with a row for each result found. Each column contains clickable rows according to the descriptions listed in the following table:

Column Description
Node The name and the most recent scan date of the node. Select the node name to display the results of the most recent scan in the Monitored tab.
Type The type of scan item. For example, 'files', 'services, 'inventory' or others. Select the type value to display the corresponding configuration items , based on the results of the most recent scan.
Note: This column is only displayed if you select the Scan Results filter option.
Provider The provider of the scan item. For example, 'Windows', 'Linux' or others. Select the provider value to display the corresponding provider page in the Monitored tab.
Note: This column is only displayed if you select the Scan Results filter option.
Item The configuration item path of the item that contains the key word(s) you entered in the search bar. Select the item value, or anywhere in the item area, to go to the corresponding item page in the Monitored tab.
Note: This column is only displayed if you select the Scan Results filter option.
File Details The configuration item path of the file that contains the key word(s) you entered in the search bar. Select the file details value, or anywhere in the file details area, to display the File Viewer page. Here, you can click to Download the raw file contents.
Note: This column is only displayed if you select the File Contents filter option.

Export Search and Download

Once Guardian retrieves the results found, if you selected the Scan Results filter option, you can click the Export Search button to download a Comma-Separated Values (CSV) file of the results.

If you selected the File Contents filter option, you can download the raw file contents of any result in the table. Select the corresponding File Details value to display the File Viewer page. Here, you can click the Download button to download the raw contents of the selected file.