Citrix Virtual Apps and Desktops 服务

配置日志记录

注意:

无论您为 Citrix Cloud 帐户选择哪种语言,配置日志内容都仅以英文显示。

配置日志记录是一项用于将 Citrix Virtual Apps and Desktops 部署配置更改和管理活动捕获到 Citrix Cloud 中的日志记录数据库的功能。您可以使用记录的内容进行以下操作:

  • 在发生配置更改后诊断问题并进行故障排除。日志提供浏览路径记录。
  • 协助更改管理和跟踪配置。
  • 报告管理活动。

在此 Citrix Cloud 服务中,始终启用配置日志记录。您无法将其禁用。

在“完整配置”管理界面中,您可以查看按日期范围或全文搜索筛选的配置日志内容。还可以使用 PowerShell 生成 CSV 报告。在此控制台中,您无法编辑或删除日志内容。可以使用远程 PowerShell SDK 安排从日志中定期删除数据。

配置日志会在创建时进行本地化。例如,用英语创建的日志将以英语显示,而无论阅读器的区域设置为何。

所需权限(请参阅委派管理):

  • Citrix Cloud 中的完全权限管理员以及 Citrix Virtual Apps and Desktops 服务云管理员和只读权限管理员可以在管理 (Studio) 控制台中查看配置日志。
  • 完全权限管理员和云管理员还可以使用 PowerShell 下载日志记录活动的 CSV 报告。

记录的内容

将记录以下操作:

  • 管理监视选项卡启动的配置更改和管理活动
  • PowerShell 脚本
  • REST API 请求

注意:

您无法看到 Citrix Cloud 平台内部操作(例如数据库设置和管理)的日志条目。

记录的配置更改包括对以下项目的处理(创建、编辑、删除和分配):

  • 计算机目录
  • 交付组(包括更改电源管理设置)
  • 管理员角色和作用域
  • 主机资源和连接
  • 通过管理控制台执行的 Citrix 策略

记录的管理更改示例包括:

  • 虚拟机或用户桌面的电源管理
  • 管理或监视向用户发送消息的功能

以下操作不在记录范围之内。(许多功能对客户管理员不可用。)

  • 自动操作,如虚拟机的池管理启动。
  • 通过组策略管理控制台 (GPMC) 实施的策略操作。使用 Microsoft 工具可查看这些操作的日志。
  • 通过注册表或从“完整配置”管理界面、Monitor 或 PowerShell 以外的其他源所做的更改。

查看配置日志内容

要查看配置日志内容,请执行以下步骤:

  1. 登录到 Citrix Cloud。在左上角菜单中,选择我的服务 > Virtual Apps and Desktops
  2. 管理 > 完整配置中,选择左侧窗格中的日志记录 > 事件

默认情况下,在中心窗格显示的内容会按时间顺序列出日志内容(最新的条目在最前面),并按日期进行分隔。您可以:

  • 按列标题对显示的内容进行排序。
  • 通过指定一个一天的时间间隔,或者在搜索框中输入文本,对显示的内容进行过滤。要在使用搜索后返回到标准显示,请清除搜索框中的文本。

显示特性:

  • 在中上部窗格中列出了管理和监视期间创建的高级别操作。高级别操作会导致出现一个或多个服务和 PowerShell SDK 调用,这些是低级别操作。在中上部窗格中选择一项高级别操作时,下部的窗格将显示低级别操作。
  • 如果您在 PowerShell 中创建了一项低级别操作,但未指定高级别父操作,配置日志记录将创建替代的高级别操作。
  • 如果操作在完成之前失败,可能无法在数据库中完成日志操作。例如,开始记录没有对应的停止记录在这种情况下,日志会指出缺少信息。在基于时间范围显示日志时,如果不完整日志中的数据符合条件,则会显示这些不完整的日志。例如,如果您请求过去五天的日志,并且开始时间在过去五天内的某个日期没有结束时间,则会包括该日志。
  • 谨记:您无法看到 Citrix Cloud 平台内部操作(例如数据库设置和管理)的日志条目。

查看与计算机目录操作有关的任务

要查看与计算机目录操作相关的任务,请导航到管理 > 完整配置 > 日志记录 > 任务任务选项卡仅显示与通过 Machine Creation Services (MCS) 或 Provisioning Services (PVS) 创建的目录相关的任务。具体而言,将显示与以下计算机目录操作关联的任务:

  • 创建目录
  • 克隆目录
  • 添加计算机
  • 删除计算机
  • 更新目录(更新映像或计算机)
  • 回滚计算机更新

提示:

任务选项卡仅显示与预配方案更改(创建或修改预配方案)相关的任务。

任务可以处于以下状态:

  • 已完成
  • 未启动
  • 正在运行
  • 已取消
  • 失败
  • 未知

要取消正在运行的任务,请选择该任务,然后单击取消。取消需要一些时间才能完成。

记录的任务的示例包括:

  • 特定目录的映像更新已完成
  • 更新特定目录的映像时出错
  • 已取消特定目录的映像更新
  • 将 VM 预配到特定目录
  • 从特定目录中删除 VM
  • 创建了特定目录

默认情况下,在中心窗格中显示的内容会按时间顺序列出记录的任务(最新的条目在最前面),并按日期进行分隔。可以按列标题对显示的内容进行排序。要清除已完成的任务,请单击任务选项卡下的清除已完成的任务

查看 API 日志

要查看 REST API 日志,请导航到管理 > 完整配置 > 日志记录 > APIAPI 选项卡显示在特定时间段内发出的 REST API 请求。

请注意以下事项:

  • 注销控制台后,将清除 REST API 日志。(如果刷新浏览器窗口,它们也会被清除。)
  • 控制台中导致 API 调用的任何操作都将在 API 选项卡上显示相应的 API 请求。
  • 该显示屏幕按时间顺序列出 API 请求(首先显示最新条目),并按日期分隔。显示屏幕中的最大 API 请求数为 1000 个。

生成报告

要生成包含配置日志数据的 CSV 或 HTML 报告,请在 Citrix Virtual Apps and Desktops 远程 PowerShell SDK 中对 ConfigLogging Service 的 PowerShell cmdlet。有关详细信息,请参阅:

计划定期删除数据

使用远程 PowerShell SDK 可指定在配置日志记录数据库中保留数据的时间。(此功能在“完整配置”管理界面中不可用。)在 Citrix Virtual Apps and Desktops 服务中,您必须具有完全访问权限。

Set-LogSite cmdlet 中,-LoggingDBPurgeDurationDays 参数指定配置日志记录数据库中的数据在自动删除之前保留的天数数据。

  • 默认情况下,此参数的值为 0。值 0 表示永远不会自动删除配置日志记录数据库中的数据。
  • 设置了非零值时,将每隔 120 分钟检查一次数据库。早于保留期限的数据将被删除。

使用 Get-LogSite 可查看参数的当前值。

与本地 Citrix Virtual Apps and Desktops 的区别

如果您熟悉本地 Virtual Apps and Desktops 产品中的配置日志记录,则会发现 Citrix Cloud 版本有几个不同之处。在 Citrix Cloud 中:

  • 配置日志记录始终处于启用状态。您无法将其禁用。强制日志记录不可用。
  • 您无法更改配置日志记录数据库的位置,因为该数据库在 Citrix Cloud 平台中进行管理。
  • 配置日志显示不包括在 Citrix Cloud 平台中执行的操作和活动。
  • 只能使用 PowerShell cmdlet 创建记录的操作的 CSV 或 HTML 报告。在本地产品中,可以从 Studio 或 PowerShell 生成报告。
  • 无法删除配置日志内容。
配置日志记录