Feat: Filter groups - #34889

Closes #23117

Blocked by #34823 merged

Allow grouping of filters and group selection in the filters function.

• The filters function now accepts an argument, which is multi and has an unnamed alias. Use it to select which group(s) of filters you want to use, like filters group1 | demodata
• The time picker and dropdown functions both take a filterGroup argument, which is passed along to the filter expression

Testing

Grouping works with simple string matching (case sensitive). If you specify a group (or many groups) on the filters function, only filters that belong to the group(s) will be applied. If no group is provided, it behaves like global filters do now.

The easiest way is to simply watch filter values update. Create 3 elements with the following expressions:

1. filters
2. filters group1
3. filters group2

Now add a time picker or dropdown element (or both, or multiples of one or both... whatever you want). You will see filters applied to #1, but not #2 or #3.

Now add a filter group to one (or several) or the time pickers and/or dropdowns. You can use the sidebar, as in the gif above, and you should see both "group1" and "group2" in the dropdown. If you add a different filterGroup to any of the filter elements, that will show up in the dropdown as well.

You can also add filterGroups to the expression, by adding filterGroup=group1 to the timefilterControl/dropdownControl function, like in this example:

timefilterControl compact=true column=@timestamp filterGroup=group1 | render

Now that should show up in #1 (since that one is global) and #2. Change the value to group2 and it should show up in #1 and #3. Change it to some other value and it will again only show up in #1.

The value for filterGroup can be any string, and if you create other groups (ie. use a string other than "group1" and "group2"), they should show up in the dropdown on the sidebar as well.

To check using multiple groups, set at least one filter on each of group1 and group2. Now update #3 to this expression: filters group2 group1. #3 should now show filters in both group1 and group2, and match #1 (unless you've added more groups).

Be sure to try using filters with multiple groups, and adding multiple filters to a group.

Sidebar

The sidebar control for the groups will show a dropdown of all groups that exist on any filters, as well as any groups being consumed by any filters functions (even if they are nested), which makes it easy to pick existing groups from the sidebar. Users can also create new groups on the fly from the sidebar.

If the element already uses a filter, and it's the only one, and you change it, the old group value will no longer show up in the list. You will have to manually add it back. This is also demonstrated in the gif above.