From 39fcfd0ee43c8f4cf34020dd42f249532ac8b0ee Mon Sep 17 00:00:00 2001 From: Bradley Camacho Date: Tue, 19 Dec 2023 13:28:53 -0800 Subject: [PATCH 1/3] feat(data): rewrite doc w/ refreshed content --- .../dashboards-charts-import-export-data.mdx | 60 +++++++++++++------ 1 file changed, 43 insertions(+), 17 deletions(-) diff --git a/src/content/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data.mdx b/src/content/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data.mdx index c11820441de..bd4b57fe472 100644 --- a/src/content/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data.mdx +++ b/src/content/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data.mdx @@ -10,34 +10,60 @@ redirects: freshnessValidatedDate: never --- -import dashboardsDashboardMenu from 'images/dashboards_screenshot-crop_dashboard-menu.webp' - - -[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. +You can use [dashboards](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/) to visual and track how your system is doing, tackle issues, and plan next steps. Learn to share all that information with your team, customers, or other stakeholders with various import and export options. ## Import, share, and export dashboards [#dashboards] +### Import 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: +### Export dashboards -* 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. -Dashboard menu.png +You can export your dashboard as either a comma-seperated file(CSV) or a PDF. -You can also [duplicate your dashboard](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/#dashboards-clone). + + + + Export CSV + + + Export PDF + + + + + + +From any dashboard, export charts as CSVs by clicking the dropdown in the top right of a chart and selecting **Export as CSV**. This will download your data as a CSV. + +While powerful, exporting as a CSV has limitations. A few things to keep in mind: +* Data always exports in UTC time (-7:00) +* Export does not support aggregator functions like `average()` +* Export does not support the `COMPARE_WITH` clause -## Add and share charts and content from your dashboards [#charts] + + + +Export your dashboard as a pdf file by clicking the `...` button in the top right and selecting **Export dashboard as PDF.** + + + + + + +### Share dashboards +From any dashboard, share it with one of these 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. +* Copy your dashboard **as JSON** and add it to the clipboard by clicking the `...` button in the top right and selecting **Copy JSON to clipboard**. + +You can also [duplicate your dashboard](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/#dashboards-clone). -### Add new content to a dashboard [#charts-add] +## Add new content to a dashboard [#charts-add] -You can add new content to any dashboard from [metrics and events](/docs/query-your-data/explore-query-data/data-explorer/introduction-data-explorer) and [query builder](/docs/introduction-chart-builder) features. +You can add new content in the form of [metrics and events](/docs/query-your-data/explore-query-data/data-explorer/introduction-data-explorer) to any dashboard through the [query builder](/docs/introduction-chart-builder) feature. Also, in a given dashboard, to add content: From 1ffd142f67d46f38c54de592d95b36113993ae89 Mon Sep 17 00:00:00 2001 From: Bradley Camacho Date: Tue, 19 Dec 2023 13:49:59 -0800 Subject: [PATCH 2/3] feat: peer edits --- .../dashboards-charts-import-export-data.mdx | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/src/content/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data.mdx b/src/content/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data.mdx index bd4b57fe472..bbbf5ec0cc7 100644 --- a/src/content/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data.mdx +++ b/src/content/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data.mdx @@ -10,7 +10,7 @@ redirects: freshnessValidatedDate: never --- -You can use [dashboards](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/) to visual and track how your system is doing, tackle issues, and plan next steps. Learn to share all that information with your team, customers, or other stakeholders with various import and export options. +You can use [dashboards](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/) to visualalize and track your system's health, tackle issues, and plan any further steps. Learn to share all that information with your team, customers, or other stakeholders with various import and export options. ## Import, share, and export dashboards [#dashboards] @@ -39,14 +39,15 @@ You can export your dashboard as either a comma-seperated file(CSV) or a PDF. From any dashboard, export charts as CSVs by clicking the dropdown in the top right of a chart and selecting **Export as CSV**. This will download your data as a CSV. While powerful, exporting as a CSV has limitations. A few things to keep in mind: -* Data always exports in UTC time (-7:00) -* Export does not support aggregator functions like `average()` -* Export does not support the `COMPARE_WITH` clause + +- Data always exports in UTC time (-7:00) +- Export doesn't support aggregator functions like `average()` +- Export doesn't support the `COMPARE_WITH` clause -Export your dashboard as a pdf file by clicking the `...` button in the top right and selecting **Export dashboard as PDF.** +Export your dashboard as a pdf file by clicking the `...` button in the top right and selecting **Export dashboard as PDF**. From 73e933ccaf0215097a25c9d457cdc155eb954647 Mon Sep 17 00:00:00 2001 From: Bradley Camacho Date: Tue, 19 Dec 2023 14:59:14 -0800 Subject: [PATCH 3/3] feat: reformat all headers into h2s for readability --- .../dashboards-charts-import-export-data.mdx | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/src/content/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data.mdx b/src/content/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data.mdx index bbbf5ec0cc7..d4717b845c3 100644 --- a/src/content/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data.mdx +++ b/src/content/docs/query-your-data/explore-query-data/dashboards/dashboards-charts-import-export-data.mdx @@ -12,13 +12,11 @@ freshnessValidatedDate: never You can use [dashboards](/docs/query-your-data/explore-query-data/dashboards/introduction-dashboards/) to visualalize and track your system's health, tackle issues, and plan any further steps. Learn to share all that information with your team, customers, or other stakeholders with various import and export options. -## Import, share, and export dashboards [#dashboards] - -### Import dashboards +## Import 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)**. -### Export dashboards +## Export dashboards You can export your dashboard as either a comma-seperated file(CSV) or a PDF. @@ -54,7 +52,7 @@ Export your dashboard as a pdf file by clicking the `...` button in the top righ -### Share dashboards +## Share dashboards From any dashboard, share it with one of these 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. @@ -73,7 +71,7 @@ Also, in a given dashboard, to add content: 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] +## Troubleshooting chart errors [#chart-error-messages] When adding charts you may come across these error messages: