-
-
-
配置日志记录
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
配置日志
注意：
无论您为 Citrix Cloud 帐户选择何种语言，配置日志记录仅以英文显示。与这些记录关联的日期和时间采用 MM/DD/YY 格式，并以协调世界时 (UTC) 表示。
-
配置日志记录是一项功能，可捕获 Citrix Virtual Apps and Desktops™ 和 Citrix DaaS（以前称为 Citrix Virtual Apps and Desktops 服务）部署配置更改和管理活动到 Citrix Cloud 中的日志记录数据库。您可以使用记录的内容来：
- 在进行配置更改后诊断和解决问题。日志提供了一个线索。
- 协助变更管理和跟踪配置。
- 报告管理活动。
在此 Citrix DaaS™ 中，配置日志记录始终处于启用状态。您无法禁用它。
在 Studio 中，您可以按日期范围或通过全文搜索来查看配置日志内容。您还可以使用 PowerShell 生成 CSV 报告。在此控制台中，您无法编辑或删除日志内容。您可以使用 Remote PowerShell SDK 安排从日志中定期删除数据。
为了保持 DaaS 租户的性能，从 2024 年 9 月 9 日起，配置日志保留期将设置为 180 天。
- 2024 年 9 月 9 日，超过 180 天的日志将被删除。随着我们不断增加单个 DaaS 租户的 DaaS 限制，此实施可确保为我们的客户提供最佳性能和弹性。
作为最佳实践，我们建议客户采用季度导出机制。这可以通过 PowerShell 完成，请参阅生成报告。我们还建议客户安排定期删除数据，请参阅安排定期数据删除。
所需权限（请参阅委派管理）：
- Citrix Cloud™ 中的完全管理员，以及 Citrix DaaS 云管理员和只读管理员可以在 Studio 中查看配置日志。
-
完全管理员和云管理员还可以使用 PowerShell 下载日志记录活动的 CSV 报告。
-
记录的内容
记录以下操作：
- 从 Manage（管理）部分和 Monitor（监视器）节点启动的配置更改和管理活动
- PowerShell 脚本
- REST API 请求
注意：
您无法看到 Citrix Cloud 平台内部操作的日志条目，例如数据库设置和管理。
记录的配置更改示例包括处理（创建、编辑、删除、分配）：
- 计算机目录
- 交付组（包括更改电源管理设置）
- 管理员角色和范围
- 主机资源和连接
- 通过 Studio 的 Citrix® 策略
记录的管理更改示例包括：
- 虚拟机或用户桌面的电源管理
- 管理或监视功能向用户发送消息
以下操作未记录。（其中许多操作不适用于客户管理员。）
- 自动操作，例如池管理虚拟机的开机。
- 通过组策略管理控制台 (GPMC) 实施的策略操作。使用 Microsoft 工具查看这些操作的日志。
-
通过注册表或 Studio、Monitor 或 PowerShell 以外的来源进行的更改。
-
查看配置日志内容
要查看配置日志内容，请按照以下步骤操作：
- 登录到 Citrix Cloud。
- 在 DaaS 磁贴中，单击 Manage（管理）。
-
- 在左侧窗格中选择 Logging（日志记录），然后单击 Events（事件）选项卡。
-
默认情况下，事件日志按管理员名称列出。您可以根据需要执行以下任务：
- 排序显示。 通过单击列标题对显示进行排序。
- 筛选日志。 通过设置筛选条件（例如天数间隔或自定义周期）或在“搜索”框中输入完整或部分主任务名称来优化显示。使用搜索后要返回标准显示，请清除“搜索”框中的文本。
- 导出日志。 将选定日志或所有日志导出到 CSV 文件以进行存档或进一步分析。
- 自定义列。 通过添加非默认列（例如“客户端 IP”和“标签”）来根据您的需要调整显示。
-
管理标签。 添加、编辑和删除事件日志的标签，以增强日志组织和跟踪。
-
显示特征：
- 在管理和监视期间创建的高级操作列在中间上方窗格中。高级操作会导致一个或多个服务和 PowerShell SDK 调用，这些是低级操作。当您在中间上方窗格中选择高级操作时，下方窗格将显示低级操作。
- 如果您在 PowerShell 中创建低级操作而未指定父高级操作，则配置日志记录会创建一个替代高级操作。
- 如果操作在完成之前失败，则日志操作可能未在数据库中完成。例如，开始记录没有相应的停止记录。在这种情况下，日志指示信息缺失。当您根据时间范围显示日志时，如果日志中的数据与条件匹配，则会显示不完整的日志。例如，如果您请求过去五天的日志，并且过去五天内开始时间没有结束时间的日志，则会包含该日志。
- 请记住：您无法看到 Citrix Cloud 平台内部操作的日志条目，例如数据库设置和管理。
查看与计算机目录操作相关的任务
-
要查看与计算机目录操作相关的任务，请导航到 Logging > Tasks（日志记录 > 任务）。Tasks（任务）选项卡仅显示与通过 Machine Creation Services™ (MCS) 或 Provisioning Services (PVS) 创建的目录相关的任务。具体来说，将显示与以下计算机目录操作相关的任务：
- 创建目录
- 克隆目录
- 添加计算机
- 删除计算机
- 更新目录（更新映像或计算机）
- 回滚计算机更新
提示：
Tasks（任务）选项卡仅显示与预配方案更改（创建或修改预配方案）相关的任务。
任务可以处于以下状态：
- 已完成
- 未开始
- 正在运行
- 已取消
- 失败
- 未知
要取消正在运行的任务，请选择该任务，然后单击 Cancel（取消）。取消操作需要一些时间才能完成。
记录的任务示例包括：
- 某个目录的映像更新已完成
- 更新某个目录的映像时出错
- 某个目录的映像更新已取消
- 将 VM 预配到某个目录
- 从某个目录中删除 VM
- 已创建某个目录
默认情况下，中心窗格中的显示按时间顺序（最新条目优先）列出已记录的任务，并按日期分隔。您可以通过列标题对显示进行排序。要清除已完成的任务，请在 Tasks（任务）选项卡下单击 Clear Completed Tasks（清除已完成的任务）。要选择要在显示中显示的列，请选择表格右上角的 Columns to Display（要显示的列）图标。
请注意以下事项：
- 注销控制台后，REST API 日志将被清除。（如果刷新浏览器窗口，它们也会被清除。）
- 控制台中导致 API 调用的任何操作，其相应的 API 请求都会显示在 APIs 选项卡上。
- 显示按时间顺序（最新条目在前）列出 API 请求，并按日期分隔。显示中 API 请求的最大数量为 1,000。
查看 PowerShell 日志
- 要查看与您当天执行的 UI 操作相对应的 PowerShell 命令，请导航到 Logging > PowerShell 选项卡。
将元数据与配置日志关联
- 您可以通过将名为
MetadataMap的name-value对与日志记录关联，从而将元数据附加到配置日志。
注意：
您只能将元数据附加到高级操作对象。
元数据与执行时存在的记录相关联。
设置元数据
运行 PowerShell 命令 Set-LogHighLevelOperationMetadata 以将日志记录与 MetadataMap 关联。
Set-LogHighLevelOperationMetadata 采用以下参数：
- Id：高级操作的 ID。
-
InputObject：要添加元数据的高级操作。这是
Id参数的替代方法，其中高级操作对象或对象列表将传递给 PowerShell 命令。 -
Name：要添加的元数据的属性名称。该属性对于指定的高级操作必须是唯一的。该属性不能包含以下任何字符：
()\/;:#.*?=<>|[]"' - Value：属性的值。
-
Map：属性的（名称、值）对字典。这是使用
-Name和-Value参数设置元数据的替代方法。
例如，要将元数据附加到所有 ID 为 40 的高级日志记录，请运行以下 PowerShell 命令：
Get-LogHighLevelOperation – Id 40 | Set-LogHighLevelOperationMetadata -Name A -Value B
要将元数据附加到用户为 abc@example.com 的高级记录，请运行以下 PowerShell 命令：
Get-LogHighLevelOperation – User `abc@example.com` | Set-LogHighLevelOperationMetadata -Name C -Value D
使用元数据检索
运行以下 PowerShell 命令以使用关联的元数据检索日志记录：
-
按键和值搜索：
Get-LogHighLevelOperation -Metadata "Key:Value" -
按值和任意键搜索：
Get-LogHighLevelOperation -Metadata "*:Value" -
按键和任意值搜索：
Get-LogHighLevelOperation -Metadata "Key:*"
移除元数据
运行 PowerShell 命令 Remove-LogHighLevelOperationMetadata 以移除关联的元数据。
Remove-LogHighLevelOperationMetadata 采用以下参数：
- Id：高级操作的 ID。
-
InputObject：要添加元数据的高级操作。这是
Id参数的替代方法，其中高级操作对象或对象列表将传递给 PowerShell 命令。 - Name：要移除的元数据的属性名称。设置为 $null 以移除指定对象的所有元数据。
- Map：属性的（名称、值）对字典。这可以是哈希表（使用 @{“name1” = “val1”; “name2” = “val2”} 创建）或字符串字典（使用 new-object “System.Collections.Generic.Dictionary[String, String]” 创建）。名称与映射中的键匹配的属性将被移除。
生成报告
要生成包含配置日志数据的 CSV 或 HTML 报告，请使用 Citrix Virtual Apps and Desktops Remote PowerShell SDK 中 ConfigLogging Service 的 PowerShell cmdlet。有关详细信息，请参阅：
安排定期数据删除
使用 Remote PowerShell SDK 指定数据在配置日志记录数据库中保留多长时间。（此功能在 Studio 中不可用。）在 Citrix DaaS 中，您必须拥有完全访问权限。
在 Set-LogSite cmdlet 中，-LoggingDBPurgeDurationDays 参数指定数据在配置日志记录数据库中保留多少天后自动删除。
- 默认情况下，此参数的值为 0。零值表示配置日志记录数据库中的数据永远不会自动删除。
- 当您设置非零值时，数据库每 120 分钟检查一次。早于保留期的数据将被删除。
使用 Get-LogSite 查看参数的当前值。
与本地 Citrix Virtual Apps and Desktops 的区别
如果您熟悉本地 Virtual Apps and Desktops 产品中的配置日志记录，则 Citrix Cloud 版本有几个不同之处。在 Citrix Cloud 中：
- 配置日志记录始终启用。您无法禁用它。强制日志记录不可用。
- 您无法更改配置日志记录数据库的位置，因为该数据库在 Citrix Cloud 平台中进行管理。
- 配置日志显示不包括在 Citrix Cloud 平台中执行的操作和活动。
- PowerShell 是您创建已记录操作的 CSV 或 HTML 报告的唯一选择。在本地产品中，可以从 Citrix Studio 或 PowerShell 生成报告。
- 您无法删除配置日志内容。
共享
共享
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.