Files
mcp-microsoft/tools
adb9de1074 Add monitor traces commands for Azure Monitor toolset (#3922)
* Add `monitor traces` commands for Azure Monitor Trace Store

Adds four commands for querying distributed traces stored in an Azure
Monitor Workspace: listing trace-enabled workspaces, listing queryable
trace/span fields, running a KQL trace query, and cancelling a running
query.

Trace query uses a hand-built data-plane pipeline rather than a generated
SDK because no Azure SDK client exists for the Trace Store data plane; the
service validates the workspace host suffix and parses the AMW ARM ID
before issuing requests.

These commands are intended for private preview only. Registration is
unconditional, so exclusion from a GA release is a release-branch
coordination decision and is not enforced in code.

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

* Fix Monitor traces review findings

Carry Resource Graph truncation through trace account responses instead of reporting incomplete discovery as complete. Align required account prompts and query option guidance, and split wire models into one-class files.

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

* Align Monitor traces targeting and validation

Resolve workspaces by subscription, resource group, and name; validate query options and endpoints before execution. Separate query submission from resumption and pin refreshed recordings for the new lookup sequence and compatible workspace preview API.

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

* Separate Monitor trace query resume tool

Expose operation-id polling through query resume with its own paging options, leaving query run submission-only. Reuse the existing polling service and pin the recorded resume coverage.

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

* Drain trace query pages within bounded budgets

Preserve consumed rows and metadata across continuation, timeouts, and failures. Deserialize a typed page envelope and use the endpoint top parameter so requested page sizes are honored.

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

* Fix consolidated metadata for trace query resume

Expose resume under its own non-idempotent consolidated tool so advancing result reads retain correct retry hints and consolidated startup passes metadata validation.

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

* Address follow-up Traces review comments

Remove the tool-specific consolidated assertion while keeping generic metadata coverage. Clarify public-cloud support and existing bounded pagination in the command documentation.

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

---------

Co-authored-by: Grace Wehner <grwehner@microsoft.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
2026-10-19 10:53:54 -04:00
..