diff --git a/src/frontend/src/assets/dashboard/explore/manage-data-dialog.png b/src/frontend/src/assets/dashboard/explore/manage-data-dialog.png new file mode 100644 index 00000000..97018a76 Binary files /dev/null and b/src/frontend/src/assets/dashboard/explore/manage-data-dialog.png differ diff --git a/src/frontend/src/assets/dashboard/explore/manage-data-expanded.png b/src/frontend/src/assets/dashboard/explore/manage-data-expanded.png new file mode 100644 index 00000000..5a560d68 Binary files /dev/null and b/src/frontend/src/assets/dashboard/explore/manage-data-expanded.png differ diff --git a/src/frontend/src/assets/dashboard/explore/pause-telemetry.png b/src/frontend/src/assets/dashboard/explore/pause-telemetry.png index 2ed7a457..d9669998 100644 Binary files a/src/frontend/src/assets/dashboard/explore/pause-telemetry.png and b/src/frontend/src/assets/dashboard/explore/pause-telemetry.png differ diff --git a/src/frontend/src/assets/dashboard/explore/remove-all-telemetry.png b/src/frontend/src/assets/dashboard/explore/remove-all-telemetry.png deleted file mode 100644 index cc478fac..00000000 Binary files a/src/frontend/src/assets/dashboard/explore/remove-all-telemetry.png and /dev/null differ diff --git a/src/frontend/src/assets/dashboard/explore/remove-telemetry-data.png b/src/frontend/src/assets/dashboard/explore/remove-telemetry-data.png index 8c4dd191..4b35a3fe 100644 Binary files a/src/frontend/src/assets/dashboard/explore/remove-telemetry-data.png and b/src/frontend/src/assets/dashboard/explore/remove-telemetry-data.png differ diff --git a/src/frontend/src/assets/dashboard/explore/settings-manage-telemetry.png b/src/frontend/src/assets/dashboard/explore/settings-manage-telemetry.png new file mode 100644 index 00000000..bd778dba Binary files /dev/null and b/src/frontend/src/assets/dashboard/explore/settings-manage-telemetry.png differ diff --git a/src/frontend/src/content/docs/dashboard/explore.mdx b/src/frontend/src/content/docs/dashboard/explore.mdx index 333823d6..8e07142f 100644 --- a/src/frontend/src/content/docs/dashboard/explore.mdx +++ b/src/frontend/src/content/docs/dashboard/explore.mdx @@ -57,7 +57,10 @@ import metricsPageExemplars from '@assets/dashboard/explore/metrics-page-exempla import tracePageFromExemplars from '@assets/dashboard/explore/trace-page-from-exemplars.png'; import pauseTelemetry from '@assets/dashboard/explore/pause-telemetry.png'; import removeTelemetryData from '@assets/dashboard/explore/remove-telemetry-data.png'; -import removeAllTelemetry from '@assets/dashboard/explore/remove-all-telemetry.png'; + +import manageDataDialog from '@assets/dashboard/explore/manage-data-dialog.png'; +import manageDataExpanded from '@assets/dashboard/explore/manage-data-expanded.png'; +import settingsManageTelemetry from '@assets/dashboard/explore/settings-manage-telemetry.png'; import themeSelection from '@assets/dashboard/explore/theme-selection.png'; import themeSelectionLight from '@assets/dashboard/explore/theme-selection-light.png'; import dashboardHelp from '@assets/dashboard/explore/dashboard-help.png'; @@ -522,17 +525,51 @@ Next to the **Pause** button, the **Remove data** button enables you to clear th A screenshot of the Aspire dashboard Structured logs page, showing how to remove telemetry. -The button is available for control logs, structured logs, traces, and metrics. It works independently for each type of data. +The button is available for console logs, structured logs, traces, and metrics. It works independently for each type of data. + +For more advanced data management, including exporting and importing telemetry, see [Manage data](#manage-data). + +#### Manage data + +The Aspire dashboard provides a **Manage logs and telemetry** dialog that lets you export, import, and remove telemetry data across all resources. To open it, select the **Settings** icon in the top-right corner of the dashboard, then select **Manage** under **Resource logs and telemetry**: + +A screenshot of the Aspire dashboard Settings dialog, showing the Manage button under Resource logs and telemetry. + +The dialog displays a grid of resources and their available data types. Each resource row shows icons summarizing which data types are present: **Resource** details, **Console logs**, **Structured logs**, **Traces**, and **Metrics**. You can expand a resource to see and select individual data types: + +A screenshot of the Aspire dashboard Manage logs and telemetry dialog, showing a resource expanded to display individual data types. + +Use the checkboxes to select resources or individual data types, then choose an action: + +##### Export data + +Select the resources and data types you want to export, then select **Export selected**. The dashboard downloads a `.zip` file containing the selected data organized by type: + +- **Resources**: JSON files with resource details. +- **Console logs**: Text files with console output. +- **Structured logs**: OTLP JSON files with structured log entries. +- **Traces**: OTLP JSON files with distributed trace spans. +- **Metrics**: OTLP JSON files with metric data points. + +The exported `.zip` file is named `aspire-telemetry-export-{timestamp}.zip` and can be shared with team members or imported back into another dashboard session. + +##### Import data + +Select **Import logs and telemetry** to import previously exported data. The dashboard accepts `.zip` files (exported from the dashboard) and individual `.json` files containing OTLP telemetry data. The maximum file size is 100 MB. + +Imported data appears alongside any existing telemetry in the dashboard, enabling you to review data from previous sessions or data shared by other team members. + +##### Remove data -If you want to remove all telemetry of all types and for all resources in a single step, use the **Remove all** button in the **Settings** dialog: +To remove data for specific resources or data types, select the items you want to clear, then select **Remove selected**. This provides more granular control than the per-page **Remove data** button, and enables you to clear multiple data types across multiple resources in a single step. -A screenshot of the Aspire dashboard Settings page, showing how to remove all telemetry. +A screenshot of the Aspire dashboard Manage logs and telemetry dialog, showing resources with available data types and export, remove, and import buttons. ## Settings dialog -The Aspire dashboard provides a settings dialog that allows you to configure the theme, the language, functionality to clear all the logs and telemetry, and the .NET version used by the dashboard. +The Aspire dashboard provides a settings dialog that allows you to configure the theme, the language, manage logs and telemetry data, and view the .NET version used by the dashboard. By default, the theme is set to follow the System theme, which means the dashboard uses the same theme as your operating system. You can also select the **Light** or **Dark** theme to override the system theme. Theme selections are persisted.