# Tailoring Dashboards with Dashboard Filters

{% hint style="info" %}
The Labels feature has been upgraded to **Tags**. All your existing labels have been automatically migrated to the new tagging system with no action required on your part. Existing labels were converted to a tag key with an empty value (for example, a label named `subnet-10` is now a tag with the key `subnet-10` and no value). You can now manage all tags centrally by navigating to **Manage > Tags**.
{% endhint %}

A significant concern for users is the time taken to manage either a single dashboard or multiple dashboards with the same widgets. For example, a user may create a dashboard to monitor a specific service or network performance. Additionally, they may want to monitor different services or geographic regions using the same dashboard setup (widgets and settings).

To do this, the user has two options: duplicate the dashboard and update all widget configurations to match what they want to monitor, or update the dashboard itself every time they want to switch services or geographic regions. However, this approach is not scalable and manageable when dealing with a large number of dashboards.

**Dashboard Filters** solves this issue by allowing you to apply a single set of filters to a dashboard. This feature enables you to monitor multiple services, various geographic locations, and users on dashboards without adjusting individual widget filters. As a result, this feature saves time and provides a more efficient way of monitoring your data with different views.

![](/files/C0WkKcGcF7VhBHSSsvK0)

## Adding a New Filter

To add a new filter:

1. Click on the **Filter** button and select the **Add filters** option.

![](/files/gK1Lf7fdyPIeHNP5hcML)

2. When choosing tests and agents from their respective drop-downs, all tests and agents are shown, providing more flexibility for configuration. For example, if your widgets were originally configured to a subset of HTTP tests, you can use dashboard filters to change the HTTP tests that are shown in those widgets to other HTTP Tests. You can also use the dashboard filters to narrow down the values already configured through the widgets.
3. Utilize **Test Tags** and **Agent Tags** to narrow down the list of tests and agents. You can filter tags globally across the entire dashboard or per widget.
   * **Dashboard Global Filter**: Use the filter bar at the top of the dashboard to select test tags or agent tags. This applies to all applicable widgets on the dashboard.

     ![Dashboard global filter showing Test Tags and Agent Tags options](/files/UOSKDiXE0QHZiIgqMMv8)
   * **Widget Filter**: You can also filter individual widgets by tags. Edit a widget, and in the **FILTER BY** section, select **Test Tags** or **Agent Tags** to apply tag filters just to that specific widget.

     ![Widget configuration panel showing Test Tags selected in the Filter By section](/files/R5e1Rp1sqOGSA6xEcP6S)
   * The default state of the criteria shows **Tests** or **Agents** which are filtered explicitly by widgets in the dashboard.

     ![](/files/IoGDZjM6Sd4fFjHCn8UQ)
   * If a dashboard also contains widgets that are not restricted to specific tests and agents, leverage the **Enabled** or **All** state selectors to see more tests or agents that are available to you.
4. Select values that you are interested in. In this instance, we are interested in evaluating agents based in Africa. After selecting tests, agents, or tags, click **Apply** to enable the filter.

   ![](/files/IoGDZjM6Sd4fFjHCn8UQ)
5. The dashboard will refresh automatically and reload with the above filter applied. Any pre-existing filters at the widget level will be overridden.

{% hint style="info" %}
If you choose a test that doesn't apply to the current widget configurations, you will receive a **No Data** message. This message doesn't indicate an error but it means that there's no relevant data for the selected widget. For instance, if all the widgets on a dashboard are set up to display results for HTTP Server tests from Cloud and Enterprise Agents, and you select a DNS test from the filter criteria, all the widgets will show **No Data**.
{% endhint %}

### Configuring Filters with Multiple Data Sources

If your dashboard comprises widgets from various data sources, you can still utilize the dashboard filters to apply additional values.

To add a data source:

1. Click on the **Add Data Source** button and select the desired data source from the drop-down. In this example, we are selecting **BGP Routing** as the dashboard uses this data source to monitor the overall network's health.

![](/files/xKVw9dEGqSmyRNUWuufk)

2. Select the desired **Tests** and **Tags** from the respective drop-downs and configure the filter.

![](/files/PvaXxJdc8rq0I5Kty6WB)

{% hint style="info" %}
The dashboard filters configured for a specific data source do not impact widgets created with other data sources. For example, in the above scenario, dashboard filters for the Cloud and Enterprise Agents do not impact widgets with BGP Routing data.
{% endhint %}

\## Saving a Filter

You can save filter selections as a Filter Set to reuse them and save time.

To save the filter:

1. Click on the **Filters** button and select the **Save Filters** option.
2. In the **Save Filters** side panel. Enter a **Name** for the filter and add a **Description** about the filter. The filter set's name needs to be unique for the organization/account group.

   ![](/files/eHqZD2bGMAxloh8LBL2X)

{% hint style="info" %}
It is important to note that the filter will have the same visibility settings as the dashboard it is being saved for. For example, suppose the dashboard is private and not visible to other users in your account group. In that case, the filter will also be private and unavailable to other users in the account group.
{% endhint %}

4. Click Add to save the filter. You will be notified on the bottom right of your screen with a toast when the filter gets saved successfully.

## Applying a Filter

To apply a saved/pre-existing filter set:

1. Click on the **Filter** button and select the **Load Saved Filters** option.
2. In the side panel, you can see a list of all the filters with their descriptions and the corresponding information regarding the filters.

![](/files/1P0upbGz6gSuGgjdaj8A)

3. Select the desired filter by clicking on the name’s hyperlink. You can also search by name or description for the filters.

### Setting a Filter as Default

You can now repurpose your global view dashboard into a specific geographic region’s view. To preserve this view, set a filter as default for the dashboard. To do this:

1. Navigate to the **Dashboard Details** panel by clicking on the ellipses in the top right corner of the Dashboard you want to use and then **Edit Dashboard**.
2. Select the desired filter from the **Saved Filters** drop-down.

   ![](/files/warEy9lXOqae9wY7k1sO)
3. **Save** the changes.

## Locking Widget Filters

You may want to preserve specific widget views to monitor the global performance of the application while also monitoring a geographic location.

1. You can keep the widget filters fixed by checking the **Lock Widget Filters** option. This will prevent any dashboard filters from changing the data that the widget shows.
2. You can use this to persist with the widget’s filter configuration. For example, a widget may always be configured to Cloud Agents, while all other widgets are configured using the dashboard filters to Enterprise Agents in order to compare performance.

![](/files/n3NAtwhX3FpA9kLZJqfG)

## Limitations

* Agent status, alert list, and test table widgets are not currently supported by dashboard filters.
* Snapshots and file downloads (i.e. CSV/PDF) do not persist in the value selection of dashboard filters.
* When you first load a dashboard with a default set of filters, the filter criteria along with the selected values may not appear. To resolve the issue, you can collapse the filter bar by pressing the left bracket key **\[** and then expand it again by pressing the left bracket key **\[** once more. Another way is to navigate to a different dashboard and then come back to the original dashboard, which will reload the filter bar. We are currently investigating this issue to find a permanent solution.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thousandeyes.com/product-documentation/dashboards/dashboard-filters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.