From ed5794b2631395c428e8187aefa767518b86bd9f Mon Sep 17 00:00:00 2001 From: sujitnewrelic Date: Wed, 22 Jan 2025 13:13:31 +0530 Subject: [PATCH] Authoring in progress --- .../examples/nerdgraph-dashboards.mdx | 14 +++++++ ...erequisites-to-share-dashboards-charts.mdx | 6 +-- .../dashboards/manage-your-dashboard.mdx | 4 +- .../share-charts-dashboards-internally.mdx | 40 +++++++++++++++++++ .../dashboards/share-dashboard-internally.mdx | 27 ------------- src/nav/dashboards.yml | 2 +- 6 files changed, 60 insertions(+), 33 deletions(-) create mode 100644 src/content/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-internally.mdx delete mode 100644 src/content/docs/query-your-data/explore-query-data/dashboards/share-dashboard-internally.mdx diff --git a/src/content/docs/apis/nerdgraph/examples/nerdgraph-dashboards.mdx b/src/content/docs/apis/nerdgraph/examples/nerdgraph-dashboards.mdx index 836a1f6ef6e..974fa8c6a98 100644 --- a/src/content/docs/apis/nerdgraph/examples/nerdgraph-dashboards.mdx +++ b/src/content/docs/apis/nerdgraph/examples/nerdgraph-dashboards.mdx @@ -290,6 +290,20 @@ Here are operations related to creating, reading, updating, and deleting (CRUD). Revoke publicly accessible live dashboard URL. + + + + `dashboardUpdateLiveUrlCreationPolicies()` + + + + mutation + + + + Only an Authentication Domain Manager can use this mutation to enable or disable the **Live Url Creation** policy for accounts. Users can create live URLs for dashboards only in accounts where this policy is enabled. + + diff --git a/src/content/docs/query-your-data/explore-query-data/dashboards/Prerequisites-to-share-dashboards-charts.mdx b/src/content/docs/query-your-data/explore-query-data/dashboards/Prerequisites-to-share-dashboards-charts.mdx index 68bfd5def5c..15d1f0a8089 100644 --- a/src/content/docs/query-your-data/explore-query-data/dashboards/Prerequisites-to-share-dashboards-charts.mdx +++ b/src/content/docs/query-your-data/explore-query-data/dashboards/Prerequisites-to-share-dashboards-charts.mdx @@ -21,13 +21,13 @@ Each of the following personas has specific responsibilities in this process: * **Authentication domain manager**: Controls the feature's enablement in account level. * **Administrator**: Configures custom roles and permissions for users to manage live URLs. -## Feature enablement [#feature-enablement] +## Policy enablement [#policy-enablement] For sharing dashboards publicly, the Authentication domain manager needs to check and enable the **Live Url Creation** policy at the account level. This is not applicable to chart sharing. The Authentication domain manager can check the status of this policy in accounts, and enable or disable it only via NerdGraph API. As an Authentication Domain Manager, you can check the current status of the **Live Url Creation** policy in specific accounts. Use the [NerdGraph API explorer](https://one.newrelic.com/nerdgraph-graphiql) to construct a [graph API call](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) as following. Replace `1, 2, 3` with actual account IDs. If you don't provide the account IDs, the call returns the status of your authorized account. You can query up to 100 accounts simultaneously. @@ -78,7 +78,7 @@ For sharing dashboards publicly, the Authentication domain manager needs to chec As an Authentication Domain Manager, you can enable or disable the **Live Url Creation** policy in specific accounts. Ensure you have authorization for these accounts. Use the [NerdGraph API explorer](https://one.newrelic.com/nerdgraph-graphiql) to construct a [graph API call](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) as given here with the following changes: * Replace `1, 2, 3` with actual account IDs. diff --git a/src/content/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard.mdx b/src/content/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard.mdx index bc0eb29a265..e39a1572449 100644 --- a/src/content/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard.mdx +++ b/src/content/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard.mdx @@ -122,9 +122,9 @@ Click a dashboard to open its charts. A dashboard page includes these features: id="dash-share" title="Share your dashboard" > - You can [share your dashboard with your internal team](/docs/query-your-data/explore-query-data/dashboards/share-dashboard-internally) via a permalink. To share the dashboard with viewers outside your New Relic organization, you need to create publicly accessible live dashboard URLs and share them. This can be done using both the [UI](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashbords-externally) and [NerdGraph](/docs/apis/nerdgraph/examples/manage-live-dashboard-urls-via-api). When sharing the dashboard externally, you can set an expiration date for the shared dashboard URL. + You can [share your dashboard with your internal team](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-internally) via a permalink. To share the dashboard with viewers outside your New Relic organization, you need to create publicly accessible live dashboard URLs and share them. This can be done using both the [UI](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashbords-externally) and [NerdGraph](/docs/apis/nerdgraph/examples/manage-live-dashboard-urls-via-api). When sharing the dashboard externally, you can set a time period for the shared dashboard URL to remain live. - Anyone with the live dashboard URL can view all the information from the dashboard. Share information carefully and in accordance with your company's internal policies and procedures. + Anyone with a live dashboard URL for an externally shared dashboard can view all the information on that dashboard. Share information carefully, adhering to your company's internal policies and procedures. diff --git a/src/content/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-internally.mdx b/src/content/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-internally.mdx new file mode 100644 index 00000000000..4cacdedeb3d --- /dev/null +++ b/src/content/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-internally.mdx @@ -0,0 +1,40 @@ +--- +title: Share dashboards and charts internally +tags: + - Share dashboards internally + - Share charts internally + - Internal sharing + - Dashboards + - Charts +metaDescription: 'Share dashboards and charts within the team.' +redirects: +freshnessValidatedDate: 2025-01-16 +--- + +## Share your dashboards internally [#share-dashboards-internally] + +You can share any dashboard within your team using any of the following options: + +* Copy the dashboard's permalink by clicking the link icon in the top right of a dashboard. Permalinks share a direct link to the dashboard. + + +Or + + +* Copy your dashboard in ** JSON** format as follows, and share it within your team. + 1. Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Dashboards**. + 2. Click the icon in the top right corner of the dashboard. + 3. Select **Copy JSON to clipboard**. + 4. Paste the JSON code into a message or document to share it with your team. + + +## Share your charts internally [#share-charts-internally] +Similar to dashboards, you can share charts within your team by following these steps: + +1. Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Dashboards**. +2. Open the dashboard that contains the chart you want to share. +3. Select **View query** from the menu of the chart. The query opens in the Query builder. +4. From the Query builder, click **Copy query link**. The link is copied to your clipboard. +5. Share it with your team member via email, chat, or any other communication tool. + + diff --git a/src/content/docs/query-your-data/explore-query-data/dashboards/share-dashboard-internally.mdx b/src/content/docs/query-your-data/explore-query-data/dashboards/share-dashboard-internally.mdx deleted file mode 100644 index acb72a4d79d..00000000000 --- a/src/content/docs/query-your-data/explore-query-data/dashboards/share-dashboard-internally.mdx +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Share dashboards internally -tags: - - Share dashboards internally - - Internal sharing - - Dashboards -metaDescription: 'Share dashboards within the team.' -redirects: -freshnessValidatedDate: 2025-01-16 ---- - - -You can share any dashboard within your team using any of the following options: - -* Copy the dashboard's permalink by clicking the link icon in the top right of a dashboard. Permalinks share a direct link to the dashboard. - - -Or - - -* Copy your dashboard in ** JSON** format as follows, and share it within your team. - 1. Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Dashboards**. - 2. Click the icon in the top right corner of the dashboard. - 3. Select **Copy JSON to clipboard**. - 4. Paste the JSON code into a message or document to share it with your team. - - diff --git a/src/nav/dashboards.yml b/src/nav/dashboards.yml index 7ef8b568aef..f9d163c89e6 100644 --- a/src/nav/dashboards.yml +++ b/src/nav/dashboards.yml @@ -36,7 +36,7 @@ pages: - title: Share dashboards and charts pages: - title: Share internally - path: /docs/query-your-data/explore-query-data/dashboards/share-dashboard-internally + path: /docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-internally - title: Share externally path: /docs/query-your-data/explore-query-data/dashboards/share-charts-dashbords-externally - title: Security and access management for external sharing