Customize Boards

Customize and organize your Boards to present data in a way that enhances team collaboration and decision-making.

Introduction 

Customize your Boards to organize, display, and control access to your data, helping your team make more informed decisions. Each level of customization offers unique options to tailor the workspace to your needs:

  • Board: Manage your workspace’s name and sharing settings, ensuring the right team members have access and understand the context of the Board.
  • Query Section: Customize layout, filter queries, and adjust time settings to group and view queries in a way that highlights the most relevant data.
  • Query Panels: Fine-tune individual queries by adjusting conditions, captions, and display types to present your data most effectively.
Note
You need appropriate permissions to make changes to a Board. To learn more about permission levels, visit Manage Permissions.

Managing Boards 

A Board is a collection of panels and sections, designed to bring together different resources that contribute to a broader investigation. Manage your Board structure and access to create focused, shareable workspaces that cater to your team’s needs.

Modifying Board Details 

Change the name or description of a Board to improve clarity or better align with changes in its use.

To update a Board’s name or description:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Select the Board you want to modify.
  3. On the Board’s details page, hover over the name or description, then select the pencil icon (Edit icon).
  4. Make your changes.
  5. Select Save.

The page refreshes, and the Board updates to reflect your changes.

Modifying Board Details  

Change the name or description of a Board to improve clarity or better align with evolving needs using the flexible Boards experience, available as part of our beta program.

To update a Board’s name or description:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Select the Board you want to modify.
  3. On the Board’s details page, hover over the name or description, then select the pencil icon (Edit icon).
  4. Make your changes.
  5. Select Save.

The page refreshes, and the Board updates to reflect your changes.

Rearranging Panels  

Reorganize the panels on your Board to prioritize data and improve navigation using the flexible Boards experience, available as part of our beta program.

To rearrange panels:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Choose the Board containing the panel you want to move.
  3. Select Edit.
  4. On the Board’s details page, hover over the panel handle (Drag handle) until the cursor turns into a four-directional arrow (Move icon).
  5. Drag and drop the panel to its new location.
  6. Select Done.

Resizing Panels  

Resize the panels on your Board to optimize space and improve usability using the flexible Boards experience, available as part of our beta program.

To resize panels:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Choose the Board containing the panel you want to resize.
  3. On the Board’s details page, select Edit.
  4. Hover over the panel resize handle until the cursor turns into a diagonal arrow.
  5. Drag the panel edge to the appropriate size.
  6. Select Done.

Changing Access 

Boards can be shared with your entire Honeycomb Team or restricted to a subset of your Team members.

By default, Boards are public which means any Team member can access them. To limit access to yourself or specific teammates, adjust the access level and add collaborators.

Tip
Team owners can always access all Boards owned by their Team members. To learn more about permission levels, visit Manage Permissions.
  1. Select Boards (Boards menu icon) from the navigation menu.

  2. Choose the Board you want to modify.

  3. Select Share.

  4. Locate the Who can view and edit this board dropdown, and choose an option:

    • Team (All members of environment): [default] Visible to all members of your Honeycomb Team.
    • Restricted (Collaborators and owners only): Only visible to you, Team owners, and invited collaborators. Restricted Boards display a lock next to their name.
  5. Confirm your choice:

    • If you chose Team, select Confirm.
    • If you chose Restricted, changes save automatically. Only you and your Team owner can access the Board. To share it with others, add collaborators.

Adding Collaborators 

Add collaborators to make it easier for your Team to actively contribute and keep your Board relevant. Collaborators can contribute to a Board by adding or removing panels and by modifying the Board’s name and description.

To add collaborators:

  1. Select Boards (Boards menu icon) from the navigation menu.

  2. Select the Board you want to modify.

  3. Select Share.

  4. In the Who can view and edit this board dropdown, make sure Restricted (Collaborators and owners only) is selected.

  5. In the Collaborators section, either:

    • In Email Address(es), enter email addresses of your teammates as needed, then select Add Collaborator.
    • Select Add All Teammates to add everyone on your team, then remove individual collaborators as needed.

Removing Collaborators 

Keep your Board secure by removing collaborators who no longer need access.

To remove a collaborator:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Choose the Board you want to modify.
  3. Select Share.
  4. Locate the Who can view and edit this board dropdown, and make sure Restricted (Collaborators and owners only) is chosen.
  5. In the Collaborators section, find the email address of the collaborator you want to remove, then select Remove.

Leaving a Board 

Keep your workspace relevant by leaving Boards you no longer need. Whether you’re stepping away from a project or no longer monitoring a particular board, removing yourself as a collaborator helps you stay focused.

Tip
If you own the Board, consider transferring ownership before leaving.

To leave a Board:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Choose the Board you want to modify.
  3. Select Share.
  4. Locate the Who can view and edit this board dropdown, and make sure Restricted (Collaborators and owners only) is chosen.
  5. Find your email address, then select Leave.

Transferring Ownership 

If you’re stepping away from a project, delegating responsibilities, or need someone else to manage a Board’s settings and permissions, you can transfer administrative control to another Team member.

To transfer ownership:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Choose the Board you want to modify.
  3. Select Share.
  4. Locate the Who can view and edit this board dropdown, and make sure Restricted (Collaborators and owners only) is chosen.
  5. Find the email address of the team member you want to make the owner, then select Make Owner.

Managing the Query Section 

The query section of your Board houses the key queries that provide the insights you need. Manage the query section to control how queries are organized and to improve the overall clarity of this section of your Board.

Rearranging Query Panels 

Reorganize the queries on your Board to prioritize data and improve navigation.

To rearrange query panels:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Choose the Board containing the query you want to move.
  3. On the Board’s details page, hover over the query panel until the cursor turns into a four-directional arrow (Move icon).
  4. Drag and drop the query panel to its new location.

Changing Column Layout 

Adjust the column layout of the query section on your Board to control your user experience.

To change the column layout:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Select the Board that you want to modify.
  3. On the Board’s details page, select your desired layout option:
    • One-Column: Displays items in a single column, with each panel taking up the full width of the page.
    • Multi-Column: Displays items in multiple columns. The number of columns may vary depending on your screen size.

The page refreshes, and the Board updates to reflect your changes.

Changing Time Range 

Adjust the time range for the queries displayed on a Board to analyze specific time periods. This lets you focus on relevant data, whether it’s for troubleshooting or long-term trend analysis.

Selecting a Preset Time Range 

Preset time ranges offer a quick way to select common time periods for your queries, saving you time when you need to analyze recent or recurring data.

To use a preset time range:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Select the Board that you want to modify.
  3. On the Board’s details page, locate and open the time picker.
  4. Choose a preset time range from the list of common options, such as Last 10 minutes or Last 30 days.
  5. Select Apply.

The page refreshes, and your queries update to reflect the selected time range.

Defining a Custom Time Range 

Choose a custom time range to define a specific time period for your queries, which helps you focus on a precise window of data.

To define a custom time range:

  1. Select Boards (Boards menu icon) from the navigation menu.

  2. Select the Board that you want to modify.

  3. On the Board’s details page, locate and open the time picker.

  4. Select Custom.

  5. In the modal, configure your time range:

    Field Description
    Start time Start time for the query time range.
    Relative to now Defines how time is specified for the end time: a range relative to the current time [on], or a fixed date and time in UTC [off].
    End time End time for the query time range. For relative time ranges, this is always set to now.
  6. Select Apply.

The page refreshes, and your queries update to reflect the selected time range.

Changing Granularity 

Granularity controls the level of detail for the queries on your Board by determining how data is grouped over time.

To adjust the granularity for your query panels:

  1. Select Boards (Boards menu icon) from the navigation menu.

  2. Select the Board that you want to modify.

  3. On the Board’s details page, locate the time picker, then choose Custom.

  4. Locate the Granularity dropdown, and choose the desired time interval.

    Tip
    Choosing auto lets Honeycomb automatically adjust the level of detail in your query results based on the time range and data volume, helping to balance performance and clarity.
  5. Select Apply.

The page refreshes, and your queries update to reflect the selected granularity.

Filtering Queries 

Apply or modify filter parameters on your Board to customize data views and ensure consistent, relevant results.

Save filters to the Board to preserve context across sessions, so anyone who views it later will see the filtered results by default.

Example

If you have a Board called “All Services”, which tracks the health of services across your system, you might want to focus only on the health of the frontend service you own. In this case, applying a filter for service.name=frontend will adjust every query on the Board to display service-specific results.

board_filters_overview

To modify and save filter parameters:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Choose the Board you want to filter.
  3. On the Board’s details page, locate the Filter by text box, and select or remove your criteria.
  4. Select Apply.
  5. To save the parameters, select Save Parameters. board_filters_save_parameters

Checking Filter State 

Filters apply to all queries on a Board, but because a Board can contain queries from different datasets, filters may not affect every query.

To ensure your accurate and consistent data, check the filter state for each query. The filter state can impact your results and how you interpret the data.

To check the applied filters:

  1. Select Boards (Boards menu icon) from the navigation menu.

  2. Choose the Board you want to review.

  3. On each query panel, locate the filter state label next its settings (Settings icon). The label indicates the filter status. Possible statuses include:

    Status Description
    All filters applied All filter parameters are successfully applied to the query.
    No filters applied No filters are applied because the fields do not exist in the query’s dataset.
    Partially filtered Some filter parameters are applied, but not all fields exist in the query’s dataset. To inspect applied filters, select the label details icon (Settings icon).
    Tip
    If you don’t see filter state labels on your query panels, make sure filters are applied to the Board. Filter state can only be determined when filter criteria are in place.

Managing Query Panels 

A query panel represents an individual query on your Board. Modify individual query panels to refine the data and its presentation, so you can focus on the most relevant insights for your investigation.

Changing Query Conditions 

Change query conditions to ensure your data remains aligned with evolving needs.

To modify a query on a Board:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Choose the Board that contains the query you want to modify.
  3. On the Board’s details page, select the query you want to edit.
  4. In the Query Builder, edit the query.
  5. Select Run Query to apply the changes.
  6. Select Update to save the modifications. Screenshot of Query Builder display with Update and Save To buttons

The page refreshes, and the query panel updates to reflect your changes.

Changing Query Display 

Adjust the display format for individual queries on your Board.

To change the query display:

  1. Select Boards (Boards menu icon) from the navigation menu.

  2. Select the Board containing the query you want to modify.

  3. On the Board’s details page, locate the query and open its settings (Settings icon).

  4. Select your preferred display option:

    • Display Graph only: Shows only the visualization.
    • Display Graph & Table: Displays both the visualization and the summary table.
    • Display Table Only: Shows only the summary table.
  5. Select Save.

The page refreshes, and the query panel updates to reflect your changes.

Modifying Query Captions 

Add or update captions for your queries to provide clarity and context, making it easier for collaborators to understand their purpose.

To modify query captions:

  1. Select Boards (Boards menu icon) from the navigation menu.
  2. Choose the Board that contains the query you want to modify.
  3. On the Board’s details page, locate the query you want to modify, and hover over Caption this Query beneath it, then select the pencil icon (Edit icon).
  4. Modify the caption as needed.
  5. Select Save.

The page refreshes, and the query panel updates to reflect your changes.