Skip to content
SyncID Docs

Health Monitoring

SyncID includes built-in health monitoring with a visual dashboard, automated checks, and Microsoft Teams integration for proactive alerting.

Health dashboard

Section titled “Health dashboard”

Access the health dashboard at /health-dashboard. It displays the real-time status of:

CheckWhat it monitors
DatabaseSQL Server connectivity and query performance
SyncrOne APIReachability of the central SyncrOne application
Notification ServiceEmail delivery service availability

Status indicators

Section titled “Status indicators”
StatusMeaning
HealthyThe service is operating normally
DegradedThe service is experiencing issues but the application can still function
UnhealthyThe service is down — some functionality is impaired

The dashboard also shows health check history with sparkline charts, allowing you to spot trends and intermittent issues over time.

Health check details

Section titled “Health check details”

Database check

Section titled “Database check”

Verifies that SyncID can connect to and query the SQL Server database. A failure here means the application cannot store or retrieve data.

On failure: All functionality is impacted — attendance records cannot be stored, employees cannot be managed, and login is unavailable.

SyncrOne API check

Section titled “SyncrOne API check”

Verifies that the SyncrOne API endpoint is reachable. This check reports Degraded (not Unhealthy) when SyncrOne is down, because SyncID can continue to operate independently.

On failure: Employee sync and attendance delivery to SyncrOne are blocked. Device management and local attendance collection continue normally.

Notification Service check

Section titled “Notification Service check”

Verifies that the email notification service is reachable.

On failure: Email notifications (device offline alerts, startup errors, password resets) stop. All other functionality is unaffected.

Teams notifications

Section titled “Teams notifications”

SyncID can send health alerts to a Microsoft Teams channel via webhook.

Setup

Section titled “Setup”
  1. Create an incoming webhook in your Teams channel
  2. Copy the webhook URL
  3. Configure it in Configurations/healthchecks.json:
{
  "HealthChecks": {
    "TeamsWebhookUrl": "https://your-organization.webhook.office.com/..."
  }
}
  1. Restart the application for the change to take effect

What gets notified

Section titled “What gets notified”
  • Health check status changes (Healthy → Degraded → Unhealthy)
  • Application startup failures
  • Recovery after an outage

Device monitoring

Section titled “Device monitoring”

In addition to the health checks above, SyncID monitors device connectivity:

FeatureDetails
Online checkEvery 10 minutes, all devices are pinged
3-strike alertAfter 3 consecutive failed pings, an email alert is sent to configured admins
Offline trackingSyncID records when devices go offline and recover for audit purposes
Recovery notificationWhen an offline device comes back online, a recovery email is sent
Section titled “Recommended monitoring setup”
  1. Configure Teams webhook for real-time health alerts
  2. Set up admin email notifications for system alerts
  3. Check the health dashboard daily as part of routine operations
  4. Review scheduled tasks weekly for failed tasks or stuck processes
Section titled “Related”