Skip to content

Update Aspire skill monitoring output guidance#16524

Merged
davidfowl merged 1 commit intomainfrom
docs/aspire-skill-monitoring-formatting
Apr 28, 2026
Merged

Update Aspire skill monitoring output guidance#16524
davidfowl merged 1 commit intomainfrom
docs/aspire-skill-monitoring-formatting

Conversation

@JamesNK
Copy link
Copy Markdown
Member

@JamesNK JamesNK commented Apr 28, 2026

Description

Designed to be used with improved JSON output in #16523

Updates Aspire agent skill guidance for monitoring output formatting.

No code behavior changes.

Fixes # (issue)

Checklist

  • Is this feature complete?
    • Yes. Ready to ship.
    • No. Follow-up changes expected.
  • Are you including unit tests for the changes and scenario tests if relevant?
    • Yes
    • No
  • Did you add public API?
    • Yes
      • If yes, did you have an API Review for it?
        • Yes
        • No
      • Did you add <remarks /> and <code /> elements on your triple slash comments?
        • Yes
        • No
    • No
  • Does the change make any security assumptions or guarantees?
    • Yes
      • If yes, have you done a threat model and had a security review?
        • Yes
        • No
    • No
  • Does the change require an update in our Aspire docs?

Copilot AI review requested due to automatic review settings April 28, 2026 14:03
@github-actions
Copy link
Copy Markdown
Contributor

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/microsoft/aspire/main/eng/scripts/get-aspire-cli-pr.sh | bash -s -- 16524

Or

  • Run remotely in PowerShell:
iex "& { $(irm https://raw.githubusercontent.com/microsoft/aspire/main/eng/scripts/get-aspire-cli-pr.ps1) } 16524"

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the Aspire agent skill documentation to centralize monitoring/telemetry output formatting guidance and to standardize how the agent should present diagnostics gathered via aspire describe, aspire otel *, and aspire export.

Changes:

  • Updates the Aspire skill default workflow to reference references/monitoring.md for display/formatting rules.
  • Updates monitoring guidance to include --format Json telemetry examples and adds conventions for optional resource filtering and consistent status presentation.
  • Adds guidance for using dashboard links (when available) and linking resource/trace/span identifiers.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
.agents/skills/aspire/SKILL.md Points the default workflow at references/monitoring.md for output formatting rules.
.agents/skills/aspire/references/monitoring.md Expands monitoring guidance with JSON-format telemetry examples and new display/linking conventions.

Comment thread .agents/skills/aspire/references/monitoring.md
Copy link
Copy Markdown
Contributor

@davidfowl davidfowl left a comment

Choose a reason for hiding this comment

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

The uppercase Json kills me

@davidfowl davidfowl merged commit 387faf1 into main Apr 28, 2026
8 checks passed
@github-actions github-actions Bot added this to the 13.3 milestone Apr 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants