1. Generate a project key
Open Project Settings → API Key and generate a key if needed.2. Choose a framework
Go to Project Settings → App Logs and select Next.js, React, Node.js, Edge Function, or Python. Follow the displayed install command, environment variable, initialization snippet, and file location for that runtime. Initialize the SDK in the real application entry point. You can optionally identify authenticated users withsetUser.
3. Add wrappers and source maps
Apply the route wrappers shown for Next.js route handlers or Deno edge handlers when relevant. For build-based JavaScript apps, enable and upload source maps so stack traces resolve to original source files. The Source Maps section lists every uploaded release with its map count, total size, and latest upload date. Delete a release there to remove all of its uploaded maps.4. Use Add to App when needed
Add to App opens an Aiola thread with instructions for the selected framework and asks the agent to inspect the actual codebase before editing.5. Verify capture and workflows
Trigger a test error, then confirm it appears in Project → App Logs and Central → App Logs. On the project page, verify:- time-period and issue-status filters
- environment, browser, operating-system, device, country, and HTTP-status filters
- Analyze and Fix It for an active issue
- individual and bulk status changes
- copy and delete actions
- bulk deletion