Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ From the <Icon name="fe-more-horizontal"/> menu on any chart, you can:

* Add the chart to your [dashboards](/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard/) for easy monitoring.
* [Set up an alert](/docs/tutorial-create-alerts/create-an-alert/) to notify you of significant changes in usage.
* [Share a real-time view](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#chart) of your data with stakeholders.
* [Share a real-time view](/docs/query-your-data/explore-query-data/dashboards/share-charts-publicly) of your data with stakeholders.
* Save the chart as an image for presentations or reports.
* View the underlying query that powers the chart, which you can use for your own custom reports or deeper analysis.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ The `NrAuditEvent` is created to record some important types of configuration ch
* Login and logout events
* Account changes made via API
* [Synthetic monitor changes](/docs/synthetics/new-relic-synthetics/administration/audit-synthetics-account-changes)
* Dashboard creation, deletion, updates, and [public sharing](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#audit-trail-dashboard)
* Dashboard creation, deletion, updates, and [public sharing](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly/#audit-trail-dashboard)
* Workload configuration changes

To see all the attributes reported by this event, see [`NrAuditEvent`](/attribute-dictionary/?event=NrAuditEvent).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ freshnessValidatedDate: never

Charts are visual representations of data helping you understand and analyze information from your apps, infrastructure, or services. You can convert these charts into URLs and share them publicly. Public chart links allow you to easily share graphs and data with others, even if they don't have a New Relic account.

With the appropriate [security and access settings](/docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts/), you can create, manage, and revoke publicly accessible live chart URLs using queries and mutations in [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph/). Alternatively, you can perform these actions via the [New Relic UI](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#chart).
With the appropriate [access management configured](/docs/query-your-data/explore-query-data/dashboards/share-charts-publicly/#access-management), you can create, manage, and revoke publicly accessible live chart URLs using queries and mutations in [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph/). Alternatively, you can perform these actions via the [New Relic UI](/docs/query-your-data/explore-query-data/dashboards/share-charts-publicly).

<Callout variant="caution">
Anyone with access to the live chart URLs can view all the information from the underlying chart query. Ensure that information is shared cautiously and in compliance with your company's internal policies and procedures.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ metaDescription: Use New Relic NerdGraph to create, update, and revoke live dash
freshnessValidatedDate: never
---

With the necessary [security and access set up](/docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts) you can create, manage, and revoke publicly accessible live dashboard URLs using queries and mutations in [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph),
You can also do it from the [New Relic UI](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#dashboard).
With the necessary [access management configured](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly/#access-management) you can create, manage, and revoke publicly accessible live dashboard URLs using queries and mutations in [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph),
You can also do it from the [New Relic UI](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly).


<Callout variant="caution"> If a shared dashboard is not password-protected, anyone with the live URL can access and view all the information it contains. To prevent unwanted access, ensure you [create password-protected URLs](#create-dashboard-url-with-psswd-nerdgraph) or [enable password protection for existing shared URLs](#enable-password-dashboard-url-nerdgraph).</Callout>
Expand Down Expand Up @@ -133,13 +133,13 @@ To avoid unwanted access to the shared dashboard, you can create a live dashboar
}
```

The `uuid` is the ID of the shared dashboard. You can use it to [update](#update-dashboard-url-nerdgraph) or [revoke](revoke-dashboard-url-nerdgraph) the shared dashboard URL through NerdGraph. To share the dashboard with external users, copy the URL and password from the response. Passwords can not be retrieved later. If you lose it, you only have to [reset the password](#reset-password-dashboard-url-nerdgraph) and share it again with the users. Follow our [password management best practices](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#password-management) to manage the password securely.
The `uuid` is the ID of the shared dashboard. You can use it to [update](#update-dashboard-url-nerdgraph) or [revoke](revoke-dashboard-url-nerdgraph) the shared dashboard URL through NerdGraph. To share the dashboard with external users, copy the URL and password from the response. Passwords can not be retrieved later. If you lose it, you only have to [reset the password](#reset-password-dashboard-url-nerdgraph) and share it again with the users. Follow our [password management best practices](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly/#password-management) to manage the password securely.


</Collapser>

<Collapser id="update-dashboard-url-nerdgraph" title="Update live dashboard expiration duration">
Make sure you have the [permissions](/docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts/#permissions-to-custom-role) to modify the configuration of the shared dashboard.
Make sure you have the [permissions](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly/#configure-roles) to modify the configuration of the shared dashboard.

To update the time period for the URL to be live:
1. Go to [NerdGraph API explorer](https://one.newrelic.com/nerdgraph-graphiql).
Expand Down Expand Up @@ -178,7 +178,7 @@ To update the time period for the URL to be live:
</Collapser>

<Collapser id="enable-password-dashboard-url-nerdgraph" title="Enable password protection for the live URL">
Make sure you have the [permissions](/docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts/#permissions-to-custom-role) to modify the configuration of the shared dashboard.
Make sure you have the [permissions](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly/#configure-roles) to modify the configuration of the shared dashboard.
To enable password protection for a live dashboard URL:
1. Go to [NerdGraph API explorer](https://one.newrelic.com/nerdgraph-graphiql).
2. Construct a [graph API call](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) using the `dashboardUpdateLiveUrlAuth` mutation with following parameters:
Expand Down Expand Up @@ -224,13 +224,13 @@ To enable password protection for a live dashboard URL:
}
```

After enabling password for the shared dashboards, you need to share the password with the users. Copy and save the password, as you cann't retrieve it later. If you lose it, you only have to [reset the password](#reset-password-dashboard-url-nerdgraph) and share it again with the users. Follow our [password management best practices](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#password-management) to manage the password securely.
After enabling password for the shared dashboards, you need to share the password with the users. Copy and save the password, as you cann't retrieve it later. If you lose it, you only have to [reset the password](#reset-password-dashboard-url-nerdgraph) and share it again with the users. Follow our [password management best practices](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly/#password-management) to manage the password securely.


</Collapser>

<Collapser id="disable-password-dashboard-url-nerdgraph" title="Disable password protection for the live URL">
Make sure you have the [permissions](/docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts/#permissions-to-custom-role) to modify the configuration of the shared dashboard.
Make sure you have the [permissions](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly/#configure-roles) to modify the configuration of the shared dashboard.
To disable password protection for a live dashboard URL:
1. Go to [NerdGraph API explorer](https://one.newrelic.com/nerdgraph-graphiql).
2. Construct a [graph API call](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) using the `dashboardUpdateLiveUrlAuth` mutation with following attribute values:
Expand Down Expand Up @@ -272,7 +272,7 @@ To disable password protection for a live dashboard URL:
</Collapser>

<Collapser id="reset-password-dashboard-url-nerdgraph" title="Reset password for the live URL">
Make sure you have the [permissions](/docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts/#permissions-to-custom-role) to modify the configuration of the shared dashboard.
Make sure you have the [permissions](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly/#configure-roles) to modify the configuration of the shared dashboard.
To reset the password for a live dashboard URL:
1. Go to [NerdGraph API explorer](https://one.newrelic.com/nerdgraph-graphiql).
2. Construct a [graph API call](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) using the `dashboardResetLiveUrlPassword` mutation with the following attribute values:
Expand Down Expand Up @@ -302,13 +302,13 @@ To reset the password for a live dashboard URL:
}
```

After resetting password for the shared dashboards, you need to share the new password with the users. Copy and save the password, as you cann't retrieve it later. If you lose it, you only have to reset it again. Follow our [password management best practices](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#password-management) to manage the password securely.
After resetting password for the shared dashboards, you need to share the new password with the users. Copy and save the password, as you cann't retrieve it later. If you lose it, you only have to reset it again. Follow our [password management best practices](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly/#password-management) to manage the password securely.


</Collapser>

<Collapser id="revoke-dashboard-url-nerdgraph" title="Revoke a live URL">
Based on the [permissions](/docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts/#permissions-to-custom-role) you have, you can revoke only the URLs you have created, or all URLs created by users in the account. To revoke a shared dashboard URL:
Based on the [permissions](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly/#configure-roles) you have, you can revoke only the URLs you have created, or all URLs created by users in the account. To revoke a shared dashboard URL:
1. Go to [NerdGraph API explorer](https://one.newrelic.com/nerdgraph-graphiql).
2. Construct a [graph API call](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) using the `dashboardRevokeLiveUrl` mutation with the following attribute value:
* `id`: Copy the ID from the shared dashboard URL and enter it.
Expand Down Expand Up @@ -339,7 +339,7 @@ Based on the [permissions](/docs/query-your-data/explore-query-data/dashboards/p
</Collapser>

<Collapser id="list-dashboard-url-nerdgraph" title="List all shared URLs">
Based on the [permissions](/docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts/#permissions-to-custom-role) you have, you can retrieve the list of URLs you have created, or all URLs created by users in the account. To get the list of shared dashboard URLs:
Based on the [permissions](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly/#configure-roles) you have, you can retrieve the list of URLs you have created, or all URLs created by users in the account. To get the list of shared dashboard URLs:
1. Go to [NerdGraph API explorer](https://one.newrelic.com/nerdgraph-graphiql).
2. Construct a [graph API call](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) using the following details:
* `actor` > `dashboard` > `liveUrls`: Use this to retrieve the list of shared dashboard URLs.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ For how to create a dashboard with data from multiple accounts, see [the NerdGra

## Create embeddable charts [#embeddable-charts]

In addition to returning raw data, you can fetch embeddable chart links for the data to use in an application. Please refer to our [public chart docs](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#chart).
In addition to returning raw data, you can fetch embeddable chart links for the data to use in an application. Please refer to our [public chart docs](/docs/query-your-data/explore-query-data/dashboards/share-charts-publicly).

## Suggested facets [#suggest-facets]

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
---
title: Introduction to public sharing
tags:
- Public dashboards
- Share dashboards publicly
- Share charts publicly
- Live URLs
- Dashboards
- Charts
- Public sharing
- Get started
metaDescription: "An overview of public sharing in New Relic: share dashboards and charts externally via live URLs."
redirects:
- /docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts
freshnessValidatedDate: never
---

New Relic lets you share dashboards and individual charts with viewers outside your organization via live URLs — no New Relic account required. This is useful for sharing real-time monitoring data with customers, business partners, or executives who need visibility into your systems without direct platform access.

Consider a scenario where your company provides a critical backend service to a major business customer. During a service disruption, that customer needs timely and accurate status updates. Instead of sending periodic, static email updates, you can give them a direct, real-time view of the situation. Your engineering team has a New Relic dashboard monitoring service health — transaction throughput, error rates, and more. When an issue arises, your account manager shares the URL of a specific chart showing the problem, or the secure, password-protected URL for the entire dashboard, directly with the customer's technical lead.

By sharing the link, you give your customer a live, transparent view of the recovery process. They can see the metrics improve in real time as your team deploys fixes, which reduces the need for status-update requests and builds significant trust. The value is in the direct, secure sharing of the URL itself — providing a single source of truth during a critical event.

To add an extra layer of security, you can enable password protection when sharing dashboards. This ensures that only users with both the URL and the password can access the shared content.

<Callout variant="caution">
Anyone with a live URL can view all the information from the shared dashboard or chart. Share information carefully and in accordance with your company's internal policies and procedures.
</Callout>

<Callout variant="important">
While the chart sharing feature is available to **Pro**, **Enterprise**, and **Core Compute** customers, the dashboard sharing feature is available only to **Pro** and **Enterprise** customers with [Advanced Compute](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing) enabled. To learn more about the associated costs and management practices for the dashboard sharing feature, refer to the [Pricing](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly/#public-dashboard-pricing) section.
</Callout>

## Viewer experience [#viewer-experience]

When external users access a shared dashboard or chart, the page renders with the same data and visualizations as the original, 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.

## Share dashboards publicly [#share-dashboards]

Public dashboard sharing gives external viewers a live, read-only view of an entire dashboard. Viewers can interact with the time range picker, toggle light or dark mode, and enable TV mode — without needing a New Relic account.

To set up and share a dashboard publicly, see [Share dashboards publicly](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly). That page covers:

- Enabling the required account-level policy
- Configuring user roles and permissions
- Creating and managing live URLs (password protection, expiration, revocation)
- Pricing details and best practices
- Limitations

## Share charts publicly [#share-charts]

Chart sharing lets you share individual chart visualizations with external viewers. Charts are shared via live URLs that render the current chart data in a lightweight, embeddable view.

To share a chart publicly, see [Share charts publicly](/docs/query-your-data/explore-query-data/dashboards/share-charts-publicly). That page covers:

- Configuring user roles and permissions
- Generating a live chart URL from the New Relic UI
- Managing chart URLs via the NerdGraph API

## Related topics

<DocTiles>
<DocTile title="Share dashboards publicly" path="/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly">
Full reference for sharing dashboards: policy setup, access management, live URL management, pricing, and limitations.
</DocTile>
<DocTile title="Share charts publicly" path="/docs/query-your-data/explore-query-data/dashboards/share-charts-publicly">
Share individual charts with external viewers via live URLs.
</DocTile>
<DocTile title="Manage live dashboard URLs via NerdGraph" path="/docs/apis/nerdgraph/examples/manage-live-dashboard-urls-via-api">
Programmatically create, update, and revoke live dashboard URLs using the NerdGraph API.
</DocTile>
<DocTile title="Manage live chart URLs via NerdGraph" path="/docs/apis/nerdgraph/examples/manage-live-chart-urls-via-api">
Programmatically create, manage, and revoke live chart URLs using the NerdGraph API.
</DocTile>
</DocTiles>
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ Use dashboards to:
* Explore and contextualize data with [advanced tooltips and zoom-in functions](#key-visual-tools) to monitor what your systems are doing in real time.
* Search your dashboards for attributes and metrics.
* [Report custom data](/docs/data-apis/custom-data/get-custom-data-from-any-source/) to New Relic and your dashboards from any source.
* Share dashboards with stakeholders outside your New Relic organization via [publicly accessible live dashboard URLs](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#dashboard).
* Share dashboards with stakeholders outside your New Relic organization via [publicly accessible live dashboard URLs](/docs/query-your-data/explore-query-data/dashboards/share-dashboards-publicly).

## Get started with dashboards [#get-started]

Expand Down
Loading
Loading