故障排除 StoreFront

Last published : Nov 13, 2026

安装日志

安装或卸载 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 站点的配置文件来控制单个事件的重复日志条目数量。

日志限制

  1. 使用文本编辑器打开身份验证服务、应用商店或 Receiver for Web 站点的 web.config 文件，这些文件通常分别位于 C:\inetpub\wwwroot\Citrix\Authentication\、C:\inetpub\wwwroot\Citrix\storename\ 和 C:\inetpub\wwwroot\Citrix\storenameWeb\ 目录中，其中 storename 是创建应用商店时指定的名称。
  2. 在文件中找到以下元素。
    <logger duplicateInterval="00:01:00" duplicateLimit="10">
    默认情况下，StoreFront 配置为将每分钟的重复日志条目数限制为 10 个。
  3. 更改 duplicateInterval 属性的值以设置监视重复日志条目的时间段（以小时、分钟和秒为单位）。使用 duplicateLimit 属性设置在指定时间间隔内必须记录的重复条目数，以触发日志限制。
触发日志限制时，将记录一条警告消息，指示将抑制进一步的相同日志条目。时间限制结束后，正常日志记录将恢复，并记录一条信息性消息，指示不再抑制重复日志条目。

PowerShell 和管理控制台日志

通过 PowerShell 或管理控制台进行的配置更改会记录在 C:\Program Files\Citrix\Receiver StoreFront\Admin\logs。日志文件名包含命令操作和主题，以及可用于区分命令序列的时间戳。

诊断日志记录

以前，诊断日志记录默认只记录错误。
从 2203 LTSR CU5 版本开始，默认情况下会记录 Error、Warning 和 Info 级别的消息。在大多数情况下，这包含足够的信息来诊断任何问题。
要启用跟踪日志记录，请使用具有本地管理员权限的帐户启动 Windows PowerShell，并使用命令 Set-STFDiagnostics 以及以下参数：
  • -All。一个标志，指示应为所有实例和服务更新跟踪。
  • -TraceLevel。跟踪详细信息级别递增，-TraceLevel 允许的值为：Off、Error、Warning、Info 或 Verbose。由于可能生成大量数据，跟踪可能会显著影响 StoreFront 的性能。除非故障排除特别需要，否则不建议使用 Info 或 Verbose 级别。
可选参数：
  • -FileSizeKb。跟踪文件大小（以 KB 为单位）。
  • -FileCount。磁盘上同时维护的跟踪文件数量。
  • -confirm:$False。禁止 Windows 提示，以允许 StoreFront cmdlet 每次都运行。
跟踪输出发送到 c:\Program Files\Citrix\Receiver StoreFront\admin\trace
跟踪输出

示例

要为所有服务启用 Verbose 级别跟踪以进行调试：
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False
要禁用 Verbose 级别跟踪，并将所有服务的跟踪级别设置回默认值：
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False
有关 Set-STFDiagnostics cmdlet 的更多信息，请参阅 StoreFront PowerShell SDK 文档。

Launch.ica 文件日志记录

当用户启动应用程序或桌面时，StoreFront 会生成一个名为 launch.ica 的文件，Workspace 应用程序会读取该文件以确定如何连接到应用程序或桌面。根据配置，此文件可能存储在内存中，因此无法直接访问。为了诊断启动错误，查看 launch.ica 的内容会很有用。
要启用 launch.ica 文件的日志记录，请完成以下步骤：
  1. 使用注册表编辑器导航到以下注册表项：
    32 位系统：HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging
    64 位系统：HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging
  2. 设置以下两个字符串键值：
    • LogFile="日志文件路径"
    • 记录ICA文件=真
    例如：
    LogFile=C:\ica\ica.log
    LogICAFile=true
注意：
有关在您的环境中将 ICA 文件用于故障排除以外的任何目的的更多详细信息，请参阅 CTX200126。