Entity Search

Overview

The entity search interface finds entities by name, entity tag, and last insert date.

Syntax

Search text can consist of multiple keywords.

  • Keywords containing a colon are treated as tag filters, for example example-tag:example-value finds entities with tag example-tag set to example-value.
  • Reserved keywords min-date and max-date filter entities by last insert date.
  • The remaining keywords match entity names.

Name patterns support the following wildcard symbols:

  • * Matches any number of characters.
  • ? Matches any one character.

Wildcard * is automatically appended to the end of name patterns when performing searches, thereby matching any entities which contain a name that begins with the specified text. See Examples for a demonstrative explanation.

Multiple keywords are evaluated as boolean AND conditions.

Entity names, tag names, and tag values are matched on a case-insensitive basis.

Examples

  • Find entities which begin with keyword nur:

    nur
    

    Identical query:

    nur*
    
  • Find entities which contain keyword nur:

    *nur*
    
  • Find entities with tag location set to SVL:

    location:SVL
    
  • Find entities which contain tag location that begins with NORTH:

    location:NORTH*
    
  • Find entities with any value for tag location and display location column:

    location:*
    
  • Find entities with non-empty value for tag location and display location column:

    location:
    
  • Find entities which begin with nur and contain tag location set to SVL:

    nur location:SVL
    
  • Find entities with a last insert date on or later than the specified date:

    min-date:2018-08-21
    
  • Find entities without a last insert date:

    max-date:1970-01-01T00:00:00Z
    
  • Find entities with a last insert date in the specified range:

    min-date:2018-08-01 max-date:2018-08-10
    
  • Find entities containing cpu or memory:

    *cpu* *memory*
    
  • Find all entities matching server-? which have any data for last five minutes, and display some tags:

    server-? min-date:"now - 5 * minute" num_cpus: mem_size: disk_size:
    
  • Find entities with tag value containing whitespace:

    server_group:"Email servers"
    
  • Find entities with a name that contains a reserved character such as a colon : as in sha256:123:

    sha256\:*