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 <!--NeedCopy-->这会为所有服务启用“Verbose”(详细)日志记录,而无需确认提示。输入此命令后,它会重新启动 StoreFront 服务。请等待 PowerShell 提示符返回,以验证服务是否已完成重新启动。在这些服务重新启动期间,用户将无法访问 StoreFront 服务器。
-
重现问题以创建日志。
-
将所有服务的日志记录设置回默认级别
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False <!--NeedCopy-->
您可以进一步自定义诊断日志记录:
-
StoreFront 为每个服务写入一个单独的日志文件。默认情况下,每个日志文件最大为 200 MB,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="path to the log file"LogICAFile=true
例如:
LogFile=C:\ica\ica.log LogICAFile=true <!--NeedCopy-->
注意:
有关在您的环境中将 ICA 文件用于故障排除以外的任何用途的更多详细信息,请参阅 CTX200126。