Citrix® Health Check Checklist: 45 Checks for CVAD and DaaS

A useful Citrix health check is a list of specific questions, each with a command that answers it and a known-good result. This checklist covers Citrix Virtual Apps and Desktops (CVAD), Citrix DaaS and NetScaler Gateway. Every row says what to check, how to check it, and what "good" looks like. All checks are read-only.

Before you start: the built-in tools

• Citrix Scout (CVAD) runs health checks against Delivery Controllers, VDAs, StoreFront and License Servers. The site checks use the Environment Test Service and can take up to an hour on large sites (Citrix docs).
• Cloud Health Check (DaaS) checks VDAs, StoreFront and Profile Management. Run it from a domain-joined machine, never a Cloud Connector (Citrix docs).
• Web Studio > Home > Test site checks database health, connectivity, delegated administration, registration state and more (Citrix docs).
• Citrix Health Assistant troubleshoots unregistered VDAs (Citrix docs).

For a quick Citrix health check PowerShell script on CVAD, this read-only loop prints any FMA service on any Controller that isn't OK. It uses -AdminAddress, a common Citrix SDK parameter (Citrix SDK):

$cmds = 'Get-BrokerServiceStatus','Get-ConfigServiceStatus','Get-LogServiceStatus',
        'Get-MonitorServiceStatus','Get-HypServiceStatus','Get-ProvServiceStatus',
        'Get-AcctServiceStatus','Get-AdminServiceStatus'
foreach ($ddc in (Get-BrokerController).DNSName) {
  foreach ($c in $cmds) {
    $s = & $c -AdminAddress $ddc
    if ($s.ServiceStatus -ne 'OK') { '{0}  {1}: {2}' -f $ddc, $c, $s.ServiceStatus }
  }
}

Site, Delivery Controllers and SQL (CVAD)

Cloud Connectors (DaaS)

VDAs and images

StoreFront

Licensing

NetScaler Gateway

Profiles: FSLogix and WEM

Monitoring and Director

Security and patching

Backup and DR

FAQ

Is there an official Citrix health check tool?

Yes, several. Citrix Scout and Web Studio's Test site cover CVAD. Cloud Health Check and Studio's Run Health Check cover DaaS. Citrix Health Assistant handles unregistered VDAs, and WEM has its own health check tool. None of them covers NetScaler, FSLogix or your backups, which is why the list above exists.

Is there a Citrix health check PowerShell script?

Citrix ships cmdlets, not a single script. The loop above plus rows 1–7 and 14–17 make a read-only script. Start-EnvTestTask runs Citrix's own infrastructure tests from PowerShell.

How do you health check Citrix DaaS?

Citrix runs the control plane, so focus on what you own: Cloud Connectors (rows 8–13), VDAs, StoreFront, profiles and NetScaler Gateway. For DaaS PowerShell, use the Remote PowerShell SDK after Get-XdAuthentication (Citrix docs).

How often should you run a Citrix health check?

Run the PowerShell rows weekly, and the full list before and after every upgrade. Also run it whenever a new NetScaler bulletin lands.

Want a second pair of eyes?

The Sessionwright assessment runs this kind of check across your Citrix site and NetScaler Gateway. It is read-only, and an expert reviews the report before it reaches you. Sessionwright for Citrix is read-only by default too: every change it proposes waits for your approval and is logged (security model).

Sources

• Citrix docs: Citrix Scout health checks; Cloud Health Check; Run Health Check for VDAs; Web Studio home page (Test site); Director: Troubleshoot machines
• Citrix SDK: Get-BrokerController, Get-BrokerServiceStatus, Get-ConfigServiceStatus, Test-BrokerDBConnection, Get-BrokerDBConnection, Start-EnvTestTask, Get-BrokerDesktopGroup, Get-BrokerHypervisorConnection, Get-BrokerSite, Get-BrokerMachine, Get-AdminAdministrator, Get-LogHighLevelOperation; DaaS Remote PowerShell SDK
• Citrix docs: Local Host Cache; Databases; Backup and restore (Automated Configuration); Backup and restore configuration; Enable TLS on Delivery Controllers; VDA versions and functional levels
• Citrix Cloud docs: Cloud Connector system requirements; Technical details; Connector updates; Advanced connectivity checks; DaaS Infrastructure Monitoring
• StoreFront: Get-STFDeployment, Get-STFServerGroupConfiguration, Get-STFStoreFarm; Configure HTTPS; Server groups
• Licensing: CVAD License Activation Service; Licensing What's new (file-based EOL); License Activation Service; Citrix product lifecycle matrix
• NetScaler: CLI reference for show ns version, HA node, ssl certKey, vpn vserver, lb vserver, serviceGroup, ntp status, system backup; docs: Limiting failovers (HA output), Basic operations, Gateway with StoreFront
• Microsoft Learn (FSLogix): Release notes; Configuration settings; Events, logs and diagnostics; Storage permissions; Prerequisites
• Citrix WEM: WEM health check tool; Administration (agents)
• Director: Alerts and notifications; Probes