Getting Started

Everything you need to get up and running with AppInsightly.

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 Preferences.
  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, 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.

More Features

Time Range Filtering

Choose from 9 preset time ranges (30 minutes to 30 days) or set a custom date range. Filter requests by all or failed only, and switch between aggregate and individual views.

Saved Items

Bookmark query results, HTTP requests, or search results for later reference. The Saved tab organizes your bookmarks into Saved Queries, Saved Requests, and Saved Search. You can save up to 100 items per type, per account.

Export to CSV

Export query results as a CSV file directly from the footer bar. The export includes all columns from your current query results.

Resizable Window

Cycle between three window sizes — compact, wide, and full — using the size button in the footer. Wide and full modes show additional columns in query results and request tables.

Keeping AppInsightly Updated

AppInsightly checks for updates automatically in the background. When a new version is available, you'll be prompted to install it. You can also check manually in Preferences → Updates.

Licensing

AppInsightly includes a free 7-day trial — no account or credit card required. After the trial, purchase a license from the pricing page and enter your license key in Preferences → License. If you're temporarily offline, a grace period keeps the app working.

Need Help?

Have a question or running into an issue? Reach out via our contact form and we'll get back to you.