Skip to content
QortexOS Documentation
Connect your data

Monitor connector health

Read the Connector Health screen, understand each status value, and act on a connector from its row.

Connector Health is the screen you watch after a connector exists. It sits under Data Platform in the Connectors group, and its subtitle reads "Live status of your data connectors, with sync controls and recent activity."

The four cards at the top

Across the top are Average uptime, Average success rate, Total syncs, and Failed syncs, with a caption reading "Health statistics as of date". These are a snapshot for that date rather than a live reading.

Before your first syncs have been processed, the cards read Awaiting analytics data, with the line "Health statistics appear after the analytics pipeline processes your first connector syncs." The connector table below fills in first; these cards follow.

If the cards fail to load, they show "Could not load health statistics" with a Retry button.

The connector table

One row per connector, with these columns: Connector, Provider, Type, Health, Status, Uptime, Errors, Last successful sync, Next sync, and Sync.

Three of them carry most of the day-to-day signal:

  • Last successful sync is the time of the last successful run the platform has recorded. It reads Never when there is none.
  • Next sync shows a time when a run is queued. It reads Not scheduled when there is nothing queued, which includes a paused connector and one that has not yet had a successful run.
  • Status is the connection's current state, described below.

The Sync column carries a badge that is either Active or Paused. That badge is the on or off switch for the connector, and it is separate from Health and from Status: a paused connector can still show a healthy last run.

Three dropdowns narrow the table: Filter by health, Filter by provider, and Filter by type, each with an all option, plus Clear filters. Filters are held in the page address, so a filtered view can be bookmarked or shared. The table is sorted by health and pages at 10, 25, 50, or 100 Rows per page.

With no connectors at all, the table reads No connectors configured, with "Set up your first connector to begin monitoring."

What each status value means

The Status column can show these values:

StatusWhat it means
ConnectedThe connector is linked to the system and ready to run.
SyncingA sync run is in progress.
AuthenticatingThe connector is checking its credentials.
ConfiguredThe connector has been set up; no run has been recorded yet.
DisconnectedThe connector is not currently linked to the system.
ErrorThe connector's last attempt ran into an error.
MaintenanceThe connector is under planned maintenance.

Recent sync activity

A panel beside the table, headed Recent sync activity, lists the most recent sync runs newest first. Each entry shows a status badge, the time the run started, the connector name, a record count, and a duration in seconds when one was recorded. On a narrow screen, open it with Open sync activity.

Before anything has run it reads No sync activity yet, with "Sync runs appear here as your connectors execute."

Acting on a connector

Each row carries Force sync directly, and a More actions menu with the rest. All four need sync-management access; without it, only View details is offered.

  • Force sync starts a run now. Confirmation: "Sync started for connector name." Failure: "Could not start a sync for connector name."
  • Test connection checks the connection without pulling data. Confirmation: "Connection test passed for connector name (time ms)." Failure: "Connection test failed for connector name."
  • Pause sync and Resume sync turn the connector off and on. The label shows whichever applies. Confirmations: "Sync paused for connector name." and "Sync resumed for connector name."
  • View details opens a read-only Connector details panel with Configuration, Health, and Timing sections. Selecting the row opens the same panel. Anything the platform has not recorded reads Not available.

Every message can be cleared with Dismiss.

Connector Health loads its values when you open the screen, and refreshes the row and the activity panel after a sync or a pause and resume; Test connection only reports its result. The screen does not update on its own while you watch, so reload it to see later changes.