Troubleshooting

Short answers to common situations.

A server stays "offline"

• Check the connection string under Servers → Edit.
• Check reachability/firewall between the monitor host and the SQL Server.
• The account used needs VIEW SERVER STATE (or the cloud equivalent) for the DMV queries.

Connection strings are "gone" after an update

The usual cause was an unreadable encryption key. Since the move to the fixed key this no longer happens (see Backup & keys). Re-enter any already-lost entries once – they stay stable afterwards.

"Scan in progress" never finishes

The process was probably stopped mid index-scan. The scheduler marks such orphaned runs as failed after a timeout; Scan now becomes available again afterwards.

Impact analysis spins forever

The monitored server isn't responding in time. The analysis aborts after a fixed deadline with a clear message instead of loading forever – if you see a timeout message, the target server is slow or unreachable.

Notifications don't arrive

• Settings → Notifications: is a channel configured and mapped to the severity?
• Check whether a silence window (maintenance) is currently active.
• For email/Teams/PagerDuty, verify the stored credentials.

Further operations documentation

Detailed guides (deployment, backup/restore, upgrade, SSO, license) ship as Markdown in the docs/ directory of the distribution.