Troubleshoot a source
At a glance
Identify and fix connection, mapping, or ingestion issues with your Live Data sources. This page guides you step by step to isolate the cause of an error and resolve it.
Before you start
- At least one connector configured (see Add a connector)
Steps
1. Spot sources in error
From the connector list in Live Data, look for sources flagged with a red indicator. These sources are experiencing a connection or ingestion problem.
2. Open the connector details
Click the affected connector to open its detail page. You will find the connection attempt history and associated error messages.
3. Test the connection manually
Click Test to retry a connection and isolate the problem. The result is displayed immediately.
4. Identify the cause
Check the displayed error message and refer to the common errors table below to find the appropriate fix.
5. Apply the fix
Modify the connector configuration according to the identified solution, then re-run the test to confirm the problem is resolved.
6. Verify data reception
Once the connection is restored, verify that data is arriving correctly in the target entity of your ontology.
Common errors
| Error | Cause | Solution |
|---|---|---|
| Connection refused | URL unreachable or firewall | Verify the URL is correct and accessible from the network. |
| 401 Unauthorized | Invalid credentials | Update the authentication headers of the connector. |
| Timeout | Source too slow to respond | Increase the timeout in the configuration or reduce the request size. |
| Invalid signature (Webhook) | Incorrect HMAC secret | Verify the secret is identical in Ontologie and in your external system. |
| No data received | Incorrect mapping or inactive source | Check the connector configuration and the external source state. |
| 429 Too Many Requests | Too many requests sent | Increase the polling interval for REST sources. |
Expected outcome
The connector is working again and data is being correctly ingested into your workspace. The status indicator turns green.
Need help?
See the Monitoring page to track your sync health, the Add a connector page to review the configuration, the Webhooks page for webhook-specific issues, or write to us: Support and contact.