diff --git a/Agents/Implementation Agents/Trace Parser/Installer/README.md b/Agents/Implementation Agents/Trace Parser/Installer/README.md new file mode 100644 index 00000000..0a5e59ac --- /dev/null +++ b/Agents/Implementation Agents/Trace Parser/Installer/README.md @@ -0,0 +1,64 @@ +# Trace Parser Desktop App + +> Official Microsoft desktop application for capturing and viewing D365 Finance & Operations performance trace files (`.etl`). + +## What This Is + +The **Trace Parser** is Microsoft's native desktop tool for: + +- Recording ETW performance traces in D365 F&O environments +- Browsing trace events in a tree / call-stack viewer +- Exporting trace data to a SQL Server `AxTrace` database — the same schema the AI agent components in this folder read from + +It is the **upstream data source** for the rest of this repository — the AI agent analyzes traces that have been captured and imported via this tool. + +## File + +| Field | Value | +|---|---| +| File | `TraceParser.zip` (contains `TraceParser.msi`) | +| Product | Microsoft Dynamics 365 Unified Operations - Trace Parser | +| Version | 7.0.7690.33 | +| Publisher | Microsoft Corporation (digitally signed) | +| Install scope | Machine-wide (`ALLUSERS=1`) | +| Size | 4.13 MB (zip) · 4.65 MB (extracted MSI) | + +## Installation + +1. Download `TraceParser.zip` from this folder. +2. Extract the archive — you'll get `TraceParser.msi`. +3. Right-click `TraceParser.msi` → **Install** (or double-click). +4. Accept the UAC prompt — the installer requires administrator privileges (machine-wide install). +5. Follow the installer wizard to complete the setup. + +After installation, launch **Microsoft Dynamics 365 Unified Operations - Trace Parser** from the Start menu. + +## Verifying Authenticity + +Before installing, you can verify the MSI's Microsoft digital signature: + +```powershell +Get-AuthenticodeSignature -FilePath TraceParser.msi +``` + +Expected output: + +- **Status:** `Valid` +- **Signer:** `CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US` +- **Issuer:** `CN=Microsoft Code Signing PCA 2011, O=Microsoft Corporation, …` + +## Usage with the AI Agent + +This desktop tool produces the `.etl` trace files and the `AxTrace` SQL database schema that the rest of this repository uses: + +1. **Capture** an ETW trace using the desktop Trace Parser while reproducing a performance issue in D365 F&O. +2. **Import** the trace into your `AxTrace` SQL database — either via the desktop tool's own import dialog, or via the [`TraceParserMCP`](../TraceParserMCP/) PowerShell script (`DAB_ParseEtl.ps1`), or via the [`TraceParserWeb`](../TraceParserWeb/) Blazor upload UI. +3. **Analyze** the imported trace conversationally using the [Copilot Studio agent](../Solutions/). + +## Source + +This installer is included for FastTrack customer discoverability — the same MSI Microsoft provides through official internal channels. It is bundled here so customers can pick up the Trace Parser desktop tool alongside the AI agent components in this repository. + +## Disclaimer + +The Trace Parser desktop tool is a Microsoft product distributed under its own End User License Agreement, displayed during MSI installation. The remaining components in the parent folder (Copilot Studio agent, MCP server, web upload UI) are **sample / reference code** as described in the [parent README](../README.md). diff --git a/Agents/Implementation Agents/Trace Parser/Installer/TraceParser.zip b/Agents/Implementation Agents/Trace Parser/Installer/TraceParser.zip new file mode 100644 index 00000000..428d626e Binary files /dev/null and b/Agents/Implementation Agents/Trace Parser/Installer/TraceParser.zip differ diff --git a/Agents/Implementation Agents/Trace Parser/README.md b/Agents/Implementation Agents/Trace Parser/README.md index 0e79e432..b20c7cdb 100644 --- a/Agents/Implementation Agents/Trace Parser/README.md +++ b/Agents/Implementation Agents/Trace Parser/README.md @@ -18,10 +18,11 @@ By using conversational AI, you can reduce performance troubleshooting in D365 F ## Components -This agent consists of three components: +This agent consists of four components: | Component | Description | Folder | |-----------|-------------|--------| +| **Trace Parser Desktop App** | Official Microsoft Trace Parser MSI installer (v7.0.7690.33) — captures D365 F&O ETW traces and produces the `AxTrace` SQL database the agent reads from | [`Installer/`](Installer/) | | **Copilot Studio Agent** | The AI agent solution — import into Copilot Studio | [`Solutions/`](Solutions/) | | **TraceParserMCP** | Data API Builder MCP server exposing trace data via REST, GraphQL, and MCP protocol | [`TraceParserMCP/`](TraceParserMCP/) | | **TraceParserWeb** | Blazor Server web app + Azure Function for ETL trace upload and import | [`TraceParserWeb/`](TraceParserWeb/) | @@ -46,7 +47,11 @@ The agent uses a **dual Model Context Protocol (MCP)** architecture: ## Quick Start -### 1. Set up the MCP Server +### 1. Install the Trace Parser desktop tool + +Download and install the Trace Parser MSI from [`Installer/`](Installer/) — this is the source of trace data the AI agent analyzes. The MSI is Microsoft-signed; verification instructions are in [`Installer/README.md`](Installer/README.md). + +### 2. Set up the MCP Server See [`TraceParserMCP/README.md`](TraceParserMCP/README.md) for full instructions. @@ -61,11 +66,11 @@ dotnet tool restore dab start ``` -### 2. Import the Copilot Studio Agent +### 3. Import the Copilot Studio Agent See [`Solutions/readme.md`](Solutions/readme.md) for import instructions. -### 3. (Optional) Deploy TraceParserWeb +### 4. (Optional) Deploy TraceParserWeb See [`TraceParserWeb/README.md`](TraceParserWeb/README.md) for the web-based ETL upload interface.