故障排除 StoreFront
安装日志
安装或卸载 StoreFront 时，StoreFront 安装程序会在 C:\Windows\Temp\StoreFront 目录中创建以下日志文件。文件名反映了创建它们的组件并包含时间戳。
-
Citrix-DeliveryServicesRoleManager-*.log—在交互式安装 StoreFront 时创建。
-
Citrix-DeliveryServicesSetupConsole-*.log—在静默安装 StoreFront 时以及在交互式或静默卸载 StoreFront 时创建。
-
CitrixMsi-CitrixStoreFront-x64-*.log—在交互式或静默安装和卸载 StoreFront 时创建。
事件日志
StoreFront 支持对身份验证服务、应用商店和 Receiver for Web 站点进行 Windows 事件日志记录。生成的任何事件都将写入 StoreFront 应用程序日志中，可以使用事件查看器在“应用程序和服务日志 > Citrix Delivery Services”或“Windows 日志 > 应用程序”下查看该日志。您可以通过编辑身份验证服务、应用商店和 Receiver for Web 站点的配置文件来控制单个事件的重复日志条目数量。
日志节流
-
使用文本编辑器打开身份验证服务、应用商店或 Receiver for Web 站点的 web.config 文件，这些文件通常分别位于 C:\inetpub\wwwroot\Citrix\Authentication\、C:\inetpub\wwwroot\Citrix\storename\ 和 C:\inetpub\wwwroot\Citrix\storenameWeb\ 目录中，其中 storename 是创建应用商店时为其指定的名称。
-
在文件中找到以下元素。
<logger duplicateInterval="00:01:00" duplicateLimit="10">默认情况下，StoreFront 配置为将每分钟的重复日志条目数限制为 10 个。 -
更改 duplicateInterval 属性的值，以设置监视重复日志条目的时间段（以小时、分钟和秒为单位）。使用 duplicateLimit 属性设置在指定时间间隔内必须记录的重复条目数，以触发日志节流。
当触发日志节流时，将记录一条警告消息，指示后续相同的日志条目将被抑制。一旦时间限制到期，正常日志记录将恢复，并记录一条信息性消息，指示重复日志条目不再被抑制。
PowerShell 和管理控制台日志
通过 PowerShell 或管理控制台进行的配置更改会记录在
C:\Program Files\Citrix\Receiver StoreFront\Admin\logs。日志文件名包含命令操作和主题，以及可用于区分命令序列的时间戳。
诊断日志记录
StoreFront 将诊断日志写入
c:\Program Files\Citrix\Receiver StoreFront\admin\trace
默认情况下，会记录 Error、Warning 和 Info 级别的消息。在大多数情况下，这包含足够的信息来诊断任何问题。
您可以为故障排除目的启用额外的详细日志记录。仅当 Citrix® 支持部门要求时才需要这样做。这可能会影响性能，因此在故障排除完成后，您应该将
TraceLevel 恢复为 Info。
要启用详细日志记录：
-
使用具有本地管理员权限的帐户启动 Windows PowerShell
-
输入命令：
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False这将为所有服务启用“详细”日志记录，而无需提示确认。输入此命令后，它会重新启动 StoreFront 服务。等待 PowerShell 提示符返回以验证服务是否已完成重新启动。在这些服务重新启动期间，用户将无法访问 StoreFront 服务器。 -
重现问题以生成日志。
-
将所有服务的日志记录级别设置回默认值
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False
您可以进一步自定义诊断日志记录：
-
StoreFront 为每个服务写入单独的日志文件。默认情况下，每个日志文件最大为 200MB，StoreFront 在清除旧日志文件之前为每个服务写入最多五个日志文件。如果需要自定义写入的日志大小或数量，可以使用
-FileSizeKb和-FileCount参数进行操作。 -
使用
-TraceLevel更改记录的详细信息级别。允许的值为Off、Error、Warning、Info或Verbose。 -
使用参数
-All设置所有服务的日志记录参数。您可以使用-Service [Service name]为单个服务自定义日志记录。
有关
Set-STFDiagnostics cmdlet 的更多信息，请参阅 StoreFront PowerShell SDK 文档。
Launch.ica 文件日志记录
当用户启动应用程序或桌面时，StoreFront 会生成一个名为 launch.ica 的文件，Workspace 应用程序会读取该文件以确定如何连接到应用程序或桌面。根据配置，此文件可能存储在内存中，因此无法直接访问。要诊断启动错误，查看 launch.ica 的内容会很有用。
要在客户端 PC 上启用 launch.ica 文件的日志记录，请完成以下步骤：
-
使用注册表编辑器导航到以下注册表项：32 位系统：
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging64 位系统：HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging -
设置以下两个字符串键值：
-
LogFile="日志文件路径"
-
LogICAFile=true
例如：LogFile=C:\ica\ica.log
LogICAFile=true -
注意：
有关在您的环境中使用 ICA 文件（非故障排除目的）的更多信息，请参阅 CTX200126。