Reference

Troubleshooting

Quick checks when connections, webhooks, or alerts misbehave.

Steps

1. BigQuery connection fails
Confirm project ID, service account roles, and that the key is not expired. Retry from /start.
2. No freshness updates
Ensure tables are listed as watched and the freshness worker/cron is running (GET /api/freshness).
3. dbt webhook ignored
Check shared secret, HTTPS URL, and that the payload includes run results. Try a manual artifact upload.
4. Alert not received
Verify destination address/channel, spam folders, and POST /api/alerts/test.
5. Still stuck
Email hello@vectornosis.com with workspace ID and a timestamp.