Use drilldowns for dashboard actions

edit

Use drilldowns for dashboard actions

edit

Drilldowns, also known as custom actions, allow you to configure a workflow for analyzing and troubleshooting your data. Using a drilldown, you can navigate from one dashboard to another, taking the current time range, filters, and other parameters with you, so the context remains the same. You can continue your analysis from a new perspective.

For example, you might have a dashboard that shows the overall status of multiple data centers. You can create a drilldown that navigates from this dashboard to a dashboard that shows a single data center or server.

How drilldowns work

edit

Drilldowns are user-configurable Kibana actions that are stored with the dashboard metadata. Drilldowns are specific to the dashboard panel for which you create them—they are not shared across panels. A panel can have multiple drilldowns.

This example shows a dashboard panel that contains a pie chart. Typically, clicking a pie slice applies the current filter. When a panel has a drilldown, clicking a pie slice opens a menu with the default action and your drilldowns. Refer to the Try it section for instructions on how to create this drilldown.

Drilldown on pie chart that navigates to another dashboard

Third-party developers can create drilldowns. Refer to this example plugin to learn how to code drilldowns.

Create and manage drilldowns

edit

Your dashboard must be in Edit mode to create a drilldown. Once a panel has at least one drilldown, the menu also includes a Manage drilldowns action for editing and deleting drilldowns.

Panel menu with Create drilldown and Manage drilldown actions

Try it: Create a drilldown

edit

This example shows how to create the Host Overview drilldown shown earlier in this doc.

Set up the dashboards

edit
  1. Add the sample web logs data set.
  2. Create a new dashboard, called Host Overview, and include these visualizations from the sample data set:

    [Logs] Heatmap
    [Logs] Visitors by OS
    [Logs] Host, Visits, and Bytes Table
    [Logs] Total Requests and Bytes

    If you don’t see data for a panel, try changing the time range.

  3. Open the [Logs] Web traffic dashboard.
  4. Set a search and filter.

    Search: extension.keyword:( “gz” or “css” or “deb”)
    Filter: geo.src : CN

Create the drilldown

edit
  1. In the dashboard menu bar, click Edit.
  2. In [Logs] Visitors by OS, open the panel menu, and then select Create drilldown.
  3. Give the drilldown a name.
  4. Select Host Overview as the destination dashboard.
  5. Keep both filters enabled so that the drilldown carries over the global filters and date range.

    Your input should look similar to this:

    Create drilldown with entries for drilldown name and destination
  6. Click Create drilldown.
  7. Save the dashboard.

    If you don’t save the drilldown, and then navigate away, the drilldown is lost.

  8. In [Logs] Visitors by OS, click the win 8 slice of the pie, and then select the name of your drilldown.

    Drilldown on pie chart that navigates to another dashboard

    You are navigated to your destination dashboard. Verify that the search query, filters, and time range are carried over.