aspire logs command

Name

aspire logs - Display logs from resources in a running apphost.

Synopsis

Aspire CLI

aspire logs [<resource>] [options]

Description

The aspire logs command displays console logs from resources in a running AppHost. You can view logs for all resources, filter to a specific resource, follow new log entries in real time, and choose table or JSON output for automation.

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>

  The name of the resource to get logs for. If not specified, logs from all resources are shown.

Options

The following options are available:

• --apphost <apphost>

  The path to the Aspire AppHost project file.

• -f, --follow

  Stream logs in real time as they are written.

• --format <Json|Table>

  Output format. Use Json for machine-readable output suitable for scripting and automation. Defaults to Table.

• -n, --tail <tail>

  Number of lines to show from the end of the logs.

• -t, --timestamps

  Show timestamps for each log line.

• -?, -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

• Show logs for all resources:

  Aspire CLI

  aspire logs

• Show logs for a specific resource:

  Aspire CLI

  aspire logs webfrontend

• Follow logs in real time:

  Aspire CLI

  aspire logs --follow

• Show the last 100 log lines with timestamps:

  Aspire CLI

  aspire logs apiservice --tail 100 --timestamps

• Output logs as JSON:

  Aspire CLI

  aspire logs --format Json

See also

• aspire describe
• aspire export
• aspire otel