aspire export command

Name

aspire export - Export telemetry and resource data to a zip file.

Synopsis

Aspire CLI

aspire export [<resource>] [options]

Description

The aspire export command packages telemetry and resource data from a running AppHost into a zip file. Use it when you need to collect diagnostics for troubleshooting, share runtime state with a teammate, or preserve data from a running app for later analysis.

When a resource name is provided, the export is limited to data for that resource.

When executed without the --apphost option, the command:

1. Scans for all running AppHost processes.
2. If multiple AppHosts are running within the current directory scope, prompts you to select which one to target.
3. If only one AppHost is running in scope, connects to it directly.
4. If no in-scope AppHosts are found but out-of-scope AppHosts exist, displays all running AppHosts for selection.

Arguments

• <resource>

  Export data only for the specified resource.

Options

The following options are available:

• --apphost <apphost>

  The path to the Aspire AppHost project file.

• -o, --output <output>

  The output file path for the export zip file.

• -?, -h, --help

  Prints help and usage documentation for the available commands and options.

• -l, --log-level <Critical|Debug|Error|Information|None|Trace|Warning>

  Set the minimum log level for console output. Use this option to increase diagnostics while troubleshooting or reduce output in scripted runs.

• --non-interactive

  Run the command in non-interactive mode, disabling all interactive prompts and spinners.

• --nologo

  Suppress the startup banner and telemetry notice.

• --banner

  Display the animated Aspire CLI welcome banner.

• --wait-for-debugger

  Wait for a debugger to attach before running a command.

Examples

• Export diagnostics for the current AppHost:

  Aspire CLI

  aspire export

• Export data for a specific resource:

  Aspire CLI

  aspire export webfrontend

• Write the export to a specific file:

  Aspire CLI

  aspire export --output '.\\artifacts\\aspire-export.zip'

• Export data from a specific AppHost project:

  Aspire CLI

  aspire export --apphost './src/MyApp.AppHost/MyApp.AppHost.csproj'

See also

• aspire describe
• aspire logs
• aspire otel