Use dashboards to visualize data
Dashboards are a convenient way to visualize important data in one place. Observe provides a quick and easy method of creating dashboards from your Datasets.
Dashboard listing
Log in to Observe and click Dashboards in the left navigation to displays a list of all available Dashboards on your instance. Recently viewed dashboards are listed at the top, and common filters are on the left. In the Search bar, you can enter filters to narrow your search to a specific dashboard or dashboards.
Filter data in a dashboard
The filtering options that are available when using a dashboard are set when the dashboard is created or edited. Contact the dashboard owner if you are unable to filter a dashboard as expected.
The following types of filters are available for dashboards:
- FIlter bar
- Filter panel
- Dashboard parameters
A dashboard may include any number of these options depending on the selections made by the dashboard creator.
Filter panel
The filter panel uses a single Dataset to populate the panel in the left rail of a dashboard.
The columns of that Dataset are used to generate filters that can apply to the dashboard cards that use the filtering Dataset. For example, a dashboard displaying container logs can use a filter panel to automatically filter by container log relevant columns such as Cluster, Image, Namespace, and Reason. A card on that dashboard which does not source container logs, such as Git Commit History, will not be affected by the filter panel.
When you select a filter in the dashboard panel, it will automatically appear in the filter bar.
Filter bar
Use the filter bar to apply operations based on the Dataset used in the filter panel. You can use ~ or !~ for keyword matching. For example, on our Container Logs dashboard the filter bar can be used to quickly type reason ~ create to filter by container logs with a reason code like ContainerCreating or CreateContainerConfigError.
To populate the filter bar, you can do any of the following:
- Select something in the filter panel to have that value appear in the filter bar.
- Click in the filter bar, then select the fields and values you desire with the help that appears.
- Type your query directly into the filter bar.
Dashboard parameters
A dashboard may also have parameters: dropdown or text entry fields that allow you to narrow a dashboard's results. For instance, our Container Logs dashboard might have a text entry field where you can paste an image hash, or a dropdown where you could select an instance name.
Presentation mode
A dashboard or series of dashboards can be configured to present in a slideshow, suitable for use in a shared-screen environment such as a NOC (Network Operations Center) or SOC (Security Operations Center). To configure a presentation, open the dashboard and click Presentation View from the context menu at top right. The dashboard will open in presentation mode on a new tab.
While in presentation mode, a dashboard's parameters are still visible, but cannot be changed. The filter bar and filter panel are not visible. Dashboards that are larger than the screen display area will slowly scroll down and up to ensure that all data is visible over time. Moving the mouse will cause a Stop button to appear in the middle of the dashboard. Click this button to stop the display, or to configure more advanced behavior.
The presentation mode configuration screen lets you change how often the dashboard refreshes its data from the default of five minutes. You can also add more dashboards, and chose an animation effect for switching between dashboards in a slideshow. The amount of time each dashboard is on screen can also be changed from the default of one minute. Click the Start Slideshow button to return to presentation mode.
Share a dashboard
To share a dashboard with other Observe users, click the Share Page URL button in the top right. Select a time and filtering option, then click "Share" to copy a link to the clipboard.
NoteA Dashboard URL copied from the browser address bar should show the same content as a Share link. Review the URL query parameters to understand how the URL is constructed.
There are three options for handling time and data filtration when making a Share link:
- Filters & Current Time – The default behavior attempts to show the recipient exactly what is on the sender’s screen. Filters are set to be the same, and the time window is fixed to the start and end that are currently used. This share link will point at a specific window of time that is receding into the past.
- Filters & Relative Time – Using filters and relative time is designed for dashboard use. It shares the sender’s filters and sets the time window relative to the present. This share link will point at a different time window each time it is opened.
- No Filters & Time – This option removes all filtering and time decisions from the shared link; the recipient sets filters and selects their desired time window if the dynamic Observe default for that dataset is not ideal.
See Understand the time window selection for more detail on how time is referenced in an Observe dashboard.
Favorite a dashboard
Dashboards can be added to your personal Favorites or the Observe Homepage by clicking the Favorite icon (). In addition to the filters and time options used when sharing a dashboard, you can change the name and location of the favorite link.
Export a dashboard to a Worksheet
A Dashboard can be copied to a new Worksheet, which is useful for experimenting without cluttering the Dashboards list page. To export to a Worksheet, you can do either of the following:
- In any individual card, click the more icon (), then select Open in worksheet.
- From any dashboard, click the more icon (), then select Export > Export to worksheet.
A new Worksheet is created with the same data sources, filtered Datasets, and parameters. Each card will be a worksheet query. Note that text and image cards do not have Worksheet equivalents and are not copied. Worksheet also don't retain dashboard layouts or sections.
Export data
To download the data displayed in a dashboard card, click the More menu in the top right corner of the card and Open in Worksheet. On a Worksheet you can switch the visualization to Table, and then click the Export button. You may select CSV or JSON format, and a maximum size limit (one thousand, ten thousand, or one hundred thousand rows). Note that hidden fields will be included. Use the pick_col OPAL verb to reduce the width of downloaded data.
Updated 8 days ago