Monitor Integration Health and Diagnose Sync Errors
Integration failures can have downstream consequences — peer mentors not receiving reimbursements, Bufdir report data being incomplete, or payroll runs missing expense data. The integration health monitor provides a dashboard view of all configured integrations with traffic-light status indicators, recent sync history, failure counts, and drill-down error details. Admins should be able to view the specific records that failed, understand the error reason, and manually retry failed records.
User Story
Acceptance Criteria
- Given I open the Integration Configuration Dashboard, When integrations are displayed, Then each shows a status indicator: green (last sync successful), yellow (last sync had warnings), red (last sync failed or no sync in 48h)
- Given an integration is in error state, When I click on it, Then I see the error message returned by the external system, the timestamp of failure, and a list of records that failed to export
- Given I view a failed record, When I expand the error detail, Then I see the specific validation message from the external system (e.g., 'Invalid cost center code: 9999') and the field that caused the failure
- Given I have corrected the underlying data issue, When I click 'Retry Failed Records', Then only the failed records from the last run are retried without re-exporting already-successful records
- Given an integration has been healthy for 7 days, When I view sync history, Then I see a timeline of all syncs with record counts and duration, allowing me to identify performance trends
- Given a sync failure occurs, When the failure threshold is exceeded (2 consecutive failures), Then the system sends an in-app notification and email to the organization admin with the error summary
Business Value
Silent integration failures are the highest-risk scenario for finance teams — by the time they notice data is missing, the accounting period may be closed and corrections require manual journal entries. Real-time health monitoring with proactive failure notifications gives admins a 24-hour window to resolve issues before end-of-day accounting cutoffs. For organizations like HLF processing hundreds of expense claims monthly, this prevents payment delays to peer mentors and keeps the Dynamics portal synchronized with the app's approval state.
Components
- Integration Configuration Dashboard ui
- Integration Health Monitor service
- Integration Edge Functions infrastructure
- Organization Integration Repository data
- Admin Notification Dispatcher infrastructure