Create Custom Views

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:

  • Monitoring service health
  • Investigating incidents
  • Saving common queries to share with new teammates

Access Boards 

In the left navigation menu, select Boards with its Bulletin Board icon. When the left navigation menu is compact, only the icon appears.

Screenshot of Boards icon

Create a Board 

From the Query Builder screen:

  1. Build and run a query.

  2. Select Save To at the top of the page.

    Screenshot of Save To menu with Board option selected
  3. 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.)

  4. Select Save to new board.

  5. 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.

  6. 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 - Team (All members of team) or Restricted (Collaborators and owners only).

    Screenshot of Save to a New Board modal with Query information and Create a new Board sections
  7. Select Save query to finish.

Select the Boards icon in the left navigation bar to reach the Boards page.

Note
If no previous boards exist, select Run a query to get started and follow the instructions for From Query Builder instead.

From the Boards page:

  1. Select New Board in the top right corner.
  2. Name your new board. Optionally, give your Board a description to help others find and use it. Screenshot of New Board display with Name, Description, and Sharing Status fields
  3. Set the Sharing status of your board to Team (All members of team) or Restricted (Collaborators and owners only).
  4. Select Create when done.

Add a Query to an Existing Board 

Similar to Create a Board, to add a query to an existing board:

  1. Name a Query in Query Builder.
  2. Select Save to and a modal appears.
  3. Save to existing board is selected by default. Screenshot of Save to existing board modal with Query information and Board sections
  4. Under Query information, enter query information if required.
  5. Under Board, select a Board from the list of existing boards.
  6. Select Save query to save changes.

To add a query to an existing board:

  1. From an existing board, select the Manage menu.
  2. Select Add Query.
  3. Run a query.
  4. Select Save.
  5. Under Query information, enter the required query information. Your board should be pre-populated in the Board dropdown.
  6. Select Save query to save the query to your board.

Add a Service Level Objective (SLO) to an Existing Board 

Note
While Service Level Objectives (SLOs) are available for Pro and Enterprise plans, this SLO display is available as part of the Enterprise plan only.

To add a SLO to an existing Board from a SLO:

  1. Navigate to the SLOs page.
  2. Select the target SLO’s name to view its details page.
  3. Select Manage in the upper right corner.
  4. Select Save to Board.
  5. In the modal, select an existing board from the dropdown display.
  6. Select Save SLO to save the SLO to the Board.

To add a SLO to an existing Board display:

  1. Navigate to the target Board.
  2. Select Manage in the upper right corner.
  3. Select Add SLO to Board.
  4. Select the target SLO to add in the dropdown.
  5. Select Save SLO.

Edit a Board 

Edit the following aspects on your Boards:

  • Board name and description: From within the Board, hover over the name or description of the Board and select the pen icon.
  • Query captions: From within the Board, hover over the “Caption this Query” line underneath the query or graph and click the pen icon. If this has already been set, you can still change it.
  • Board permissions: Select the Share button on the right side to change between Restricted (Collaborators and owners only) or Team (All members of environment).
  • Queries on the Board: Board queries can be configured to show the result graph, table, or both. Change the query’s display by selecting the gear icon on its upper right corner.
  • Delete a Query: Select the Settings gear icon on the query’s upper right corner, and then select Remove Query.
  • Order of queries/graphs: Hover over the top of the graph or query you want to move until the cursor becomes a four-directional arrow, and then drag and drop it to the new location.
  • Delete the Board: Select the Manage button at the top right and select Delete Board. In the modal that appears, enter the unique identifier of the Board (listed in parentheses) to complete the deletion process.
  1. Select I understand the consequences. Delete this environment.
Tip
Private Boards can be modified by you and any team member added as a collaborator.

Edit a Query on a Board 

To edit a query on an existing Board:

  1. Navigate to the existing Board.
  2. Within the Board, select the target query to edit either through the query name, the graph, or table. Then, the Query Builder display loads with the selected query.
  3. Change the query and select Run Query. The update button will be enabled.
  4. To finish, select Update to update an existing query or Save To to save a new query. Screenshot of Query Builder display with Update and Save To buttons

Share Boards 

At creation time, you determine a board’s Sharing status as Restricted (Collaborators and owners only) or Team (All members of environment). A Team Board is visible to all Team members. A Restricted Board displays a lock next to its name, and its visibility is limited to you, any Collaborators you invited, and Team Owners.

Note
A Team Owner can see all Boards owned by members of their team, Limited or not.

To change a Board’s Sharing status:

  1. Navigate to the Board.
  2. Select Share at the top right of the screen. A display appears.
  3. Select Restricted or Team in the dropdown under Share.
  4. Select Save to save changes to the Board.

Adding Collaborators to a Board 

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.

Duplicate Boards 

To duplicate a copy of an existing Board:

  1. Select a Board from the Boards page to view its details.
  2. Select Manage in the top right corner. A menu display appears.
  3. Select Duplicate. A modal appears.
  4. Enter a title for the new Board, or use the default pre-filled title with “Duplicate of” and the existing board title.
  5. Select the environment for the duplicated Board’s location.
  6. Select Create duplicate to create the duplicate board.
Note
Duplicating a Board to a different environment requires compatible schema sets. Only a Board’s queries that match dataset and field names in the destination environment are duplicated. Any incompatible queries are omitted.

Boards Detail View 

Select a Board from the Boards page to view its details.

In the upper right corner:

  • Use Share to control Board permissions.
  • Select Manage to choose whether to duplicate or to delete the Board.

SLOs 

Note
While Service Level Objectives (SLOs) are available for Pro and Enterprise plans, this SLO display is available as part of the Enterprise plan only.

In this section, view saved SLOs to monitor sets of related SLOs alongside your queries. Select within each SLO display to view the SLO’s details.

Learn how to add an SLO to existing boards.

Queries 

To customize the Queries view:

  • 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.
  • Select One-Column or Multi-Column to change how Boards and their summaries are displayed.

Filter Your Queries on Boards 

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 “All Services Board”, which looks at all the health of services in your system, you may optionally want to apply a filter to look at health for 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.

board_filters_overview

Save Filter Parameters on Boards 

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.

board_filters_save_parameters

To override existing saved parameters, modify the filters, select Apply, and then select Save Parameters.

Filter States 

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:

  • All filters applied
  • No filters applied
  • Partially filtered

All filters applied 

When present, all filter parameters are applied successfully on the query.

board_filters_all_filters_applied

No filters applied 

When present, none of the filters are applied to the query because the field(s) do not exist in the query dataset.

board_filters_no_filters_applied

Partially filtered 

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.

board_filters_partially_filtered

Investigate Board Queries 

Start your investigations while viewing a Board. Select within the board display for a menu to appear.

board_query_chart_interactions

Add and View Markers 

Existing markers automatically display for every board query.

To add a marker, select your desired time point in the query and then select Add marker in the menu.

View Trace 

To view the corresponding trace waterfall, select a data point on a graph and then select View trace in the menu.

Zoom In 

To zoom into a time period within your query, select an area of the chart and then select Zoom in in the menu. When used, other queries on the board also automatically zoom into that same time window.

BubbleUp 

To BubbleUp on a board query, select a group or area of your chart and then select Investigate with BubbleUp in the menu.

Modify Queries from Table 

In tables that appear within Boards, select the three dot menu next to a value to further filter or group by that value.