Project onboarding

New projects without events show a setup wizard so you can move from an empty project to verified ingestion. The wizard gives stack-specific install commands, project credentials, and a live verification step.

When the wizard appears

The wizard appears for new projects that have not received events. Older empty projects may show a simpler empty state with a link back to setup.

Choose your stack

The stacks you picked at project creation carry into the wizard — one tab per stack on the install, configure, and verify steps. Use Change stacks to add or remove stacks, and if you skipped the picker at creation, the wizard asks you to pick at least one before continuing. For older projects with language and framework metadata, Errorgap preselects the closest stack.

Configure the SDK

Copy the install and configuration snippets from the wizard. Keep the project API key in an environment variable or secret manager, and verify the endpoint matches the Errorgap instance your project uses.

Send a test event

Use the test snippet to send one intentional event from a safe environment. Errorgap listens while you work and checks each stack off as its SDK reports; the wizard advances once every selected stack has sent an event. You can skip ahead at any point.

Finish setup

After the first event arrives, open the project, review the generated error group, and choose next steps such as agent access, redaction, notifications, logs, or APM.

A complete first-run setup usually includes project settings, integration routing, redaction, agent access, and session replay decisions before the project handles production incidents.

If verification times out

• Confirm the project API key and endpoint are correct.
• Check that the application can reach Errorgap over the network.
• Review SDK logs or the test command response for authentication errors.
• Skip verification only when you intentionally need to finish setup later.