Boards are a place to save useful graphs you want to retain for later reuse and reference. Similar to conventional dashboards, Boards re-run and get updated results when their Board page is loaded. Use Boards to extend your knowledge to the rest of your team, to your colleagues, or to your future self.
Common use cases for Boards include:
In the left navigation menu, select Boards with its Bulletin Board icon. When the left navigation menu is compact, only the icon appears.
From the Query Builder screen:
Build and run a query.
Select Save To at the top of the page.
Choose Board and a new modal appears. (If you select My Saved Queries, the query is added to My Saved Queries in Query History instead.)
Select Save to new board.
Enter your Query information. If saving a query with a pre-existing name and/or description to a new board, then these fields populate automatically, but can be edited.
In Create a new Board, name your new board. Optionally, give your Board a description to help others find and use it. Determine the board’s Sharing setting - Public to the Team or Limited to Collaborators.
Select Save query to finish.
Select the Boards icon in the left navigation bar to reach the Boards page.
From the Boards page:
Similar to Create a Board, to add a query to an existing board:
Edit the following aspects on your Boards:
To edit a query on an existing Board:
At creation time, you determine a board’s Sharing status as Public to the Team or Limited to Collaborators. A Public to the Team Board is visible to all Team members. A Limited to Collaborators Board displays a lock next to its name, and its visibility is limited to you, any Collaborators you invited, and Team Owners.
To change a Board’s Sharing status:
You can add one or all of your teammates as Collaborators to your Private Boards.
You can add teammates individually by entering their e-mail address, or all teammates by selecting Add All Teammates.
Collaborators can add or remove queries or graphs, and edit the name and description of your Board.
Select a Board from the Boards page to view its details.
Use the time picker to re-run all queries on the board over the same time range. Use the filter box to filter the listed queries. In the upper right corner, use Settings to control certain Board settings. Select One-Column or Multi-Column to change how Boards and their summaries are displayed.
Board Filters allow you to apply one or more parameters to all queries on your board. When viewing a Board and its queries, use the Filter By search box to enter your parameter(s). Select Apply to apply the parameter(s) to all queries on your board.
For example, if you have a board called “Errors Overview”, which looks at all the errors occurring in your system, you may optionally want to apply a filter to look at errors occurring in the frontend service that you own.
In this case, a filter by
service.name=frontend applies that parameter on top of every existing query on the board to output service-specific results.
Filter parameters can also be saved to a Board, so that any user who arrives to the Board in the future will see query results with the filter parameters applied.
To save parameters, first input your desired filter parameters and select Apply. Then, the Save Parameters button will appear as selectable. Select it to save those parameters as the board’s default filters.
To override existing saved parameters, modify the filters, select Apply, and then select Save Parameters.
Filter parameters apply across all queries in a board. Since a Board can contain queries on different datasets, applying filter parameters can result in three possible states denoted in a label for each query:
When present, all filter parameters are applied successfully on the query.
When present, none of the filters are applied to the query because the field(s) do not exist in the query dataset.
If you use more than one filter parameter and only some exist in the query dataset, then the filter parameters are partially applied. Select the label to show the filter parameters that were applied. The parameters that do not exist in the dataset will not be applied.