Menu AuthGuardHelp centre
Portuguêsauthguard.pt

Administrators · Edge appliance

Edge appliance health (heartbeat, clock, certificates)

  • 1 min read
  • SaaS · Self-hosted · Edge
  • Video
Tutorial 03Install the Edge appliance2:14 · Narrated in Portuguese, with English captions.Transcript and details

Each active appliance sends a heartbeat with its version, module states, audit queue, clock offset and disk use. The console flags problems on the appliance's row.

Which warnings are there?

WarningMeaningWhat to do
«No heartbeat» / «No heartbeat for 5 minutes»The appliance is not reportingCheck that the container or service is running and that outbound 443 to the Edge URL works
«No heartbeat yet»It never reported after enrolmentCheck the installation and the code
«Module failed»A module stoppedCheck the appliance's logs; the agent restarts the module
«Audit queue above 80 %»Audit is not being sentCheck the connection; the queue drains when it returns
«Clock offset»More than 5 seconds offFix the host's NTP
«Certificate expiring»Under 7 daysAutomatic renewal failed; check the connection
«Configuration not applied»The revision has not been applied for 15 minutesCheck the appliance's logs
«Audit chain discontinuity»An audit upload does not continue the chainTreat it as an incident; contact support

How do I see details on the host?

  • docker logs authguard-edge or journalctl -u authguard-edge.
  • authguard-edge diag: version, key custody and agent status.
  • The read-only status page on port 8443, from the management networks.

The appliance lost its host secret

Without the secret, the appliance cannot open its keys. Retire it and enrol it again with «New code».

Clock

The appliance uses the server's time as its trusted clock and refuses new sessions when the offset is large. Keep NTP running on the host.

Error codes in this article

Article referencead-edge-healthquote it to support to identify this article. Checked against the product at commit 5f6607a8.