StoreFront 产品的故障排除
安装过程日志
安装或卸载 StoreFront 时，StoreFront 安装程序会在 C:\Windows\Temp\StoreFront 目录中创建以下日志文件。文件名反映了创建它们组件并包含时间戳。
- Citrix-DeliveryServicesRoleManager-*.log——此日志文件是在用户通过交互式安装程序安装 StoreFront 应用程序或服务时自动创建和记录的。
- Citrix-DeliveryServicesSetupConsole-\*.log—此日志文件在 StoreFront 进行静默安装时生成，并在其以交互方式或静默方式卸载时生成。
- CitrixMsi-CitrixStoreFront-x64-\*.log—此日志文件在 StoreFront 安装时生成，并在其卸载时（无论是交互式还是静默方式）生成。
事件日志
StoreFront 支持对身份验证服务、应用商店和 Receiver for Web 站点进行 Windows 事件日志记录。生成的任何事件都将写入 StoreFront 应用程序日志，可以使用事件查看器在“应用程序和服务日志 > Citrix Delivery Services”或“Windows 日志 > 应用程序”下查看。您可以通过编辑身份验证服务、应用商店和 Receiver for Web 站点的配置文件来控制单个事件的重复日志条目数量。
日志限制
-
Use a text editor to open the web.config file for the authentication service, store, or Receiver for Web site, which are typically located in the C:\inetpub\wwwroot\Citrix\Authentication\, C:\inetpub\wwwroot\Citrix\storename\, and C:\inetpub\wwwroot\Citrix\storenameWeb\ directories, respectively, where storename is the name specified for the store when it was created.
-
在文件中找到以下元素。
<logger duplicateInterval="00:01:00" duplicateLimit="10">默认情况下，StoreFront 配置为将重复日志条目的数量限制为每分钟 10 个。
-
更改 duplicateInterval 属性的值以设置监控重复日志条目的时间段（以小时、分钟和秒为单位）。使用 duplicateLimit 属性设置在指定时间间隔内必须记录的重复条目数，以触发日志限制。
触发日志限制时，将记录一条警告消息，指示将抑制后续相同的日志条目。一旦时间限制到期，正常日志记录将恢复，并记录一条信息性消息，指示不再抑制重复日志条目。
PowerShell 和管理控制台日志
通过 PowerShell 或管理控制台进行的配置更改会记录在 C:\Program Files\Citrix\Receiver StoreFront\Admin\logs。日志文件名包含命令操作和主题，以及可用于区分命令序列的时间戳。
诊断日志记录
以前，诊断日志记录默认只记录错误。
从 2203 LTSR CU5 版本开始，默认情况下会记录 错误、警告 和 信息 级别的消息。在大多数情况下，这包含足够的信息来诊断任何问题。
要启用跟踪日志记录，请使用具有本地管理员权限的帐户启动 Windows PowerShell，并使用命令 Set-STFDiagnostics 以及以下参数：
- -All。一个标志，指示应更新所有实例和服务的跟踪。
- -TraceLevel。跟踪详细信息级别递增，-TraceLevel 允许的值为：Off、Error、Warning、Info 或 Verbose。由于可能生成大量数据，跟踪可能会显著影响 StoreFront 的性能。除非故障排除特别需要，否则不建议使用 Info 或 Verbose 级别。
可选参数：
- -FileSizeKb。跟踪文件大小（以 KB 为单位）。
- -FileCount。磁盘上同时维护的跟踪文件数。
- -confirm:$False. Suppresses Windows prompts to allow the StoreFront cmdlet to run each time.
跟踪输出发送到 c:\Program Files\Citrix\Receiver StoreFront\admin\trace
示例
为所有服务启用详细级别跟踪以进行调试：
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False
<!--NeedCopy-->
要禁用详细级别跟踪，并将所有服务的跟踪级别设置回默认值：
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False
<!--NeedCopy-->
For more information on the Set-STFDiagnostics cmdlet, see the StoreFront PowerShell SDK documentation.
Launch.ica 文件日志记录
当用户启动应用程序或桌面时，StoreFront 会生成一个名为 launch.ica 的文件，Workspace 应用程序会读取该文件以确定如何连接到应用程序或桌面。根据配置，此文件可能存储在内存中，因此无法直接访问。要诊断启动错误，查看 launch.ica 的内容会很有用。
要启用 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=”日志文件路径”
- 记录ICA文件=启用
例如：
LogFile=C:\ica\ica.log LogICAFile=true <!--NeedCopy-->
注意：
有关在您的环境中将 ICA 文件用于故障排除以外的任何目的的更多信息，请参阅 CTX200126。