Status FAQ

Answers to common questions about the Platform Status page, health indicators, and dataplane operations.

General

What is the Platform Status page?

The Platform Status page is a real-time dashboard that displays the health and configuration of your Qualytics deployment. It shows the status of the database, RabbitMQ message broker, and the dataplane (analytics engine), along with deployment details like version, cloud provider, and resource allocation. See the Platform Status page for a full breakdown.

Who can access the Platform Status page?

Users with the Manager or Admin role can view the Platform Status page. Members and Viewers are redirected away. Dataplane restart requires the Admin role. See the Permissions page for the full matrix.

Note

The UI requires the Manager role to access the Status page, but the underlying API endpoints (GET /api and GET /api/status) only require the Member role. This means automated scripts using API tokens with Member-level access can still retrieve status data programmatically, even though the same user cannot access the page through the UI.

What do the status indicators mean?

A green indicator with OK means the service is healthy and connected. A red indicator with UNHEALTHY means the service is unreachable or not responding.

How often does the status data refresh?

The status data is fetched once when the page loads. To get the latest data, use the Refresh Status Summary action from the actions menu.

What happens if the refresh fails?

If the refresh fails (e.g., due to a network issue or backend timeout), the page may display stale data or loading indicators that do not resolve. Try refreshing the browser page or use the Refresh Status Summary action again. If the issue persists, check that the platform backend is accessible.

Database & RabbitMQ

What happens when the database is unhealthy?

The platform cannot persist or retrieve any data. This affects all functionality including user authentication, datastore management, and operation history.

Tip

For SaaS deployments, the database is managed by Qualytics — contact the Qualytics support team. For self-hosted deployments, the database is managed by your infrastructure team — verify that the database service is running and accessible.

What happens when RabbitMQ is unhealthy?

All communication between the controlplane and the dataplane is interrupted. This means operation-related features (Sync, Profile, Scan, External Scan, Export, Materialize) will be unavailable. The dataplane health check also cannot be performed, so the Dataplane section will show UNHEALTHY as well.

Can the database be healthy but RabbitMQ unhealthy?

Yes. The database and RabbitMQ are independent services. The database handles data persistence while RabbitMQ handles message routing between the controlplane and dataplane. One can be healthy while the other is not.

Dataplane

What is the dataplane?

The dataplane is the analytics engine that executes all data quality operations (Sync, Profile, Scan, External Scan, Export, Materialize). Depending on your deployment, it runs on Kubernetes, Databricks, or a local host. It communicates with the controlplane through RabbitMQ.

What does it mean when the dataplane is UNHEALTHY?

It means the dataplane is not responding to health check requests. This can happen during a restart, a deployment update, or if the engine has crashed. All configuration fields display -- and a Refresh button appears to retry the health check.

How long does a dataplane restart take?

The dataplane typically restarts within 20–30 seconds. During this time, the status shows as UNHEALTHY and all fields display --. Use the Refresh Status Summary action after waiting to verify the dataplane is back.

What operations are affected during a restart?

Connection tests, schema discovery, dry runs, source record views, and computed asset validation fail immediately. Running Sync, Profile, Scan, External Scan, Export, and Materialize operations are interrupted but automatically recover once the dataplane restarts. Flows, user management, teams, tags, scheduling, and integrations are unaffected. See Restart Dataplane for details.

What happens to scheduled operations during a restart?

Scheduling configuration remains available during a restart — no scheduled operations are lost. If a scheduled operation triggers while the dataplane is restarting, the operation request is queued in RabbitMQ and will be picked up automatically once the dataplane is back online.

What is the Thread Pool State?

The Thread Pool State is a real-time snapshot of the dataplane's workload, showing the number of running operations, queued requests, and provisioned communication channels. See Understanding Thread Pool State for examples and interpretation.

What does a high number of queued requests mean?

It means all available executor slots are occupied and new operations are waiting in the queue. If this is consistently high, your deployment may need more executors. Contact the Qualytics support team to discuss scaling options.

Private Routes

What are private routes?

Private routes are connections to datastores configured with private network addresses (e.g., internal hostnames or private IPs). The Platform Status page verifies that the dataplane can reach each private host and reports the connectivity status. See Private Routes for details.

Why don't I see the Private Routes section?

The Private Routes section only appears when your deployment has datastores configured with private network addresses. If all your datastores use public endpoints, this section is not displayed.

A private route shows as failed — what should I do?

Verify that the target database is running, the port is correct, and that network rules (security groups, firewalls, VPC peering) allow traffic from the dataplane to the target host. See Common Failure Reasons for specific error messages and their causes.

Tip

For SaaS deployments, network configuration is managed by Qualytics — contact the Qualytics support team. For self-hosted deployments, network rules are managed by your infrastructure team.

API

Can I check the platform status via API?

Yes. Use GET /api/status to retrieve the health of all backend services programmatically. This endpoint requires the Member user role. See the Status API page for all available endpoints and examples.

Can I restart the dataplane via API?

Yes. Use PUT /api/admin/restart to trigger a graceful dataplane restart. This endpoint requires the Admin user role. See the Status API page for details.