Citrix 洞察服务
Citrix Insight Services (CIS) 是一个 Citrix 平台，用于生成检测、遥测和业务洞察。其检测和遥测功能使技术用户（客户、合作伙伴和工程师）能够自我诊断和修复问题并优化其环境。有关 CIS 及其工作原理的详细信息和最新信息，请参阅 https://cis.citrix.com（需要 Citrix 帐户凭据）。
Citrix Insight Services 提供的功能不断增长和发展，现已成为 Citrix Smart Tools 的一个组成部分。Citrix Smart Tools 使您能够自动执行部署任务、运行状况检查和电源管理。有关这些技术的信息，请参阅 Citrix Smart Tools 文档。
所有上传到 Citrix 的信息均用于故障排除和诊断目的，以及改进产品的质量、可靠性和性能，但须遵守以下规定：
- Citrix 洞察服务策略，位于 https://cis.citrix.com/legal
- Citrix 隐私策略，网址为 https://www.citrix.com/about/legal/privacy.html
此 XenApp 和 XenDesktop® 版本支持以下工具和技术。
- 思杰 XenApp® 和 思杰 XenDesktop 安装和升级分析
- Citrix 客户体验改善计划
- 思杰智能工具
- Citrix 回拨（Citrix 智能工具的一部分）
- 思杰侦察兵
安装和升级分析功能
当您使用完整产品安装程序部署或升级 XenApp 或 XenDesktop 组件时，有关安装过程的匿名信息会在您安装/升级组件的计算机上收集和存储。此数据用于帮助 Citrix 改善客户的安装体验。
这些信息会本地存储在 %ProgramData%\Citrix\CTQs 路径所指定的目录下。
此数据的自动上传在完整产品安装程序的图形界面和命令行界面中默认启用。
- 您可以在注册表设置中更改默认值。如果您在安装/升级之前更改注册表设置，则在使用完整产品安装程序时将使用该值。
- 如果您使用命令行界面安装/升级，可以通过在命令中指定一个选项来覆盖默认设置。
控制安装/升级分析数据自动上传的注册表设置（默认值 = 1）：
Location: HKLM:\Software\Citrix\MetaInstall Name: SendExperienceMetrics Value: 0 = disabled, 1 = enabled
使用 PowerShell，以下 cmdlet 可禁用安装/升级分析数据的自动上传：
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\MetaInstall -Name SendExperienceMetrics -PropertyType DWORD -Value 0
To disable automatic uploads with the XenDesktopServerSetup.exe or XenDesktopVDASetup.exe command, include the /disableexperiencemetrics option.
To enable automatic uploads with the XenDesktopServerSetup.exe or XenDesktopVDASetup.exe command, include the /sendexperiencemetrics option.
Citrix 客户体验改善计划 (CEIP)
当您参与 Citrix 客户体验改善计划 (CEIP) 时，匿名统计数据和使用信息将发送给 Citrix，以帮助 Citrix 改进 Citrix 产品的质量和性能。有关详细信息，请参阅 https://more.citrix.com/XD-CEIP。
站点创建或升级期间的注册
当您创建 XenApp 或 XenDesktop 站点（安装第一个 Delivery Controller™ 后）时，您将自动注册 CEIP。首次数据上传大约在您创建站点七天后进行。您可以在创建站点后的任何时间停止参与；在 Studio 导航窗格（产品支持选项卡）中选择配置节点并按照指导操作。
When you upgrade a XenApp or XenDesktop deployment:
- 如果您从不支持 CEIP 的版本升级，系统会询问您是否要参与。
- 如果您从支持 CEIP 的版本升级，并且已启用参与，则 CEIP 将在升级后的站点中启用。
- 如果您从支持 CEIP 的版本升级，并且已禁用参与，则 CEIP 将在升级后的站点中禁用。
- 如果您从支持 CEIP 的版本升级，并且参与状态未知，系统会询问您是否要参与。
收集的信息是匿名的，因此上传到 Citrix Insight Services 后无法查看。
安装 VDA 时的注册
默认情况下，当您安装 Windows VDA 时，会自动注册 CEIP。您可以在注册表设置中更改此默认值。如果您在安装 VDA 之前更改注册表设置，则将使用该值。
控制 CEIP 自动注册的注册表设置（默认值 = 1）：
Location: HKLM:\Software\Citrix\Telemetry\CEIP Name: Enabled Value: 0 = disabled, 1 = enabled
默认情况下，“Enabled”属性在注册表中是隐藏的。当它未指定时，自动上传功能将启用。
使用 PowerShell，以下命令禁用 CEIP 注册：
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0
收集的运行时数据点会定期作为文件写入输出文件夹（默认 %programdata%/Citrix/VdaCeip）。
首次数据上传大约在您安装 VDA 七天后进行。
在安装其他产品和组件时进行注册
You can also participate in CEIP when you install related Citrix products, components, and technologies, such as Provisioning Services, AppDNA, Citrix License Server, Citrix Receiver™ for Windows, Universal Print Server, and Session Recording. See their documentation for details about installation and participation default values.
思杰智能工具
安装交付控制器时，可以启用智能工具访问。
默认情况下，启用 Smart Tools 访问（以及参与 Call Home，如果尚未启用）的选项处于选中状态。单击 连接。浏览器窗口将打开并自动导航到 Smart Services 网页，您可以在其中输入您的 Citrix Cloud™ 帐户凭据。（如果您没有 Citrix Cloud 帐户，只需输入您的 Citrix 帐户凭据，系统就会自动为您创建一个新的 Citrix Cloud 帐户。）身份验证后，证书将静默安装在 Smart Tools Agent 目录中。
要使用智能工具技术，请参阅智能工具文档。
思杰回拨
在 XenApp 或 XenDesktop 中安装某些组件和功能时，系统会提供参与 Citrix Call Home 的机会。Call Home 收集诊断数据，然后定期将包含这些数据的遥测包直接上传到 Citrix Insight Services（通过默认端口 443 上的 HTTPS），以进行分析和故障排除。
在 XenApp 和 XenDesktop 中，回拨作为名为思杰遥测服务的后台服务运行。有关详细信息，请参阅 https://more.citrix.com/XD-CALLHOME。
回拨调度功能也可在思杰 Scout 中使用。有关详细信息，请参阅思杰 Scout。
收集的内容
Citrix 诊断工具 (CDF) 跟踪记录了对故障排除有用的信息。Call Home 收集一部分 CDF 跟踪，这些跟踪在排查常见故障（例如 VDA 注册和应用程序/桌面启动）时会很有帮助。此技术称为始终开启跟踪 (AOT)。Call Home 不收集任何其他 Windows 事件跟踪 (ETW) 信息，也无法配置为这样做。
Call Home 还会收集其他信息，例如：
- Registries created by XenApp and XenDesktop under HKEY_LOCAL_MACHINE\SOFTWARE\Citrix
- Citrix 命名空间下的 Windows 管理规范 (WMI) 信息
- 正在运行的进程列表
- Citrix 进程的崩溃转储文件，这些文件存储在 %PROGRAM DATA%\Citrix\CDF 路径中
跟踪信息在收集时会被压缩。Citrix Telemetry Service 最多保留 10 MB 压缩的最新跟踪信息，最长保留时间为八天。
- 压缩数据可使 Call Home 在 VDA 上保持较小的占用空间。
- 跟踪信息保存在内存中，以避免预配计算机上的 IOP。
- 跟踪缓冲区使用循环机制在内存中保留跟踪信息。
Call Home 收集以下关键数据点：Call Home 关键数据点
配置和管理摘要
您可以在使用完整产品安装向导时或之后，使用 PowerShell cmdlet 注册 Call Home。注册后，默认情况下，诊断信息会在当地时间每周日凌晨 3:00 左右收集并上传到 Citrix。上传时间会在指定时间的基础上随机化，间隔两小时。这意味着使用默认计划的上传会在凌晨 3:00 到凌晨 5:00 之间进行。
如果您不想按计划上传诊断信息（或者您想更改计划），您可以使用 PowerShell cmdlet 手动收集和上传诊断信息或将其存储在本地。
当您注册计划的 Call Home 上传以及手动将诊断信息上传到 Citrix 时，您需要提供 Citrix 帐户或 Citrix Cloud 凭据。Citrix 会将凭据交换为上传令牌，该令牌用于识别客户并上传数据。凭据不会保存。
发生上传时，通知将通过电子邮件发送到与 Citrix 帐户关联的地址。
先决条件
- 计算机必须运行 PowerShell 3.0 或更高版本。
- Citrix Telemetry 服务必须在计算机上运行。
- The system variable PSModulePath must be set to Telemetry’s install path, for example, C:\Program Files\Citrix\Telemetry Service\.
在组件安装期间启用 Call Home
在 VDA 安装或升级期间： 当您使用完整产品安装程序中的图形界面安装或升级 Virtual Delivery Agent 时，系统会询问您是否要参与 Call Home。有两个选项：
- 参与回传功能。
- 不参与呼叫支持。
如果您正在升级 VDA 并且之前已注册 Call Home，则该向导页面将不会出现。
在 Controller 安装或升级期间： 当您使用图形界面安装或升级 Delivery Controller 时，系统会询问您是否要参与 Call Home 并连接到 Citrix Smart Tools。有三个选项：
- 连接到 Citrix Smart Tools，其中包括通过 Smart Tools 代理提供的 Call Home 功能。这是默认和推荐选项。如果您选择此选项，则 Smart Tools 代理将进行配置。（无论是否选择此选项，Smart Tools 代理都会安装。）
- 仅参与呼叫支持，但不连接到 Smart Tools。如果您选择此选项，则会安装 Smart Tools 代理，但不会进行配置。呼叫支持功能通过 Citrix Telemetry Service 和 Citrix Insight Services 提供。
- 请勿连接到智能工具或参与回传功能。
当您安装 Controller 时，如果该服务器应用了包含策略设置“作为服务登录”的 Active Directory GPO，则您将无法在安装向导的 Call Home 页面上配置信息。有关详细信息，请参阅 CTX218094。
如果您正在升级 Controller 并且之前已注册 Call Home，则该页面将仅询问有关 Smart Tools 的信息。如果您已注册 Call Home 并且 Smart Agent 已安装，则该向导页面将不会出现。
有关智能工具的信息，请参阅智能工具文档。
PowerShell 命令行实用程序
PowerShell 帮助提供了全面的语法，包括这些常见用例中未使用的 cmdlet 和参数的说明。
要使用代理服务器进行上传，请参阅 配置代理服务器。
启用计划上传
诊断集合会自动上传到 Citrix。如果您不为自定义计划输入额外的 cmdlet，则会使用默认计划。
$cred = Get-Credential Enable-CitrixCallHome -Credential $cred
To confirm that scheduled uploads are enabled, enter Get-CitrixCallHome. It should return IsEnabled=True and IsMasterImage=False.
为从主映像创建的计算机启用计划上传
在主映像中启用计划上传可省去配置计算机目录中创建的每台计算机的麻烦。
Enable-CitrixCallHome -Credential $cred -MasterImage
To confirm that scheduled uploads are enabled, enter Get-CitrixCallHome. It should return IsEnabled=True and IsMasterImage=True.
创建自定义计划
为诊断集合和上传创建每日或每周计划。
$timespan = New-TimeSpan –Hours <hours> -Minutes <minutes> Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek <day> -UploadFrequency {Daily|Weekly}
取消计划上传
取消计划上传后，您仍然可以使用 PowerShell cmdlet 上传诊断数据。
Disable-CitrixCallHome
要确认已禁用计划上传，请输入 获取 CitrixCallHome。它应返回 已启用=False 和 是主映像=False。
示例
以下 cmdlet 创建一个计划，用于在每天晚上 11:20 捆绑和上传数据。请注意，Hours 参数使用 24 小时制。当 UploadFrequency 参数值为 Daily 时，如果指定了 DayOfWeek 参数，则会忽略它。
$timespan – New-TimeSpan –Hours 22 –Minutes 20 Set-CitrixCallHomeSchedule –TimeOfDay $timespan -UploadFrequency Daily
To confirm the schedule, enter Get-CitrixCallHomeSchedule, In the above example,it should return StartTime=22:20:00, DayOfWeek=Sunday (ignored), Upload Frequency=Daily.
以下 cmdlet 创建一个计划，用于在每周三晚上 11:20 捆绑和上传数据。
$timespan – New-TimeSpan –Hours 22 –Minutes 20 Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek Wed -UploadFrequency Weekly
To confirm the schedule, enter Get-CitrixCallHomeSchedule, In the above example, it should return StartTime=22:20:00, DayOfWeek=Wednesday, Upload Frequency=Weekly.
为 Call Home 上传配置代理服务器
在启用 Call Home 的计算机上完成以下任务。以下过程中的示例图包含服务器地址和端口 10.158.139.37:3128。您的信息将有所不同。
步骤 1. 在浏览器中添加代理服务器信息。在 Internet Explorer 中，选择 Internet 选项 > 连接 > 局域网设置。选择 为 LAN 使用代理服务器 并输入代理服务器地址和端口号。
Step 2. In PowerShell, run netsh winhttp import proxy source=ie.
Step 3. Using a text editor, edit the TelemetryService.exe config file, which is located in C:\Program Files\Citrix\Telemetry Service. Add the information shown in the red box below.
步骤 4. 重启遥测服务。
在 PowerShell 中运行回拨命令。
手动收集并上传用于诊断目的的信息
您可以使用 CIS 网站将诊断信息包上传到 CIS。您还可以使用 PowerShell cmdlet 收集诊断信息并将其上传到 CIS。
要使用 CIS 网站上传捆绑包：
- 使用您的 思杰 帐户凭据登录 思杰 Insight 服务。
- 选择我的工作区。
- 选择 Healthcheck，然后导航到数据所在位置。
CIS 支持多个用于管理数据上传的 PowerShell cmdlet。本文档介绍了两种常见情况下的 cmdlet：
- 使用 Start-CitrixCallHomeUpload cmdlet 手动收集诊断信息包并将其上传到 CIS。（该捆绑包不会在本地保存。）
- 使用 Start-CitrixCallHomeUpload cmdlet 手动收集数据并在本地存储诊断信息包。这允许您预览数据。然后，在稍后时间，使用 Send-CitrixCallHomeBundle cmdlet 手动将该捆绑包的副本上传到 CIS。（您最初保存的数据仍保留在本地。）
PowerShell 帮助提供了全面的语法，包括这些常见用例中未使用的 cmdlet 和参数的说明。
当您输入 cmdlet 将数据上传到 CIS 时，系统会提示您确认上传。如果 cmdlet 在上传完成前超时，请检查系统事件日志中的上传状态。如果服务已在执行上传，则上传请求可能会被拒绝。
收集数据并将捆绑包上传到 CIS
Start-CitrixCallHomeUpload [-Credential] <PSCredential> [-InputPath <String>] [-Description <String>] [-IncidentTime <String>] [-SRNumber <String>] [-Name <String>] [-UploadHeader <String>] [-AppendHeaders <String>] [-Collect <String>] [<CommonParameters>]
收集数据并将其保存在本地
Start-CitrixCallHomeUpload -OutputPath <String> [-InputPath <String>] [-Description <String>] [-IncidentTime <String>] [-SRNumber <String>] [-Name <String>] [-UploaderHeader <String>] [-AppendHeaders <String>] [-Collect <String>] [<CommonParameters>]
| Parameter | 描述信息 |
|---|---|
| 凭据信息 | 将上传定向到 CIS。 |
| 输入路径 | 要包含在捆绑包中的 zip 文件位置。这可能是 Citrix 支持请求的附加文件。请务必包含 .zip 扩展名。 |
| 输出路径 | 诊断信息将保存的位置。在本地保存 Call Home 数据时，此参数是必需的。 |
| 说明和事件发生时间 | 关于上传的自由格式信息。 |
| SR 编号 | Citrix 技术支持事件编号。 |
| 名称 | 标识捆绑包的名称。 |
| 上传标头 | 指定上传到 CIS 的上传标头的 JSON 格式字符串。 |
| 追加标头 | 指定上传到 CIS 的附加标头的 JSON 格式字符串。 |
| 收集 | JSON-formatted string specifying which data to collect or omit, in the form {‘collector’:{‘enabled’:Boolean}}”, where Boolean is true or false. Valid collector values are: ‘wmi’; ‘process’; ‘registry’; ‘crashreport’; ‘trace’; ‘localdata’; ‘sitedata’; ‘sfb’. By default, all collectors except ‘sfb’ are enabled. The ‘sfb’ collector is designed to be used on demand to diagnose Skype for Business issues. In addition to the ‘enabled’ parameter, the ‘sfb’ collector supports the ‘account’ and ‘accounts’ parameters to specify target users. Use one of the forms: “-Collect “{‘sfb’:{‘account’:’domain\user1’}}”; -Collect “{‘sfb’:{‘accounts’:[‘domain\user1’, ‘domain\user2’]}}” |
| 通用参数选项 | 请参阅 PowerShell 的帮助文档。 |
上传以前在本地保存的数据
Send-CitrixCallHomeBundle -Credential <PSCredential> -Path <String> [<CommonParameters>]
Path 参数指定以前保存的捆绑包的位置。
示例
以下 cmdlet 请求将 Call Home 数据（不包括来自 WMI 收集器的数据）上传到 CIS。此数据与 PVS VDA 的注册失败有关，该失败在下午 2:30 记录在 Citrix 支持案例 123456 中。除了 Call Home 数据之外，文件 “c:\Diagnostics\ExtraData.zip” 也将包含在上传的捆绑包中。
C:\PS>Start-CitrixCallHomeUpload -InputPath “c:\Diagnostics\ExtraData.zip” -Description “Registration failures with PVS VDAs” -IncidentTime “14:30” -SRNumber 123456 -Name “RegistrationFailure-021812016” -Collect “{‘wmi’:{‘enabled’:false}}” -UploadHeader “{‘key1’:’value1’}” -AppendHeaders “{‘key2’:’value2’}”
以下 cmdlet 保存与 Citrix 支持案例 223344 相关的 Call Home 数据，该案例记录于上午 8:15。数据将保存到网络共享上的 mydata.zip 文件中。除了 Call Home 数据之外，文件 “c:\Diagnostics\ExtraData.zip” 也将包含在保存的捆绑包中。
C:\PS>Start-CitrixCallHomeUpload -OutputPath \\mynetwork\myshare\mydata.zip -InputPath “c:\Diagnostics\ExtraData.zip” -Description “Diagnostics for incident number 223344” -IncidentTime “8:15” -SRNumber 223344
以下 cmdlet 上传您之前保存的数据包。
$cred=Get-Credential C:\PS>Send-CitrixCallHomeBundle –Credential $cred -Path \\mynetwork\myshare\mydata.zip
思杰 侦察
有关完整详细信息，请参阅 Citrix Scout。