aspire export command

Name

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

Synopsis

aspire export [] [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. 1

    Scans for all running AppHost processes.

  2. 2

    If multiple AppHosts are running within the current directory scope, prompts you to select which one to target.

  3. 3

    If only one AppHost is running in scope, connects to it directly.

  4. 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:

    • -o, --output <output>

    The output file path for the export zip file.

            • Examples

  • Export diagnostics for the current AppHost:

    aspire export
    
  • Export data for a specific resource:

    aspire export webfrontend
    
  • Write the export to a specific file:

    aspire export --output '.\\artifacts\\aspire-export.zip'
    
  • Export data from a specific AppHost project:

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

See also