Database health checks help confirm that Tractorscope can connect to your database and query metadata needed for charts.
What health checks verify
Health checks can reveal issues with:
- Host or port
- Username or password
- Database name
- Credential files or tokens
- SSL settings
- SSH tunnel settings
- Firewall allowlists
- Fixed outgoing IP configuration
- Database availability
- Permissions to read schema or run queries
Common connection problems
If a database is unhealthy, confirm:
- The database server is reachable from Tractorscope.
- Credentials are correct.
- The database user has permission to connect and query.
- SSL mode matches the database server configuration.
- SSH host, user, port, and public key are configured correctly.
- Firewall rules allow Tractorscope traffic.
Query troubleshooting
If a chart query fails:
- Run the query directly in the chart editor.
- Check database-specific SQL syntax.
- Verify filter values and filter placeholders.
- Confirm column and table names exist.
- Check whether the query needs quoting for reserved words.