Data apps: Build collections of linked dashboards

Data apps are collections of linked dashboards that create a curated, application-like experience. Even users who do not know NRQL can explore your business data with data apps. For example, with data apps and custom attributes, your support department could easily check how often an individual account or user accesses a particular feature of your app.

Create a data app

To create a new data app:

  1. Go to insights.newrelic.com > Data apps > Create a data app.
  2. Specify an Icon, Title, URL, Description, and Permissions for your app.
  3. Select Create to save your new data app.

After creating your app, customize it with new or existing dashboards from your account.

Add dashboards to your data app

After creating your data app, Insights automatically redirects to a new dashboard. You can add widgets to this dashboard using standard NRQL queries.

You can also create additional dashboards by selecting + Add from the data app navigation bar, or copy an existing dashboard into your data app:

  1. From your data app dashboard, select Edit, then select Configure data app.
  2. Select the Copy dropdown, and choose a dashboard.

Copied dashboards are independent of the original dashboard. Changes to the original dashboard do not affect the copy, and editing or deleting the copied dashboard does not affect the original.

Link between dashboards with FACETs

You can use the FACET widget to link to a pre-filtered dashboard. Creating links allows your users to navigate between dashboards in an intuitive way.

For example, you could link a faceted list of most-active users to another dashboard. Clicking a username in the first dashboard opens the linked dashboard and filters it to show only metrics from that user account.

To create a link:

  1. Go to insights.newrelic.com > Data apps > (select a data app).
  2. Select the dashboard containing the widget you want to link from, then select Edit.
  3. From the widget you want to link, select the link insights widget link icon.png icon.
  4. Select the target dashboard from the list.
screen-facet-linking-data-apps.png
insights.newrelic.com > Data apps > (select a data app) > (select a link from FACET widget): FACET linking allows you to connect multiple dashboards together, and automatically filter the linked dashboard to show only relevant metrics.

Manage dashboards in data apps

After creating a dashboard, you can manage the order in which your dashboards appear in the data app's navigation bar. You can also hide certain dashboards if you only want to link to that dashboard, but not have it clutter the navigation bar. To manage dashboards, edit the settings for your app:

  1. Go to insights.newrelic.com > Data apps > (select a data app).
  2. Select Edit > Configure data app.
  3. Mouse over an individual dashboard to view the management tools and make your changes.
  4. When finished, select the X icon or click anywhere outside the dialog box to save your changes automatically.

The following dashboard management options are available:

Option Description
Reorder dashboards Mouse over the dashboard in the list and select the up or down arrow icons to reorder the navigation bar.
Set primary dashboard The first dashboard in the list is the primary dashboard. Whenever a user selects your data app, this is be the first dashboard they see. To change the primary dashboard, use the reorder arrows to move it to the top of the dashboard list.
Hide or unhide a dashboard Select the eye icon to hide a dashboard from the data app's navigation bar. You can still link to this dashboard with FACET widgets, but the dashboard is otherwise invisible to data app users. This allows you to have many dashboards in your app without cluttering the navigation bar. Select the eye icon again to unhide the dashboard.
Delete a dashboard Select the delete icon to remove a dashboard from your data app. This permanently removes the dashboard and all its widgets. If the dashboard was copied from another dashboard, the original dashboard will not be deleted.
screen-manage-data-app.png
insights.newrelic.com > Data apps > (select a data app) > Edit > Configure data app: Use the data app configuration page to manage the order in which dashboards appear, hide and unhide dashboards, and delete dashboards. You can also customize other settings such as the icon.

Change data app settings

To edit the settings for an existing data app:

  1. Go to insights.newrelic.com > Data apps > (select a data app) > Edit.
  2. Select Configure data app, then make your changes.
  3. When finished, select the X icon or click anywhere outside the dialog box to save your changes automatically.

The following settings are available:

Option Description
Icon Select an icon to quickly identify a particular data app.
Title Specify a name for your app.
URL

Specify a custom URL for your app.

This setting is not available when configuring an existing app, only when creating a new data app.

Description Specify a description for your app, which allows you to summarize the app for other account users.
Permissions

There are three levels of sharing permissions for data apps:

  • Private just to me: Most secure option
  • Viewable by others in my account
  • Editable by others in my account: Default option
Show query bar

Hide or show the query bar when using the data app. Hiding the query bar gives your users a more curated, application-like experience.

This setting is not available when creating a new data app, only when configuring an existing app.

Delete the app To permanently delete the data app and all of its dashboards, select the trash can icon.

For more help

Additional documentation resources include:

  • Using NRQL (basic overview of NRQL syntax and examples of how NRQL queries can help you understand your business)
  • NRQL reference (describes the NRQL methods available when building widgets)
  • Insights attributes (overview of the attributes available when querying your data)

Recommendations for learning more: