search.md 2.83 KB
Newer Older
1 2 3 4 5 6 7 8 9
+++
title = "Search"
keywords = ["grafana", "dashboard", "documentation", "search"]
type = "docs"
[menu.docs]
parent = "dashboard_features"
weight = 5
+++

10

11
# Dashboard Search
12

13
Dashboards can be searched by the dashboard name, filtered by one (or many) tags or filtered by starred status. The dashboard search is accessed through the dashboard picker, available in the dashboard top nav area.
14

15
<img class="no-shadow" src="/img/docs/v2/dashboard_search.png">
16

17
1. `Dashboard Picker`: The Dashboard Picker is your primary navigation tool to move between dashboards. It is present on all dashboards, and open the Dashboard Search. The dashboard picker also doubles as the title of the current dashboard.
ubhatnagar committed
18
2. `Search Bar`: The search bar allows you to enter any string and search both database and file based dashboards in real-time.
19 20
3. `Starred`: The starred link allows you to filter the list to display only starred dashboards.
4. `Tags`: The tags filter allows you to filter the list by dashboard tags.
21

22 23 24 25
When using only a keyboard, you can use your keyboard arrow keys to navigate the results, hit enter to open the selected dashboard.

## Find by dashboard name

26
<img class="no-shadow" src="/img/docs/v2/dashboard_search_text.gif">
27

28
To search and load dashboards click the open folder icon in the header or use the shortcut `CTRL`+`F`. Begin typing any part of the desired dashboard names. Search will return results for for any partial string match in real-time, as you type.
29

30 31
Dashboard search is:
- Real-time
ubhatnagar committed
32
- *Not* case sensitive
33
- Functional across stored *and* file based dashboards.
34 35 36

## Filter by Tag(s)

ubhatnagar committed
37
Tags are a great way to organize your dashboards, especially as the number of dashboards grow. Tags can be added and managed in the dashboard `Settings`.
38

39
To filter the dashboard list by tag, click on any tag appearing in the right column. The list may be further filtered by clicking on additional tags:
40

41
<img class="no-shadow" src="/img/docs/v2/dashboard_search_tag_filtering.gif">
42

43
Alternately, to see a list of all available tags, click the tags link in the search bar. All tags will be shown, and when a tag is selected, the dashboard search will be instantly filtered:
44

45
<img class="no-shadow" src="/img/docs/v2/dashboard_search_tags_all_filtering.gif">
46

ubhatnagar committed
47
When using only a keyboard: `tab` to focus on the *tags* link, `▼` down arrow key to find a tag and select with the `Enter` key.
48

49
**Note**: When multiple tags are selected, Grafana will show dashboards that include **all**.
50 51


52
## Filter by Starred
53

54
Starring is a great way to organize and find commonly used dashboards. To show only starred dashboards in the list, click the *starred* link in the search bar:
55

56
<img class="no-shadow" src="/img/docs/v2/dashboard_search_starred_filtering.gif">
57

58
When using only a keyboard: `tab` to focus on the *stars* link, `▼` down arrow key to find a tag and select with the `Enter` key.