对 StoreFront 进行故障排除
安装日志文件
当 StoreFront 安装或卸载时，StoreFront 安装程序会在 C:\Windows\Temp\StoreFront 目录中创建以下日志文件。文件名反映了创建它们的组件，并包含时间戳。
- Citrix-DeliveryServicesRoleManager-*.log—Created when StoreFront is installed interactively.
- Citrix-DeliveryServicesSetupConsole-*.log—Created when StoreFront is installed silently and when StoreFront is uninstalled, either interactively or silently.
- CitrixMsi-CitrixStoreFront-x64-*.log—Created when StoreFront is installed and uninstalled, either interactively or silently.
事件日志
StoreFront 支持 Windows 事件日志记录，用于身份验证服务、应用商店和 Web 版 Receiver 站点。生成的任何事件都会写入 StoreFront 应用程序日志，该日志可在事件查看器中通过 应用程序和服务日志 > Citrix Delivery Services 或 Windows 日志 > 应用程序 查看。您可以通过编辑身份验证服务、应用商店和 Web 版 Receiver 站点的配置文件来控制单个事件的重复日志条目数量。
日志节流
-
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。日志文件名包含命令操作和主题，以及可用于区分命令序列的时间戳。
诊断日志记录
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-->这将为所有服务启用“详细”日志记录，而无需提示确认。输入此命令后，它会重新启动 StoreFront 服务。等待 PowerShell 提示符返回以验证服务是否已完成重新启动。在这些服务重新启动期间，用户将无法访问 StoreFront 服务器。
-
重现问题以生成日志。
-
将所有服务的日志记录级别设置回默认级别
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False <!--NeedCopy-->
您可以进一步自定义诊断日志记录：
-
StoreFront 为每个服务写入一个单独的日志文件。默认情况下，每个日志文件最大为 200MB，并且 StoreFront 在清除旧日志文件之前为每个服务写入最多五个日志文件。如果您需要自定义写入的日志大小或数量，可以使用
-FileSizeKb和-FileCount参数来完成。 -
使用
-TraceLevel更改记录的详细信息级别。允许的值为Off、Error、Warning、Info或Verbose。 -
使用参数
-All设置所有服务的日志记录参数。您可以使用-Service [Service name]为单个服务自定义日志记录。
For more information on the Set-STFDiagnostics cmdlet, see the StoreFront PowerShell SDK documentation.
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 <!--NeedCopy-->
注意：
有关在您的环境中将 ICA 文件用于故障排除以外的任何目的的更多详细信息，请参阅 CTX200126。