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:
- Go to insights.newrelic.com > Data apps > Create a data app.
- Specify an Icon, Title, URL, Description, and Permissions for your app.
- 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:
- From your data app dashboard, select Edit, then select Configure data app.
- 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:
- Go to insights.newrelic.com > Data apps > (select a data app).
- Select the dashboard containing the widget you want to link from, then select Edit.
- From the widget you want to link, select the link
icon. - Select the target dashboard from the list.
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:
- Go to insights.newrelic.com > Data apps > (select a data app).
- Select Edit > Configure data app.
- Mouse over an individual dashboard to view the management tools and make your changes.
- 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. |
Change data app settings
To edit the settings for an existing data app:
- Go to insights.newrelic.com > Data apps > (select a data app) > Edit.
- Select Configure data app, then make your changes.
- 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:
|
| 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)