Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -6,34 +6,67 @@ tags:
- Core concepts
metaDescription: "How to use the New Relic entity filter bar to filter your entities and save useful filtered views."
redirects:
freshnessValidatedDate: 2023-07-24
freshnessValidatedDate: never
---

The entity filter bar lets you filter down to the monitored [entities](/docs/new-relic-solutions/new-relic-one/core-concepts/what-entity-new-relic) you want to examine, and lets you save filters for later use.
The entity filter bar helps you find and filter the monitored [entities](/docs/new-relic-solutions/new-relic-one/core-concepts/what-entity-new-relic) you want to examine across New Relic's interface.

<img
title="filterbar.png"
alt="filterbar.png"
src="/images/platform_screenshot-crop_filtering-entities.webp"
title="Entity filter bar in Catalogs"
alt="Current entity filter bar interface showing search and filter options"
src="/images/Catalogs.webp"
/>

## Find the filter bar [#find]
## Locate the filter bar [#find]

The entity filter is located at the top of many New Relic UI pages. It's visible on the <DNT>**All entities**</DNT> view, which is the first thing you see when you [load New Relic](https://one.newrelic.com), and it's visible in our APM UI, our <InlinePopover type="browser"/> UI, our infrastructure UI, and more.
The entity filter bar is displayed at the top of key New Relic pages including:
- <DNT>**[Catalogs](/docs/service-architecture-intelligence/catalogs/catalogs/)**</DNT> page for <DNT>**Applications**</DNT>, <DNT>**Repositories**</DNT>, and <DNT>**Infrastructure**</DNT>.
- <DNT>**All Entities**</DNT> page.
- APM service pages.
- <InlinePopover type="browser"/> pages.
- Infrastructure monitoring pages and many more.

## Tips for using the filter bar [#tips]
## Basic search and filtering [#basic-filtering]

Some tips for using the filter bar:
Start with these fundamental filtering methods to locate entities:

* Type in a <DNT>**string**</DNT> of characters and/or numbers (for example, an environment) to find any entity that has this string in their name or ID. When typing, the UI suggests items that coincide with the string you're entering, so you can select one of those from the dropdown. You can also filter by the name of the <DNT>**entity**</DNT>, the <DNT>**entity type**</DNT>, <DNT>**account ID**</DNT>, <DNT>**environment**</DNT>, or a [<DNT>**tag**</DNT>](/docs/new-relic-one/use-new-relic-one/core-concepts/tagging-use-tags-organize-group-what-you-monitor). Selection parameters, once created, have a blue background.
* If you filter using a string, the filter will have the `=` operator.
* If you filter using the dropdown menu, once the first element of the searched item (tag key or attribute) is entered, you need to select an operator (`=`, `!=`, `LIKE`, `NOT LIKE`, `IN`, `NOT IN`) for your filter.
* Once the operator is selected, complete the filter by selecting the value to complete the search item.
### Search by entity name
Use the <DNT>**Search by entity name**</DNT> field to find entities:
1. Click in the search field.
2. Type part of an entity name (for example, "production" or "web-app").
3. View matching results that appear instantly in the list below.

To add more filters, first you have to select an operator, `AND` or `OR`. Tips on using these:
<Callout variant="tip">
The search matches any part of the entity name, so typing "prod" will find entities with names like "prod-web-server" and "my-production-app".
</Callout>

* Use `AND` to indicate you want to restrict the selection removing entities from the list of results. You can also use the `AND` operator to add conditions that need to be met in the list of results, for example, <DNT>**entityType = Services `AND` location = APAC**</DNT>.
* Note that <DNT>**entityType = Services `AND` entityType = Hosts**</DNT> doesn’t return any results, as entities can only have one type and no entity would match this condition.
* Use `OR` to add more entities to the selection. For example, the filter <DNT>**entityType = Services `OR` entityType = Hosts**</DNT> returns every entity you have access to that is of type `Services` or `Hosts`.
### Filter by entity type
Narrow your results by selecting specific entity types:
* <DNT>**Entity Type**</DNT>: Choose from applications, services, hosts, containers, and other monitored resource types.
* **Result:** Only entities matching your selected type will display, making it easier to focus on specific infrastructure components.

If your filter is very complex, try using [the NRQL query builder](https://one.newrelic.com/data-exploration/query-builder). For more information on NRQL queries, see [How to use NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-how-nrql-works).
### Filter by team ownership
Focus on entities managed by your team:
* <DNT>**Team**</DNT>: Select teams that have ownership of entities in your current view.
* **Requirement:** You need to enable [Service Architecture Intelligence](/docs/service-architecture-intelligence/getting-started/).
* **Result:** View only entities assigned to or owned by the selected team.

## Advanced filtering [#advanced-filtering]

For more complex filtering scenarios, create custom filters:

### Create custom attribute filters
Add specific filters based on entity attributes:
1. Click **+** next to the existing filters.
2. From the <DNT>**Filter**</DNT> dropdown, select an attribute (such as environment, region, or custom tags).
3. Choose an operator:
- **=** (equals): Exact match
- **!=** (not equals): Exclude exact matches
- **LIKE**: Contains the specified text
- **NOT LIKE**: Excludes the specified text
4. Enter or select a value to complete the filter.
5. Click <DNT>**Add**</DNT> to apply the filter.

**Example:** To find all production web applications, you might filter where `environment = production` AND `entity_type = APPLICATION`.

For more advanced querying and analysis, consider using [the NRQL query builder](https://one.newrelic.com/data-exploration/query-builder). For more information on NRQL queries, refer to [How to use NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-how-nrql-works).
Binary file added static/images/Catalogs.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading