aspire export command

Bu içerik henüz dilinizde mevcut değil.

Name

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

Synopsis

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. Hidden resources are excluded from the export by default; use the --include-hidden option to include their data.

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

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

Scans for all running AppHost processes.
If multiple AppHosts are running within the current directory scope, prompts you to select which one to target.
If only one AppHost is running in scope, connects to it directly.
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.
--include-hidden

Includes resources that are marked as hidden. By default, hidden resources are not shown. When a specific resource name is provided, hidden resources are always included regardless of this option.
-?, -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.

Zip file contents

The exported zip archive (default name aspire-export-<timestamp>.zip) can contain up to four directories, depending on available data:

resources/ — One JSON file per resource containing resource details such as name, type, state, endpoints, and environment variables.
consolelogs/ — One plain-text *.txt file per resource with raw console output lines.
structuredlogs/ — One JSON file per resource with structured log entries serialized in OTLP format.
traces/ — One JSON file per resource with distributed traces and spans serialized in OTLP format.

When a resource name is provided, only data for that resource is included in the archive. When no resource is specified, data for all visible resources is exported.

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 export --output '.\\artifacts\\aspire-export.zip'

Export data from a specific AppHost project:

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

Export diagnostics including hidden resources:
Aspire CLI
```
aspire export --include-hidden
```