Skip to content

[docs] Add --search option documentation to CLI command reference pages - #1107

Closed
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/cli-search-option-17544-832170ee10669da2
Closed

[docs] Add --search option documentation to CLI command reference pages#1107
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/cli-search-option-17544-832170ee10669da2

Conversation

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#17544 by @JamesNK.

Targeting release/13.4 — the latest release branch on microsoft/aspire.dev — because release/13.5 (from the source PR milestone 13.5) does not exist there.

Why this PR is needed

PR microsoft/aspire#17544 updated the --search option description for the aspire logs and aspire otel commands to clarify that it supports full-text search and field filters, and added a link to (aka.ms/redacted) However, none of the CLI command reference pages currently document the --search` option at all, leaving users without any reference for this filtering capability.

What was changed

The --search option was added to four CLI command reference pages:

  • aspire-logs.mdx — added --search option with description matching the updated LogsCommandStrings.resx: full-text search to filter log content, with link to aka.ms/aspire/cli-search.
  • aspire-otel-logs.mdx — added --search option with description matching TelemetryCommandStrings.resx: search and filter telemetry fields including log messages, attribute values, names, source, and IDs; supports full-text search and field filters; link to aka.ms/aspire/cli-search.
  • aspire-otel-spans.mdx — added --search option with equivalent telemetry search description.
  • aspire-otel-traces.mdx — added --search option with equivalent telemetry search description.

Files modified

  • src/frontend/src/content/docs/reference/cli/commands/aspire-logs.mdx
  • src/frontend/src/content/docs/reference/cli/commands/aspire-otel-logs.mdx
  • src/frontend/src/content/docs/reference/cli/commands/aspire-otel-spans.mdx
  • src/frontend/src/content/docs/reference/cli/commands/aspire-otel-traces.mdx

Generated by PR Documentation Check for issue #17544 · ● 12.2M ·

Documents the --search option for aspire logs, aspire otel logs,
aspire otel spans, and aspire otel traces commands, including the
updated description mentioning full-text search, field filters, and
the https://aka.ms/aspire/cli-search reference link.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds missing documentation for the --search option across Aspire CLI command reference pages, aligning the docs with the CLI behavior introduced in microsoft/aspire#17544.

Changes:

  • Documented --search <query> for aspire logs.
  • Documented --search <query> for aspire otel logs, aspire otel spans, and aspire otel traces, including the shared syntax link to https://aka.ms/aspire/cli-search.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
src/frontend/src/content/docs/reference/cli/commands/aspire-logs.mdx Adds --search option documentation for log content filtering.
src/frontend/src/content/docs/reference/cli/commands/aspire-otel-logs.mdx Adds --search option documentation for telemetry log searching/filtering.
src/frontend/src/content/docs/reference/cli/commands/aspire-otel-spans.mdx Adds --search option documentation for span searching/filtering.
src/frontend/src/content/docs/reference/cli/commands/aspire-otel-traces.mdx Adds --search option documentation for trace searching/filtering.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-from-code Copilot initiated issue from dotnet/aspire repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants