In New Relic, you can share dashboards and charts with viewers outside your organization, even if they don't have a New Relic account. This feature expands the audience for your insights while maintaining security controls and auditing capabilities. The shared dashboards and charts are accessible via publicly accessible live URLs that you create from the New Relic platform.
When external users access the shared dashboards or charts, the page renders with the same data and visualizations as the original entity, with the following interactive capabilities:
Time range: Viewers can pick the time range from a drop-down to see data for a specific period.
View mode: Viewers can select light or dark mode depending on their preference.
TV mode: Viewers can enable a full-screen TV mode that optimizes the dashboard for display on a television screen.
Important
While the chart sharing feature is available to Pro, Enterprise, and Core Compute customers, the dashboard sharing feature is available only to Advanced Compute customers. To learn more about the associated costs and management practices for the dashboard sharing feature, refer to the Pricing section.
Caution
Anyone with the live dashboard or chart URLs can view all the information from the dashboard or chart. Share information carefully and in accordance with your company's internal policies and procedures.
Prerequisites
This feature includes multiple security layers and conditions to ensure controlled and secure data sharing. To share dashboards or charts publicly, ensure the following setup is in place. Refer to the Security and access management for setup details:
The Live URL control permission is enabled for all accounts sourcing the dashboard.
The custom role and permissions are configured for you to share dashboards and charts.
The accounts sourcing the dashboard or chart have grants for your role to share data externally.
You have access to all accounts sourcing the dashboard or chart.
You are the owner of the dashboard or chart you want to share.
You can share your dashboard by generating a live dashboard URL and managing its expiration duration. Additionally, you can view the list of generated URLs with details and revoke them at any time from the New Relic platform. To ensure security and compliance, monitor the audit trail for creating, updating, or revoking shared dashboard URLs.
Tip
You can create and manage live dashboard URLs through both the UI and the NerdGraph API.
To create a publicly accessible live URL for your dashboard:
Select Share dashboard. A confirmation message appears to acknowledge the following:
The dashboard does not contain sensitive information.
Accessing this shared dashboard from the live URL each time may consume your CCU.
Click Continue. The Share dashboard dialog appears.
Assign a duration for the URL to be live. The URL expires after the specified duration.
Click Save changes. A notification appears about the successful creation of the URL, and it is copied to your clipboard.
To render the shared dashboard page, click the notification, or manually browse to it in a new tab with the copied URL.
Important
Any content updates made to the actual dashboard on the New Relic platform are automatically reflected on the shared dashboard page. To prevent accidental data exposure, only the dashboard owner can update a publicly shared dashboard.
Ensure you have the necessary permissions, and you are the owner of the dashboard, to update the properties (live duration) of the shared dashboard.
Select Manage public link. The Share dashboard dialog appears.
Update the duration from the Link expiration drop-down. The Never expires option keeps the URL live for 30 years.
Click Save changes.
You can access shared dashboard names hyperlinked with their live URLs, all in one place on New Relic One. Depending on your permission, you can view either the URLs you have created or those created by all users in the account.
In the left navigation, click your name at the bottom.
Navigate to Administration > Shared Dashboards. The Shared Dashboards page provides a list of shared dashboards, including their creation and expiration dates, and the owner of each dashboard.
You can click the dashboard names to open the sharing pages in a new tab.
Depending on your permissions, you can revoke either the links you have created or those created by all users in the account. You can do this in the following ways:
On the dashboard you are sharing, click the Share icon and select Manage public link. In the Share dashboard dialog, select Revoke public link.
From the Shared Dashboards page, select the icon for the dashboard link and click Revoke.
Tip
Only the owner can delete a dashboard with a publicly shared link. Deleting the dashboard automatically revokes the public sharing link. If you restore the dashboard, you need to create a new live URL.
Creating, updating, or revoking shared dashboard URLs generates an audit trail in the NrAuditEvent. To view the records in the query builder:
Select the account from which the public dashboard links are created.
Run any of the following queries to view the audit trails:
To get the details of live dashboard URLs created or revoked in the last hour, run the following query:
FROM NrAuditEvent
SELECT*
WHERE actionIdentifier LIKE'%public_dashboard.%'
To get the details of live dashboard URLs created in the last hour, run the following query:
FROM NrAuditEvent
SELECT*
WHERE actionIdentifier LIKE'%public_dashboard.create%'
To get the details of live dashboard URLs revoked in the last hour, run the following query:
FROM NrAuditEvent
SELECT*
WHERE actionIdentifier LIKE'%public_dashboard.revoke%'
To get the details of live dashboard URLs created by a specific user in the last hour, replace <user_email> with the actual user email ID and run the following query:
FROM NrAuditEvent
SELECT*
WHERE actionIdentifier LIKE'%public_dashboard%'
AND actorType='user'
AND actorEmail=<user_email>
To get the details of live dashboard URLs created in an account in the last hour, replace <account_id> with the actual account ID and run the following query:
FROM NrAuditEvent
SELECT*
WHERE actionIdentifier LIKE'%public_dashboard%'
AND scopeType='account'
AND scopeId=<account_id>
To get the list of dashboards from which the live URLs are created in a specific time period, run the following query. It shows the number of URLs created for each dashboard.
Tip
The following example query retrieves records from the last week. You can adjust the time period as needed.
WITH aparse(description,'%for dashboard *')AS dashboardGUID
FROM NrAuditEvent
SELECTcount(*)AS'dashboards'
WHERE actionIdentifier LIKE'%public_dashboard.create%'
FACET dashboardGUID
SINCE 1 week ago
To get the list of operations performed with the live dashboard URLs in a specific time period, run the following query.
Tip
The following example query retrieves records from the last week. You can adjust the time period and the facet as needed.
WITH aparse(description,'%for dashboard *')AS dashboardGUID,
When using live dashboard URLs, it's important to understand the associated costs and how to manage them effectively. Public Dashboards is an Advanced Compute Product feature offered as an add-on or as a part of the Compute pricing model. Advanced CCUs are consumed when queries are executed from the dashboard visualizations, which happens in the following cases:
On page load
On time picker changes
On refresh-rate triggers
You can monitor your usage costs from New Relic Administration > Compute Management > Advanced capabilities.
Cost management practices
To keep your pricing optimal, consider the following standard practices:
Access control:
Manage who can create, edit, or delete links at both the account and user-role levels. This helps control and prevent users from having excessive access to these capabilities.
Link expiration management:
Set expiration times for links to ensure they are only visible for a certain period, reducing potential overuse.
Widget management:
Add or remove widgets from your internal dashboard to optimize the data being queried.
Update widgets to ignore time picker changes, preventing additional queries when users adjust the time range.
Manage the refresh rate of each widget to prevent automatic refreshes, aligning with your internal dashboard preferences. For more details, refer to Customize chart refresh rates.
Limitations
Following are the limitations of sharing dashboards publicly:
When viewing a shared dashboard in TV mode, it stays active for up to 72 hours. The viewer needs to refresh the browser to continue viewing.
If you are share a dashboard with widgets that use template variables, facet linking, custom visualizations, or log tables, these widgets will not display any information in the shared view.
If the dashboard's permission setting is Private, you can't share the dashboard publicly. To verify this, navigate to one.newrelic.com > Dashboards > Your dashboard > icon > Settings > Permissions.
Share your chart
To share a chart with external users, ensure you have completed all the setup steps outlined in the Prerequisites. To generate a shareable link for your chart: