Getting Started

1. Download & Install

1. Download the latest version from the download page.
2. Open the .dmg file and drag AppInsightly to your Applications folder.
3. Launch AppInsightly from Applications. You may need to right-click and select Open the first time since the app is distributed outside the Mac App Store.
4. AppInsightly will appear as an icon in your menu bar.

2. Connect Your Azure Account

1. Click the AppInsightly icon in the menu bar and select Settings.
2. Click Add Account to start the sign-in flow.
3. Sign in with your Microsoft account and authorize AppInsightly to access your Azure resources.
4. Select your Azure subscription and choose an Application Insights resource or Log Analytics workspace.

You can connect multiple Azure accounts if you work across different subscriptions or tenants.

3. Run KQL Queries

The Queries tab lets you run Kusto Query Language (KQL) queries against your Application Insights resource or Log Analytics workspace. Choose from built-in default queries or select your own saved queries:

• Recent Exceptions: latest errors and stack traces
• Failed Requests: HTTP requests with error status codes
• Slow Requests: requests taking longer than 1 second
• Recent Traces: latest log trace messages

Results are displayed in a sortable, filterable table. Click any row to see full details with all fields, JSON values, and copy buttons.

4. Browse HTTP Requests

The Requests tab gives you two views of your HTTP telemetry:

• Aggregate mode: endpoint summary with request counts, average duration, and failure counts
• Individual mode: per-request list with status codes, timing, and full operation traces

Click any individual request to see its full operation trace: all requests, dependencies, traces, and exceptions in a timeline view.

5. Search Telemetry

The Search tab lets you search across all telemetry types at once: requests, traces, dependencies, and exceptions. Enter a keyword, choose a time range, and filter by type. Toggle between Individual items and View as traces to see results grouped by operation. You can bookmark search results from the Saved tab under Saved Search.

The AI Search tab lets you describe what you're looking for in natural language. AppInsightly translates your description into a KQL query and runs it automatically.

6. AI Trace Explain

When viewing an operation trace, click the Explain button to get a natural language analysis of what happened. The AI identifies failures, slow operations, and the causal chain, and suggests what to investigate next. A first-use confirmation dialog explains that trace data is sent to an external AI provider. You can control exactly what data is shared in Settings → Display → AI Privacy, including field-level toggles and automatic PII redaction.