Skip to content

Commit 1680d75

Browse files
authored
Add troubleshooting guide for filters in dashboards (#1465)
1 parent 41e5ea5 commit 1680d75

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

docs/howto/update_major_package_spec.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,25 @@ owner:
102102
type: elastic
103103
```
104104

105+
### expected filter in dashboard: ...
106+
107+
It is required to include filters in dashboards, to limit the size of the data
108+
handled to the one included in related datasets.
109+
110+
To fix this issue, please include a filter in the dashboard. It usually means to
111+
add a filter based on `data_stream.dataset`. But it is open to the package
112+
developer to provide any filter that fits the use case of the package.
113+
114+
There are two variants of this error:
115+
116+
- `no filter found`: that means that no kind of filter has been found in the
117+
dashboard, and one should be added.
118+
- `saved query found, but no filter`: that means that a saved query has been
119+
found, but no filter. If that's the case, please migrate the saved query to a
120+
filter. We want to make this filtering only in filters, for consistency
121+
between different dashboards, and to allow users to quickly filter using the
122+
query bar without affecting the provided filters.
123+
105124
## Troubleshooting upgrades to Package Spec v2
106125

107126
### field (root): Additional property license is not allowed

0 commit comments

Comments
 (0)