Citrix DaaS

Cloud Health Check

注意:

Cloud Health Check 已集成到 Citrix DaaS 中。 该集成在 Studio 中作为 Run Health Check 操作提供。 有关更多信息,请参阅 对 VDA 注册和会话启动问题进行故障排除.

Cloud Health Check 允许您运行检查来衡量站点及其组件的运行状况和可用性。 您可以对 Virtual Delivery Agent (VDA)、StoreFront 服务器和 Profile Management 运行运行状况检查。 VDA 运行状况检查确定常见 VDA 注册和会话启动问题的可能的原因。

如果在检查期间出现问题,Cloud Health Check 会提供详细报告和修复问题的操作。 每次启动 Cloud Health Check 时,它都会检查内容分发网络 (CDN) 上是否有最新版本的脚本,如果脚本在本地计算机上不存在,则会自动下载这些脚本。 Cloud Health Check 始终选择脚本的最新本地版本来运行运行状况检查。

注意:

Cloud Health Check 不会在每次运行时更新。

在 Citrix Cloud 环境中,从加入域的计算机运行 Cloud Health Check,以在一个或多个 VDA 或 StoreFront 服务器上运行检查。

注意:

您无法在 Cloud Connector 上安装或运行 Cloud Health Check。

Cloud Health Check 应用程序的日志存储在 C:\ProgramData\Citrix\TelemetryService\CloudHealthCheck.log. 您可以使用此文件进行故障排除。

查看 Cloud Health Check 简介。

什么是 Cloud Health Check

查看何时使用 Cloud Health Check。

何时使用 Cloud Health Check

安装

要准备环境以安装 Cloud Health Check,您必须拥有已加入域的 Windows 计算机。

注意:

您无法在 Cloud Connector 上安装或运行 Cloud Health Check。

  1. 在已加入域的计算机上,下载 Cloud Health Check 安装程序.
  2. 双击 CloudHealthCheckInstaller_x64.msi 文件。
  3. 单击该框以接受条款。
  4. 单击 Install。

    云健康检查 1

  5. 安装完成后,单击 完成.

    云运行状况检查 2

权限和要求

权限:

  • 要运行运行状况检查,请执行以下操作:

    • 您必须是 domain users 组的成员。
    • 您必须是完全权限管理员或具有只读和 运行环境测试 网站的权限。
    • 将脚本执行策略设置为至少 远程签名 以允许脚本运行。 例如: Set-ExecutionPolicy 远程签名. 注意: 其他脚本执行权限也可以正常工作。
  • 以管理员身份运行 启动 Cloud Health Check 时。

对于运行运行状况检查的每台 VDA 或 StoreFront 计算机:

  • 操作系统必须为 64 位。
  • Cloud Health Check 必须能够与计算机通信。
  • 必须打开文件和打印机共享。
  • 必须启用 PSRemoting 和 WinRM。 计算机还必须运行 PowerShell 3.0 或更高版本。
  • 必须在计算机上启用 Windows 管理基础结构 (WMI) 访问。

关于运行状况检查

运行状况检查数据存储在“C:\ProgramData\Citrix”下的文件夹中\TelemetryService' 的 EllemetryService' 中。

VDA 运行状况检查

在 VDA 上注册时,Cloud Health Check 会检查:

  • VDA 软件安装
  • VDA 计算机域成员资格
  • VDA 通信端口可用性
  • VDA 服务状态
  • Windows 防火墙配置
  • 与控制器通信
  • 与控制器的时间同步
  • VDA 注册状态

对于在 VDA 上启动的会话,Cloud Health Check 会检查:

  • 会话启动通信端口可用性
  • 会话启动服务状态
  • 会话启动 Windows 防火墙配置
  • VDA 远程桌面服务客户端访问许可证
  • VDA 应用程序启动路径
  • 会话启动注册表设置
  • Citrix Universal Injection Driver (CTXUVI) 状态

对于 VDA 上的 Profile Management,Cloud Health Check 会检查:

  • 虚拟机管理程序检测
  • 预配检测
  • Citrix Virtual Apps and Desktops
  • Personal vDisk 配置
  • 用户存储
  • Profile Management Service 状态检测
  • Winlogon.exe钩测试

要在 Profile Management 上运行检查,必须在 VDA 上安装并启用 Profile Management。 有关 Profile Management 配置检查的更多信息,请参阅知识中心文章 CTX132805.

StoreFront 运行状况检查

StoreFront 检查验证是否:

  • Citrix 默认域服务正在运行
  • Citrix Credential Wallet 服务正在运行
  • 从 StoreFront 服务器到 Active Directory 的连接为端口 88
  • 从 StoreFront 服务器到 Active Directory 的连接是端口 389
  • 从 StoreFront 服务器到 Active Directory 的连接为端口 464
  • 基 URL 具有有效的 FQDN
  • 可以从基本 URL 中检索正确的 IP 地址
  • IIS 应用程序池正在使用 .NET 4.0
  • 证书将绑定到主机 URL 的 SSL 端口
  • 证书链完整
  • 证书已过期
  • 证书将在 30 天内过期

运行 Cloud Health Check

要运行 Citrix Cloud 运行状况检查,请执行以下操作:

  1. 选择 Citrix > Citrix Cloud 运行状况检查 从计算机的开始菜单,或运行 CloudHealthCheck.exeC:\Program Files\Citrix\CloudHealthCheck.

    云运行状况检查 3

  2. 在 Cloud Health Check 主屏幕上,单击 添加机器.

    云运行状况检查 4

  3. 键入要添加的计算机的 FQDN。 注意: 尽管输入 DNS 别名而不是 FQDN 可能看起来有效,但运行状况检查可能会失败。
  4. 点击 继续.
  5. 根据需要重复上述步骤以添加其他计算机。

    云运行状况检查 5

  6. 要删除手动添加的计算机,请单击 X 并确认删除。 重复上述步骤可删除其他手动添加的计算机。

Cloud Health Check 会记住手动添加的计算机,直到您将其删除。 当您关闭并重新打开 Cloud Health Check 时,手动添加的计算机仍列在列表顶部。

导入 VDA 计算机

运行运行状况检查时,可以在部署中导入 VDA 计算机。

  1. 在 Connector 上,使用以下 PowerShell 命令生成计算机列表文件。 在 Connector 上,您必须输入 Citrix 凭据并在弹出对话框中选择客户。

Get-BrokerMachine| foreach { $_.DnsName } | out-file C:\machineList.txt

  1. 将 machineList.txt 文件复制到要运行 Cloud Health Check 的已加入域的计算机。
  2. 在 Cloud Health Check 页面上,单击 添加机器.
  3. 选择 Windows VDA 计算机类型。
  4. 点击 导入 VDA 计算机.
  5. 选择 machineList.txt 文件。
  6. 点击 打开.

    云运行状况检查 6

    导入的 VDA 计算机将列在 Cloud Health Check 页面上。

  7. 选中要运行运行状况检查的每台计算机旁边的复选框。

    Cloud Health Check 会自动在每台选定的计算机上启动验证测试,确保其满足验证测试中列出的条件。 如果验证失败,则 地位 列,并清除该计算机的复选框。 然后,您可以:

    • 解决问题,然后再次选中计算机的复选框。 这将触发验证测试的重试。
    • 通过取消选中该计算机的复选框来跳过该计算机。 不会为该计算机运行运行状况检查。
  8. 验证测试完成后,单击 继续.

    云运行状况检查 7

  9. 在选定的计算机上运行运行状况检查。 摘要列出了运行测试的计算机(您选择的通过验证测试的计算机)。

  10. 点击 开始检查.

    云运行状况检查 8

    在检查期间和之后, 地位 列指示计算机的当前检查状态。

  11. 要停止所有正在进行的检查,请单击 停止检查 在页面的右下角。 您无法取消单台计算机的运行状况检查,只能取消所有选定计算机的检查。

    云运行状况检查 9

  12. 完成所有选定计算机的检查后, 停止检查 按钮变为 .

    云运行状况检查 10

    • 如果检查失败,您可以单击 重试行动 列。
    • 如果检查完成但未发现问题,则 行动 列为空。
    • 如果检查发现问题,请单击 查看详情 以查看结果。

    云运行状况检查 11

如果使用 Internet Explorer 查看报告,则必须单击 允许阻止的内容 以显示超链接。

云健康检查 12

完成所有选定计算机的检查后,单击 返回 导致您丢失检查结果。

检查完成后,单击 以返回到 Cloud Health Check 主屏幕。

检索 VDA 计算机

Cloud Health Check 可以从 Citrix DaaS(以前称为 Citrix Virtual Apps and Desktops 服务)部署中自动检测和检索 VDA。

要检索 VDA,请执行以下操作:

  1. 准备一台新计算机,该计算机加入与运行 Cloud Health Check 的计算机相同的域林。
  2. 打开 Cloud Health Check 并单击 查找机器 以登录 Citrix Cloud。

    云运行状况检查检索 1

  3. 选择具有要检索的云站点的客户。

    云运行状况检查检索 2

VDA 列表将显示在 Cloud Health Check 中。 该列表还保存在位于 \ProgramData\Citrix\TelemetryService\ChcDiscovery\ChcDiscoveredMachineList.json.

云运行状况检查检索 3

当您再次打开 Cloud Health Check 时,您的计算机列表将加载本地缓存。 如果您在部署中进行了任何更新,则必须单击 查找机器 以刷新计算机列表。

注意:

  • Cloud Health Check 仅查找与运行 Cloud Health Check 的计算机相同的域林中的计算机。
  • Citrix Cloud 会话将在一小时后过期。 一小时后,您必须单击 查找机器 以获取最新的 VDA 列表。
  • 如果检索 VDA 列表失败,则会弹出一条错误消息。 您可以在 C:\ProgramData\Citrix\TelemetryService\CloudHealthCheck.log.

云运行状况检查检索 4

健康检查结果

生成报告的运行状况检查包含以下元素:

  • 生成结果报告的时间和日期
  • 已检查的计算机的 FQDN
  • 在目标计算机上检查的条件

在命令行上运行 Cloud Health Check

Cloud Health Check 可以在命令行上运行,以帮助客户执行运行状况检查。 要在命令行上使用 Cloud Health Check,您必须是运行 Cloud Health Check 的计算机的管理员。

注意:

在命令行上使用 Cloud Health Check 时,一次只能检查一台计算机。 只有一个 CloudHealthCheck.exe 可以在目标计算机上同时运行。 如果要检查多台计算机,则必须通过在 cmdlet/PowerShell 脚本中将 cmdlet 包装成一个循环来逐个检查这些计算机。 还必须关闭任何打开的 Cloud Health Check UI 实例。

命令行参数

支持的命令行参数包括:

  • 计算机 FQDN - 这个参数是 命令的. 这是目标计算机的完全限定域名。
  • 机器类型 - 此参数是可选的。 参数值可以是 Windows VDA(默认值)或 StoreFront。
  • 报告名称 - 此参数是可选的。 参数值必须是 Windows 上的有效文件名。 默认值为 健康检查报告.
  • 跳过管理员检查 - 此参数是可选的。 可以添加此项以跳过需要管理员权限的检查。
  • UpdateScripts 的 - 此参数是可选的。 可以添加此字段以从 CDN 服务器更新检查脚本。
  • 禁用 Ceip - 如果在 UI 上启用了 CEIP,则此参数是可选的,请添加它以禁用 CEIP。
  • 帮助 - 显示有关参数的帮助信息。

示例:

HealthCheckCLI.exe -MachineFQDN machine.domain.local

HealthCheckCLI.exe -MachineFQDN machine.domain.local -ReportName checkreport

HealthCheckCLI.exe -MachineFQDN machine.domain.local -SkipAdminCheck

HealthCheckCLI.exe -MachineFQDN machine.domain.local -UpdateScripts

HealthCheckCLI.exe -MachineFQDN machine1.domain.local,machine2.domain.local,machine3.domain.local

HealthCheckCLI.exe -Help

注意:

参数名称不区分大小写。

默认情况下,控制台输出不会显示在命令行控制台窗口中。 您可以通过附加 |更多 到参数中。

例: HealthCheckCLI.exe -MachineFQDN machine.domain.local|更多

命令行默认值需要管理员权限才能运行。 添加参数 -跳过管理员检查 以覆盖对管理员权限的需求。

退出代码

退出代码在命令行中解释 Cloud Health Check 检查的结果。 要获取退出代码,您必须添加 start /wait 在命令行之前。

例: start /wait HealthCheckCLI.exe -MachineFQDN machine.domain.local

退出代码为:

  • 0 - 正常,选中已完成并通过。
  • 1 - 失败,检查已完成,但有问题。
  • 2 - 错误,检查未完成,但出现错误。

您还可以使用参数 回波 %errorlevel% 以获取上次 RAN 命令的退出代码。

报告

Cloud Health Check 会在 中创建具有计算机名称的文件夹 HealthCheckData文件夹 对于目标计算机。 .html 文件和.json文件是在安装 Cloud Health Check 的计算机上创建的。 运行状况检查报告位于 HealthCheckData文件夹%ProgramData%\Citrix\TelemetryService\HealthCheck\Data.

仅当目标计算机上存在问题时,才会创建报告。

注意:

如果存在指定的报表名称,则报表文件将被覆盖。

警报和基本信息存储在 .json 报告中。

JSON 报告屏幕截图

报表代码为:

  • issueKey:问题的纯文本描述。
  • issueUuid:问题的唯一标识字符串。
  • fixRecommendation:问题的修复建议。
  • 严厉:指示是否必须修复问题。 错误可能表示组件(VDA 或 StoreFront)出现故障,警告表示组件可以工作,但可能存在一些潜在问题。
  • 问题名称:问题的名称。
  • issue描述:问题的详细描述。

更新 Cloud Health Check

如果有新版本的 Cloud Health Check 可用,则 Cloud Health Check (云健康检查) 窗口的右上角会显示 Update available (可用更新) 链接。 单击链接转到 Citrix 下载以获取新版本。

更新 Cloud Health Check

Cloud Health Check 计划程序

使用 Cloud Health Check 计划程序执行定期运行状况检查。

设置计划

  1. 点击 添加机器 以添加要运行定期检查的计算机。

    云运行状况检查计划程序 1

  2. 单击时钟图标,然后单击 设置计划.

    Cloud Health Check Scheduler 2

  3. 为您的计划选择一个时间,然后单击 下一个. 可以通过选择 重复任务间隔 复选框。
  4. 选择将结果输出到 Windows 事件日志。 可以将任务设置为将结果写入 Windows 事件日志。
  5. 选择在计划检查完成后触发自定义 PowerShell 脚本,然后单击 下一个.
    • 点击 编辑 以在 Windows PowerShell ISE 中编辑脚本内容(如果需要)。
    • 点击 以打开文件位置并使用其他编辑器打开文件以编辑脚本。
    • 点击 重置 将脚本重置为其原始设置。

    注意:

    • 您无法更改脚本的脚本名称和路径。
    • 您可以使用 ChcShceduledTrigger.ps1 脚本实现自定义操作,例如在计划检查报告准备就绪后发送电子邮件。 将以下代码添加到脚本的末尾。 自定义代码以添加正确的电子邮件帐户和 SMTP 服务器地址。 将使用计划任务运行的账户的凭证发送电子邮件通知。

             #Sending email example code:
             $body = "CreatedTime: $($report.CreatedTime)"
             $body = $body + "`nStatusCode: $($report.StatusCode)"
             $body = $body + "`nMachineCount: $($report.MachineReports.Count)"
             $from = "mock_email_accout"
             $to = "mock_email_accout"
             $smtpServer = "mock_smtp_server"
          
             Send-MailMessage -Subject "Citrix Cloud Health Check Scheduler Report" -Body $body -From $from -To $to -SmtpServer $smtpServer
       <!--NeedCopy-->
      

    云运行状况检查计划程序 3

  6. 为您的计划选择计算机,然后单击 下一个.

    Cloud Health Check Scheduler 4

  7. 输入运行任务的账户的凭证,然后单击 完成.

    云运行状况检查计划程序 5

  8. CloudHealthCheckScheduler 任务是在 Windows Task Scheduler 中创建的。

    Cloud Health Check Scheduler 6

查看计划结果

带有红点的时钟图标表示在上次检查中发现了问题。 要查看结果,请单击时钟图标,然后单击 查看结果.

云运行状况检查计划程序 7

Schedule Reports (计划报告) 页面显示所有计划运行状况检查任务的结果。 点击 查看报告 检查每个计划的报告。

云运行状况检查计划程序 14

html 报表列出了每个计划的总体报表。 报告示例如下:

云运行状况检查计划程序 12

所有运行状况检查结果都存储在名为 ChcSchedule 的文件夹中。 Cloud Health Check 在每次检查运行期间会创建三个文件。 最多保留 500 个迭代日志。

云运行状况检查计划程序 8

云运行状况检查计划程序 11

如果 将结果输出到 Windows 事件日志 复选框,则检查结果也会发送到 Window 事件日志。

云运行状况检查计划程序 13

禁用计划

  1. 单击时钟图标,然后单击 设置计划.

    云运行状况检查计划程序 9

  2. 点击 关闭,然后单击 完成 以禁用调度程序。

    云运行状况检查计划程序 10

更多信息

  • 您必须先将 VDA 添加或导入到 Cloud Health Check。 有关更多信息,请参阅 导入 VDA 计算机.
  • Cloud Health Check 计划程序一次只能在加入域的计算机上计划一个任务。 如果多次设置计划,则仅以最新的一次生效。

验证测试

在运行状况检查开始之前,会自动为每台选定的计算机运行验证测试。 这些测试可确保满足运行运行状况检查的要求。 如果计算机的测试失败,Cloud Health Check 会显示一条消息,其中包含建议的纠正措施。

  • Cloud Health Check 无法访问此计算机 - 确保:
    • 机器已开机。
    • 网络连接工作正常。 (这可能包括验证防火墙是否已正确配置。
    • 文件和打印机共享已打开。 有关说明,请参阅 Microsoft 文档。
  • 启用 PSRemoting 和 WinRM - 您可以通过以管理员身份运行 PowerShell,然后运行 Enable-PSRemoting cmdlet 来启用 PowerShell 远程处理和 WinRM。 有关详细信息,请参阅 cmdlet 的 Microsoft 帮助。
  • Cloud Health Check 需要 PowerShell 3.0 或更高版本 - 在计算机上安装 PowerShell 3.0 或更高版本,然后启用 PowerShell 远程处理。
  • WMI 未在计算机上运行 - 确保已启用 Windows Management Instrumentation (WMI) 访问。
  • WMI 连接被阻止 - 在 Windows 防火墙服务中启用 WMI。

使用数据收集

当您使用 Cloud Health Check 时,Citrix 使用 Google Analytics 收集匿名使用数据,以用于未来的产品功能和改进。 默认情况下,数据收集处于启用状态。

要更改使用情况数据收集和上传,请单击 设置 gear 中的 Cloud Health Check UI 中。 然后,您可以通过选择 是的 ,然后单击 .

云健康检查 13

自动修复

自动修复允许 Cloud Health Check 通过更改设置或重新启动服务来自动检测和修复某些问题。

自动修复会检查以下 VDA 注册项目,并提供建议的修复:

  • VDA 计算机域成员资格
    • 修复:使用“修复”模型测试连接安全通道
  • VDA 服务状态
    • 修复:重新启动 BrokerAgent 服务
  • 与控制器通信
    • 修复:重新启动 BrokerAgent 服务
  • 与控制器的时间同步
    • 修复:运行 W32tm 命令

对于会话启动,自动修复会检查以下项目,并提供建议的修复:

  • Session 启动服务状态
    • 修复:重新启动 BrokerAgent 服务

默认情况下,此功能处于启用状态。 要禁用它,请单击 Cloud Health Check 主窗口右上角的齿轮图标,然后清除 尝试在运行状况检查期间自动修复 VDA 问题.

云运行状况检查自动修复 1

结果报告

运行自动修复后,检查结果报告中有一个部分显示所有详细信息:

云运行状况检查自动修复 2

云运行状况检查自动修复 3

故障排除

当 Cloud Health Check 运行失败或出现异常时,请检查 Cloud Health Check 日志 C:\ProgramData\Citrix\TelemetryService\CloudHealthCheck.log.

每台目标计算机的 Cloud Health Check 日志位于 C:\ProgramData\Citrix\TelemetryService\HealthCheck\Data\$TargetMachineFQDN\log.txt.

要启用调试日志,请执行以下操作:

编辑 C:\Program Files\Citrix\CloudHealthCheck\CloudHealthCheck.exe.config更新 <add name="TraceLevelSwitch" value="3" /> 自 <add name="TraceLevelSwitch" value="4" />,保存文件并重新打开 Cloud Health Check。

反馈

要在 Cloud Health Check 上留下反馈,请填写 Citrix 调查.