Skip to content

Commit

Permalink
Merge pull request #2849 from newrelic/DOC-6974-Import-export-data-fr…
Browse files Browse the repository at this point in the history
…om-dashboards

[DOC-6974] Dashboards and charts import/export
  • Loading branch information
urbiz-nr committed Jul 2, 2021
2 parents ca28ce8 + 4994fe4 commit 28590da
Show file tree
Hide file tree
Showing 5 changed files with 189 additions and 121 deletions.
@@ -0,0 +1,182 @@
---
title: Import, export, add, and share dashboards and charts
tags:
- Query your data
- Explore and query data
- Dashboards
- Charts
metaDescription: 'Import and export data from dashboards and charts.'
redirects:
---

[Dashboards](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/) is a powerful tool to visualize and track how your system is doing, and allows you to tackle issues and plan next steps. Learn to share all that information with your team, customers, or other stakeholders, using the following options to import, share and export dashboards, or add and share charts (or other content) in a dashboard.


## Import, share, and export dashboards [#dashboards]

At the [dashboards index](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/#get-started), you can **[import a dashboard as JSON](docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/#dashboards-import)**.

From any dashboard, share it with one of these options:

* Copy the dashboard's permalink.
* Copy your dashboard **as JSON** and add it to the clipboard by clicking on the **</>** icon on the right corner.
* Export your dashboard **as a pdf file** clicking the <Icon name="fe-download"/> icon.

![Dashboard menu.png](./images/20210628_dashboard_menu.png "dashboard_menu.png")

You can also [clone your dashboard](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/#dashboards-clone).

## Add and share charts and content from your dashboards [#charts]

### Add new content to a dashboard [#charts-add]

You can add new content to any dashboard from the [data explorer](/docs/query-your-data/explore-query-data/data-explorer/introduction-data-explorer) and [query builder](/docs/introduction-chart-builder) features.

Also, in a given dashboard, to add content:
* Click the edit <Icon name="fe-edit-2"/> button at the top right corner, then create new content by clicking the **Add widget** button. Add a new chart using the [query builder](/docs/chart-builder/use-chart-builder/get-started/introduction-chart-builder), or add text, images, or links using our [markdown editor](#markdown).
* Use the **+ Add to your dashboard** button.

From any chart, use the chart action menu on the upper right corner to **copy or duplicate** the chart.

### Troubleshooting chart errors [#chart-error-messages]

When adding charts you may come across these error messages:

<table>
<thead>
<tr>
<th style={{ width: "400px" }}>
**Error message**
</th>
<th style={{ width: "400px" }}>
**Description**
</th>
</tr>
</thead>
<tbody>
<tr>
<td>
External Service 'NRDB' execution resulted in 400 - cause: TIMESERIES step size is larger than the current time window.
</td>

<td>
The [`TIMESERIES`](/docs/query-your-data/nrql-new-relic-query-language/get-started/nrql-syntax-clauses-functions/#sel-timeseries) step size is larger than the selected time window. Modify the step and run the query again.
</td>
</tr>

<tr>
<td>
External Service 'NRDB' execution resulted in 400 - cause: Your query's start time must be before its end time.
</td>

<td>
The provided `startTime` of the query must be before the `endTime`. Modify it and run the query again.
</td>
</tr>

<tr>
<td>
NerdGraphGetAuthorizedAccountsCommand short-circuited and fallback disabled.
</td>

<td>
Communication failed while we were authorizing the request. Try again in a few minutes.
</td>
</tr>

<tr>
<td>
No application was matched (did you specify appId, appName or entity.guid?)
</td>

<td>
No entity matched the query. Review the specified `appId`, `appName` or `entity.guid` and run the query again.
</td>
</tr>

<tr>
<td>
NRQL Syntax Error: Error at line 1 position 15, unexpected 'FROM'

FACET and TIMESERIES are not supported on events.
</td>

<td>
Your query has syntax issues. Review it in the [query builder](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder/) to find the error.
</td>
</tr>

<tr>
<td>
Query rejected due to inspected count limit exceeded by this query group.
</td>

<td>
You’ve exceeded your querying limits. Check out our data [usage limits and policies per account](/docs/licenses/license-information/general-usage-licenses/new-relic-data-usage-limits-policies/).
</td>
</tr>

<tr>
<td>
Something went wrong while executing your query.
</td>

<td>
There was an unexpected error while fetching the data. Try again in a few minutes. If this persists, contact support at https://support.newrelic.com/.
</td>
</tr>

<tr>
<td>
TIMESERIES supports a maximum of 366 buckets
</td>

<td>
The [`TIMESERIES`](/docs/query-your-data/nrql-new-relic-query-language/get-started/nrql-syntax-clauses-functions/#sel-timeseries) bucket size is too low to span all the selected time window. Modify the bucket size and run the query again.
</td>
</tr>

<tr>
<td>
You are not authorized to query account 2022412
</td>

<td>
You don’t have access to this account. Contact your admin for further assistance.
</td>
</tr>

<tr>
<td>
Your query either timed out or we're under heavy load. Navigate to https://support.newrelic.com/ for further assistance.
</td>

<td>
NRDB is experiencing heavy loads, which cause intermittent time-outs. Try again in a few minutes.
</td>
</tr>

<tr>
<td>
Validation error on 'nrql': a query must be specified
</td>

<td>
You need to provide a valid NRQL query. Learn more about [our query language](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/).
</td>
</tr>

</tbody>
</table>

### Share your charts and markdown content [#charts-share]

From any chart, access the chart action menu on the upper right corner to:

* Share your chart as a **PNG image** or with **a link**. Go to the chart menu and select either the **Get as image** or **Get chart link** options.
* For table charts only, **export as a `.csv` file**. You can import this file into other apps like Microsoft Excel or Google Sheets to do further analysis.
* Copy the chart to any dashboard.

![Chart action menu.png](./images/20210628_chart_menu.png "chart_action_menu.png")


Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Expand Up @@ -68,9 +68,9 @@ Dashboards features include:
Use the edit <Icon name="fe-edit-2"/>
button to:

* Copy the dashboard's permalink.
* Rename your dashboard. Names are searchable, so we recommend giving it a meaningful name.
* Create new content by clicking the **Add widget** button. Add a new chart using the [query builder](/docs/chart-builder/use-chart-builder/get-started/introduction-chart-builder), or add text, images, or links using our [markdown editor](#markdown).
* [Add a new page](#add-pages). Pages allow you to better organize your dashboards.
* Resize and rearrange charts. You can move any chart and put it anywhere in the dashboard so the layout you set fits your preferences: place your more relevant charts on top, or drop less used charts in a corner. You can set up to 12 columns of charts.
</Collapser>

Expand Down Expand Up @@ -153,133 +153,15 @@ There are multiple ways to add new content to your dashboard:
* Use the **+ Add to your dashboard** button (accessible from the main dashboard page or in the edit mode) to access the [query builder](/docs/chart-builder/use-chart-builder/get-started/introduction-chart-builder), or to add content (such as text, links, or images) using our [Markdown editor](#dash-create-chart).
* [Copy an existing chart](#dash-manage-charts) from any dashboard.

If you experience issues adding new content, [check our error messages](/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data/#chart-error-messages).

### Add custom content using the markdown editor [#markdown]

The Markdown editor contains a **Markdown** pane, where you enter your content, as well as a **Preview** pane, where you can view it. For more information about Markdown syntax options, see the [Commonmark website](https://commonmark.org/help/).

You can also edit existing content by clicking the ellipses <Icon name="fe-more-horizontal"/>
icon on any markdown widget and selecting **Edit**.

### Issues with content [#chart-error-messages]

When adding charts you may come across these issues:

<table>
<thead>
<tr>
<th style={{ width: "400px" }}>
**Error message**
</th>
<th style={{ width: "400px" }}>
**Description**
</th>
</tr>
</thead>
<tbody>
<tr>
<td>
Something went wrong while executing your query.
</td>

<td>
There was an unexpected error while fetching the data. Try again in a few minutes. If this persists, contact [support](https://support.newrelic.com/).
</td>
</tr>
<tr>
<td>
Your query either timed out or we're under heavy load. Navigate to https://support.newrelic.com/ for further assistance.
</td>

<td>
NRDB is experiencing heavy loads, which cause intermittent time-outs. Try again in a few minutes.
</td>
</tr>
<tr>
<td>
You are not authorized to query account 2022412
</td>

<td>
You don’t have access to this account. Contact your admin for further assistance.
</td>
</tr>
<tr>
<td>
TIMESERIES step size is larger than the current time window.
</td>

<td>
The [`TIMESERIES`](/docs/query-your-data/nrql-new-relic-query-language/get-started/nrql-syntax-clauses-functions/#sel-timeseries) step size is larger than the selected time window. Modify the step and run the query again.
</td>
</tr>
<tr>
<td>
NerdGraphGetAuthorizedAccountsCommand short-circuited and fallback disabled.
</td>

<td>
Communication failed while we were authorizing the request. Try again in a few minutes.
</td>
</tr>
<tr>
<td>
TIMESERIES supports a maximum of 366 buckets
</td>

<td>
The [`TIMESERIES`](/docs/query-your-data/nrql-new-relic-query-language/get-started/nrql-syntax-clauses-functions/#sel-timeseries) bucket size is too low to span all the selected time window. Modify the bucket size and run the query again.
</td>
</tr>
<tr>
<td>
Query rejected due to inspected count limit exceeded by this query group.
</td>

<td>
You’ve exceeded your querying limits. Check out our data [usage limits and policies per account](/docs/licenses/license-information/general-usage-licenses/new-relic-data-usage-limits-policies/).
</td>
</tr>
<tr>
<td>
No application was matched (did you specify appId, appName or entity.guid?)
</td>

<td>
No entity matched the query. Review the specified `appId`, `appName` or `entity.guid` and run the query again.
</td>
</tr>
<tr>
<td>
Your query's start time must be before its end time.
</td>

<td>
The provided `startTime` of the query must be before the `endTime`. Modify it and run the query again.
</td>
</tr>
<tr>
<td>
Validation error on 'nrql': a query must be specified
</td>

<td>
You need to provide a valid NRQL query. Learn more about [our query language](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/).
</td>
</tr>
<tr>
<td>
NRQL Syntax Error: Error at line 1 position 15, unexpected 'FROM'

FACET and TIMESERIES are not supported on events.
</td>

<td>
Your query has syntax issues. Review it in the [query builder](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder/) to find the error.
</td>
</tr>
</tbody>
</table>

## Organize your dashboards with pages [#add-pages]

You can use multiple pages to organize your dashboard data in different views. When you add more pages to that dashboard, you can access these pages using the tabs at the top of the dashboard UI.
Expand Down Expand Up @@ -322,7 +204,9 @@ From any markdown element, access the menu on the upper right corner to edit or
* [Share your chart](#dash-export) as an image or with a link.
* Copy the chart to any dashboard.
* For table charts only, export as a `.csv` file. You can import this file into other apps like Microsoft Excel or Google Sheets to do further analysis.
* Create an alert condition.
* Access the [query builder](/docs/chart-builder/use-chart-builder/get-started/introduction-chart-builder) to see or edit the query associated to the chart.
* Duplicate the chart.
* Delete the chart.

<Callout variant="important">
Expand Down
2 changes: 2 additions & 0 deletions src/nav/new-relic-in-practice.yml
Expand Up @@ -194,6 +194,8 @@ pages:
path: /docs/query-your-data/explore-query-data/dashboards/add-custom-visualizations-your-dashboards
- title: Manage your dashboard
path: /docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard
- title: Import, export and share dashboards and charts
path: /docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data
- title: Filter dashboards by facets
path: /docs/query-your-data/explore-query-data/dashboards/filter-new-relic-one-dashboards-facets
- title: New Relic Global Performance data sets
Expand Down

0 comments on commit 28590da

Please sign in to comment.