Download PDF
Download page Filters.
Filters
Cloud Native Application Observability displays all active entities on the Observe and list views by default.
From the Observe and list views, you can use filters to refine your view to display only the entities and data you are interested in. Cloud Native Application Observability provides you the ability to filter by these options:
- Attributes (all lists except Observe List)
- Entity Status
- Entity Type (Observe List only)
- Health
- Tags
The Entity Status=Active filter is applied by default.
Active entity metrics, events, logs, and health status are read and processed by Cloud Native Application Observability services. Active entities become inactive when data is not reported after a specified period of time.
To filter lists, you can use the mouse to select built-in filter options, or you can use the keyboard to enter search parameters. Using the keyboard may save you time when selecting from a long list. For example, selecting Attributes may display a long Key list. If you type a character, the list options are reduced to only those values containing the character you typed. Entering another character trims the list further. When you apply a filter on an entity list page, the filter is applied to only the entity and not the related entities; the entities count shown on relationship map is inclusive of all types of related entities.
Other keyboard functions:
- Type characters: begins filtering the list alphanumerically for you to select from the dropdown more quickly
- Up/Down arrow keys: move up and down in lists
- Enter/Return: select the highlighted item in a list; also activates Apply when highlighted
- Escape/esc: exit dropdown list; completes statement
- Tab: highlights the next area of focus on the page
Filter Your Data
The filter feature functions differently depending on which page you are on. Data is filtered differently on the Observe List page than it is on other list pages.
Filter entities on the Observe page:
- Click in the
Select field to display the filters dropdown.
- Select Entity Type, Entity Status, Health, or Tags
.
- Select an Operator
: = (equal to) or != (not equal to).
- Select the Value
that you want to include in your filter. You may select one or multiple values.
- Click anywhere outside the list to complete the filter.
- Repeat steps 2 through 5 until you have set up the filters for your search.
- Click inside the filter field and then click Apply
to display the results. If the filter parameters you selected yield no results, No Data Found displays.
- To remove filters, click
then Apply to update your view. Click anywhere outside the filter field and then click Clear to reset your filters.
Filter entities on list pages by Attributes, Entity Status, Health, or Tags:
- Click in the
Select field to display the filters dropdown.
- Select Attributes, Entity Status, Health, or Tags. Entity Status is highlighted by default. For this example, select Attributes
.
- Select an attribute Key
.
- Select an Operator
: = (equal to) or != (not equal to).
- Complete the filter statement:
- For Attributes, type the attribute name that you want to search for
. To add additional attribute values, use a comma between values.
For example, if you select Attribute+Key "service.name" and Operator "=", and type the comma separated Value(s) "value1,value2,value3", the filter service.name=value1,value2,value3 returns all of the entities that meet your filter parameters. - For Tags and Entity Status, select a Value by clicking the checkboxes for each tag you want to search. You may select one or multiple values, where available.
- For Attributes, type the attribute name that you want to search for
- Click Apply to filter your data, or click anywhere outside the list to complete the filter so you can add another and repeat steps 1 through 5. Your cursor must be active in the filter field to display the Apply button.
- When finished adding additional filters, click inside the filter field and then click Apply
to display the results of your filter selections. If your filter parameters yield no results, No Data Found displays.
- To remove filters, click
then Apply to update your view. Click anywhere outside the filter field and then click Clear to reset your filters.
Cisco AppDynamics is continuing to improve the filter view on the new experience pages. Give feedback directly within Cloud Native Application Observability with the floating Feedback button. You can leave general comments or issues, attach files or screenshots, and rate usability and product capabilities.
To view Service, Service Instances, Traces, Spans, or Business Transactions pages, you may have to perform a hard browser refresh by selecting:
- Control + F5 on Windows (Chrome)
- Command + Shift + R on Mac (Chrome)
- Option + Command + E (Safari)
For the Service and Service Instances pages, the isActive = true
filter is applied by default.
Filter entities on the Services, Service Instances, Traces, Spans, or Business Transactions pages by:
Hover over the health icons
for Services, Service Instances, or Business Transactions, and so on, until you see the purple background behind the health icons.
If a filter is already selected on the Observe page, the filter will carry over to the Services, Service Instances, or Business Transactions page, once you click the purple background for Services, Service Instances, or Business Transactions.
- Click on the purple background for Services, Service Instances, or Business Transactions. By default, the filter statement is
isActive = true
. Click on the filter statement bar that is denoted by
isActive = true
, and either backspace or delete the current filter statement, or add to it. If you add to the current filter, the autocomplete feature will populate suggestions. For example, for an active and health status behavior, useisActive = true && attributes(status) = 0
. For a health status only, useattributes(status) = 0
orattributes(status) IN [1, null]
.Healthy = [0]
Unhealthy = [2, 3]
Normal = [0]
Warning = [2]
Critical = [3]
Unknown = [1, null]- Once you complete your filter statement, click Apply.
To remove filters, highlight the filter statement and delete or clear the field.
The following operators are available:
- = (equal to)
- ~ (contains)
- != (is not equal to)
- IN (multiple section, where you can filter by two or more attribute)
- && (and, where you can connect two complete clauses)
The following list of operators are supported:
- tags: =, !=, IN, ~
- attributes: =, !=, IN, ~
- isActive: =, !=
- attribute(status): =, !=, IN
When using the operator ~ (contains) you need to use * to indicate start with, end with and contains. For example, use:
attribute(service.name) ~
'cloud*' to get anyattribute(service.name)
that start with 'cloud'attribute(service.name) ~
'*cloud' to get anyattribute(service.name)
that end with 'cloud'attribute(service.name) ~
'*cloud*' to get anyattribute(service.name)
that contains 'cloud'
WayFinding
When you navigate from one entity to another using the Relationship map, a subtitle displays all related entities. For example, when navigating from a Cluster to a Service the title displays Services, and the subtitle displays related to some Cluster.
If you further navigate to Service Instances, the subtitle will be related to Services and Clusters, and so on. The title and subtitle will reset when you navigate to a details page. The subtitle is only visible on list pages. To see all all of the entities without any relations, click clear all relations.