Troubleshooting setup
When the wizard or the verify step has not yet seen your first event, it names the cause and the next step – never a generic error.
Run the check again and it prints the cause it found:
npx xovris@latest verifypnpm dlx xovris@latest verifyyarn dlx xovris@latest verifybunx xovris@latest verifyThese are the problems it recognises.
The ingestion key was refused
Section titled “The ingestion key was refused”The key is wrong, or it was switched off. Setting up again replaces the key in your env file.
Run the setup again:
npx xovris@latest initpnpm dlx xovris@latest inityarn dlx xovris@latest initbunx xovris@latest initEvents are blocked before they leave your machine
Section titled “Events are blocked before they leave your machine”The ingest address did not resolve, the connection was refused or timed out, or the secure connection failed. Allow outbound HTTPS to the ingest address in your firewall or proxy.
Then check again:
npx xovris@latest verifypnpm dlx xovris@latest verifyyarn dlx xovris@latest verifybunx xovris@latest verifyA browser extension blocked browser events
Section titled “A browser extension blocked browser events”An ad blocker stopped the request to the ingest address. Server events still arrive; browser events need to be sent through your own domain.
Your framework version is outside the supported range
Section titled “Your framework version is outside the supported range”The wizard stops before changing anything and names the range its changes are written for. Upgrade the framework to a version in that range and run it again. Each stack’s range is on its own page under Connect your app.
Your Node.js version is older than the SDK needs
Section titled “Your Node.js version is older than the SDK needs”The diagnosis names the supported range. Upgrade Node.js to a version in that range and run the wizard again.
Stack traces stay minified
Section titled “Stack traces stay minified”Your production build ran without the source-map upload token. Run the wizard again in the project to add the build token to your platform.
Your data is never used to train our AI. How your data is kept
A problem is called fixed only once it works again. How each fix is checked
XOVRIS LTD, registered in England and Wales, company number 17499910. Registered office: 66 Paul Street, London EC2A 4NA.