Advanced Search

In Advanced Search view, you can search across all your resources based on their attributes and metrics -- even between different cloud platforms (Azure, Amazon & Kubernetes). You can conduct sophisticated searches over the entries in the table using the search boxes on the left:

It allows you to select Types to search from, enter AND, OR and NOT Attribute search terms (using the corresponding text box) and also to Associated Tables of the entities (e.g. to find things according to their security-group rules).

The easy-way to use these search boxes is to rely on the auto-complete dropdowns that appear after you click inside a textbox. But you can also read the syntax rules later on in this article if you want to gain some extra control over the search queries.

A simple search example

Using the 'Find resource of type' dropdown, select an entity type to use in the search. You can also just start typing to filter the dropdown:

For this example, we will use 'Amazon | Any/All Types'. This includes all Amazon resource types such as API Gateway, S3 Bucket, Subnet and Network Interface.

Click inside one of the search boxes to reveal an auto-complete dropdown of available attributes to search against:

You can also filter the Attributes dropdown by typing:

After an attribute name has been selected (here we chose 'Region Name', you are now prompted to choose an attribute value. This auto-complete dropdown provides you with possible values that currently are being used in your dataset but you are free to enter other values (or even parts of values). Value dropdown is also filterable by typing:

In this example clicking on Search button will give you all the resources under Region Name: US East (N. Virginia):

The matched column is highlighted with Blue background as shown. Table displays the initial 100 results. Pagination is provided to display the next/previous results. In this example, we matched 40 resources using these criteria.

You can also hide the left search panel by clicking the caret to display the table in wider view, and see the other columns:

Adding further conditions (like Type: Subnet for example) can reduce the search, and create more precise result:

The table headers/key can be clicked to sort the data based on the values under it.

'Associated With' Search

You can add associated resources by clicking the 'And is Associated with...' button. This adds another set of search fields for the related resource types:

Similar with the onload fields, you can filter the resource of types, add Attribute search terms and add Table searches of the associated entities.

As continuation of the example, we can add 'Amazon | Internet Gateway' as resource type and click the Search button. This will return search results with associated values. By clicking the caret in the row, the associated values are displayed.

Adding associated resources (to the main search, or as another associated resource) can help you see the relational data within your network:

Show Search Results in Diagram

Once you have found a specific set of resources you can create a diagram view from them by clicking the 'Show in Diagram' button:

Saving Search Results

A rule is a 'smart' search query that can help to continually monitor your cloud data. These rules are listed in The Main Dashboard view. Searches can be set as rule by clicking the 'Save As Rule' button.

Export Table

After the search returned some results, the data can be exported using the "Export To CSV" link at the top right corner of the table. A CSV file containing the data in the table will then be downloaded by the browser.

Total Cost

The total cost of the resources included in the search result is also displayed with the table. Just make sure to enable the Hyperglance cost collection

Search Metrics

You can search for resources based on AWS CloudWatch or Azure metrics:
  1. Click the With/Without These Attributes text box and select "Metric Search"
  2. Select the metric that you want to search from
  3. Select metric roll up (Average, Maximum, Minimum, Sum, ...)
  4. Select metric period duration (Hour, Day, Week, Month)
  5. Select the comparison operator (<, >, <=, >=)
  6. Enter a numerical value
  7. Press the Search button (or hit enter)

Note: You can add as many attribute or metric search terms as you wish using the provided search fields.

Note: A metric that returns a 'null' will have it's value treated as 0.0 (zero).

Search Syntax Guide

  • Key:Value "exact" searching:
    • Find an exact match of a tag or attribute. Start with the key, followed by a colon (do not use whitespace around the colon!), followed by a value.
    • Results must have an exact match for key and value to be considered a match.
  • Key:PartialValue* "contains" searching:
    • Add an asterisk to the end of the value to do a partial-match on the value.
    • Results must have the exact key but the corresponding value need only 'contain' the fragment you specified before the asterisk.
    • E.g.  Name:Fred*  will match an attribute called "Name" with a value of "Frederick".
  • Value-only searching:
    • Enter a single value (without a colon) - This will search for that value within all attributes, matching both the key and value of the attributes.
    • E.g. searching for color will match an attribute named Color (regardless of its value!). It will also match an attribute named Description if the value of that attribute is "I like colorful things".
  • Quoting:
    • Using quotes such as "double quotes" or 'single quotes' enables searching for terms that have spaces in their name.
    • E.g. searching for "Alarm Severity":warning will look for an attribute named 'Alarmed Severity' whose value contains the word 'warning'.. If the quotes weren't used then the word 'Alarm' and the word 'Severity' would not form part of a single attribute key and we would be searching for them as independent search terms. Consequently we would get very different search results.
  • Comparisons:
    • Numeric attributes and metrics can be compared with comparison operators:
      • Less Than: <
      • Greater Than: >
      • Less Than or Equal:  <=
      • Greater Than or Equal:  >=
      • Equal: =
      • Not Equal: !=
    • Attributes that are dates (such as "Boot Time" or "Expires At") can be converted into days or hours that are 'since' or 'until' the present time:
      • daysSince("Boot Time")
      • daysUntil("Expires At")
      • hoursSince("Boot Time")
      • hoursUntil("Expires At")

Search Tips are displayed with the left panel to help remind you of these search guidelines: