Linking interactions

Link to another dashboard for a deeper dive into data specifics. For example, a visualization showing sales revenue across a world map can link to a completely different dashboard that breaks down the specific data points of each major city in a regional area. Both visualizations and shapes can link to either another dashboard or custom URL.

Link to another dashboard

The dashboard you link to can exist in a separate application from the originating dashboard.

To link to another dashboard complete the following steps:

1. Select the visualization you want to link from, and it will highlight with a blue border.
2. In the Configuration panel, select +Add Drilldown.
3. Use the On Click dropdown and choose Link to dashboard.
4. Use the Select an App dropdown and search for the app that maintains your dashboard by filtering the name.
5. Use the Select a Dashboard dropdown and search for the dashboard you want to link to by filtering the name.
6. The following steps are optional.
   1. Verify that the dashboard has the expected permissions. The owner and permissions will appear below the dashboard's title.
   2. View the dashboard to verify you are linking to the expected dashboard.
   3. Select Open in new tab to have the linked dashboard open in a separate tab.
7. Select Save.

When linking from a visualization with data, you must click the actual value in the visualization, not just anywhere, to go to the link.

Set tokens with a linked dashboard

You can pass token values from one dashboard to another linked dashboard. You can use more than one token. For steps to pass token values, see Documentation:SplunkCloud:DashStudio:tokens in this topic and Setting tokens from search results or search job metadata.

Example of linking to a dashboard

The following example links a dashboard from a table visualization. The table has a token set on the value splunkd. When you interact with the table and select a value in the splunkd column, Dashboard Studio opens a new tab with the linked dashboard.

Source code for linked dashboard example

The source code example shows where you set a token's value and its name in the table. In this example, the token's value is row.splunkd.value, and the token's name is token_example.

{
    "type": "splunk.table",
    "options": {
        "columnFormat": {
            "splunk_assist_internal_log": {
                "width": 66
            },
            "splunk_secure_gateway_modular_input.log": {
                "width": 85
            }
        }
    },
    "showProgressBar": false,
    "showLastUpdated": false,
    "dataSources": {
        "primary": "ds_rv9OQcNy"
    },
    "eventHandlers": [
        {
            "type": "drilldown.linkToDashboard",
            "options": {
                "app": "search",
                "dashboard": "classic__clone",
                "tokens": [
                    {
                        "token": "token_example",
                        "value": "row.splunkd.value"
                    }
                ],
                "newTab": true
            }
        }
    ],
    "context": {}
}

Link to a custom URL

The URL can be relative, such as coming from a local site, or absolute from an external site. Links that direct outside of the Splunk Platform require token filters to handle tokens with spaces. For more details, see Token filters in the Dashboards and Visualizations manual.

To link to a custom URL, complete the following steps:

1. Select the visualization you want to link from and it will highlight with a blue border.
2. In the Configuration panel, click +Add Drilldown.
3. Use the On Click dropdown and choose Link to custom URL.
4. Provide a relative or absolute URL.

   If you do not provide an https:// address, the generated URL is considered internal to Splunk Enterprise and uses a localhost URL, such as localhost:8000//. If you provide an https:// prefix, such as https://splunk.com, the link directs to that external URL.

5. (Optional) Select Open in new tab to have the linked URL open in a new tab.
6. Select Save.

When linking from a visualization with data, you must select the actual value in the visualization to go to the link. For more details about interactions, see Setting tokens on a visualization click.

Configure a custom URL with a token

Custom URL linking can also use the token syntax row.<fieldname>.value instead of a relative or local URL. For example, a table visualization might have multiple fields of URLs that connect to a token and can open on a new tab when a user selects the URL.

Expand the window to see the full source code for the example of using a token as a custom URL. Notice the $row.Link.value$ token used as the url.

{
   "visualizations": {
       "viz_w5uvUoyO": {
           "type": "splunk.table",
           "options": {},
           "dataSources": {
               "primary": "ds_tZlX9WS9"
           },
           "title": "Using $row.Link.value$ as the custom URL link",
           "eventHandlers": [
               {
                   "type": "drilldown.customUrl",
                   "options": {
                       "url": "$row.Link.value$",
                       "newTab": true
                   }
               }
           ],
           "description": "Select a value from the Link column"
       }
   },
   "dataSources": {
       "ds_tZlX9WS9": {
           "type": "ds.search",
           "options": {
               "query": "| makeresults count=3 \n| streamstats count\n| eval Resource=case(count=1, \"Splunk.com\", count=2, \"Splunk Documentation\", count=3, \"Splunk Community\")\n| eval Link=case(count=1, \"https://www.splunk.com/\", count=2, \"https://docs.splunk.com/Documentation\", count=3, \"https://community.splunk.com/\")\n| fields - count _time"
           },
           "name": "Search_1"
       }
   },
   "defaults": {
       "dataSources": {
           "ds.search": {
               "options": {
                   "queryParameters": {
                       "latest": "$global_time.latest$",
                       "earliest": "$global_time.earliest$"
                   }
               }
           }
       }
   },
   "inputs": {
       "input_global_trp": {
           "type": "input.timerange",
           "options": {
               "token": "global_time",
               "defaultValue": "-24h@h,now"
           },
           "title": "Global Time Range"
       }
   },
   "layout": {
       "type": "absolute",
       "options": {
           "width": 1440,
           "height": 960,
           "display": "auto"
       },
       "structure": [
           {
               "item": "viz_w5uvUoyO",
               "type": "block",
               "position": {
                   "x": 50,
                   "y": 60,
                   "w": 590,
                   "h": 200
               }
           }
       ],
       "globalInputs": [
           "input_global_trp"
       ]
   },
   "description": "",
   "title": "Custom URL using a token"
}