Monitor Connector Health

Connector Health is the screen you watch after a connector exists. It sits under Data Platform in the Connectors group, and its subtitle reads "Per-connector health, sync operations, and the event log."

The four cards at the top

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

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, Health, Status, Uptime, Errors, Last sync, Next sync, Enabled, and Actions. The provider and its category are not columns; they narrow the table through the filters and show on the details panel.

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

• Last sync is the time of the last run the platform has recorded. It reads Never when there is none. The details panel also shows Last successful sync separately.
• 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 Enabled column reads Yes or No. It 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. Failing connectors sort first, and the table 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:

For a QuickBooks Desktop connector, Configured means the QuickBooks Web Connector has not completed its first run yet. Connected appears on its own after that run. See QuickBooks Desktop.

Event log

A panel beside the table, headed Event log, 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 ("number records"), and a duration in seconds ("number s") 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." If it cannot load, it reads "Could not load sync activity".

Acting on a connector

Each row carries Force sync directly, and a More actions menu with the rest: Test, Pause sync or Resume sync (whichever applies), View details, and Delete. Every action asks you to confirm before it runs; the screen says so beside the table: "Row actions ask for confirmation before running; selecting a row opens the connector's detail panel. Failing connectors sort first." The sync actions, Force sync, Test, Pause sync, and Resume sync, need sync-management access; without it they are not offered. Delete needs a separate deletion permission that an administrator grants on its own; without it the action is not offered.

• Force sync asks "Start a sync now?" and explains "Runs a live data pull from the provider for connector name right away. The connector's own schedule is not affected." The dialog offers an optional Full re-pull (ignore the incremental watermark) switch and Limit to specific data types checkboxes, with the note "Leave everything unchecked to pull every enabled data type." Select Start sync. Confirmation: "Sync finished for connector name." Failure: "Could not start a sync for connector name."
• Test asks "Test this connection?" and explains "Sends a live credential check to the provider for connector name." Select Run test. Results: "Connection test passed for connector name (time ms)." or "Connection test failed for connector name." If the test could not run at all: "Could not run the connection test for connector name."
• Pause sync asks "Pause syncing?" with "connector name stops syncing until it is resumed. No data is removed." Resume sync asks "Resume syncing?" with "connector name returns to its normal sync schedule."
• View details opens the Connector details panel described below. Selecting the row opens the same panel.
• Delete asks "Delete this connector?" and explains "This removes connector name and stops its syncs. The stored connection credential is scheduled for deletion with a recovery window." Select Delete connector. Results: "connector name deleted." or "connector name could not be deleted."

Every message can be cleared with Dismiss.

The details panel

Connector details has four sections. Anything the platform has not recorded reads Not available.

• Configuration: Provider, Type, Sync frequency, Business criticality, Data classification, and Sync.
• Health: Health, Status, Uptime, Performance score, Connection reliability, Average sync duration (in minutes), Errors, and Last error.
• Timing: Last sync, Last successful sync, Next sync, Created, and Updated.
• Connection actions, described next.

Connection actions

Which actions appear depends on how the connector provides access, and they need the same sync-management access as the row's sync actions:

• Reconnect provider, for connectors you approved at the provider: "Approve access again at the provider; the connection keeps its history and settings."
• Replace credentials, for connectors with credentials entered in QortexOS: "Enter new credential values; they are verified with a live connection test before anything is saved." Success reads "Credentials replaced and verified."
• For QuickBooks Desktop: Download .qwc file ("Download the Web Connector configuration file again. It contains no password and can be re-imported safely.") and Rotate password ("Rotate the Web Connector password. The current password stops working immediately; enter the new one in the Web Connector on the QuickBooks computer."). The new password appears under New Web Connector password with the warning "This password is shown only once. Copy it now and enter it in the Web Connector." Select Done, hide it when you have copied it.

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

Related

• Manage sync settings
• Statuses and freshness