配置日志记录
配置日志记录是一种将站点配置更改和管理活动捕捉到数据库的功能。该特性默认启用。您可以使用已记录的内容:
- 在配置更改后诊断和排除问题。日志提供了面包屑线索。
- 协助变更管理和跟踪配置。
- 报告管理活动。
您可以设置配置日志首选项,显示配置日志,并从Citrix Studio生成HTML和CSV报告。您可以根据日期范围和全文搜索结果过滤配置日志显示。启用强制日志记录时,除非可以记录配置更改,否则将阻止进行配置更改。通过适当的权限,您可以从配置日志中删除条目。不能使用配置日志功能编辑日志内容。
配置日志使用PowerShell SDK和配置日志服务。配置日志服务运行在站点中的每个控制器上。如果一个控制器出现故障,另一个控制器上的服务将自动处理日志记录请求。
默认情况下,配置日志记录功能已启用,并使用创建站点时创建的数据库(站点配置数据库)。您可以为数据库指定不同的位置。配置日志数据库支持与站点配置数据库相同的高可用性特性。
通过委托管理控制对配置日志的访问,并具有“编辑日志首选项”和“查看配置日志”权限。
配置日志在创建时进行本地化。例如,用英语创建的日志将以英语读取,而不管读取器的语言环境如何。
记录了什么
记录从Studio、Director和PowerShell脚本发起的配置更改和管理活动。记录配置更改的例子包括:创建、编辑、删除分配:
- 机目录
- 交付组(包括更改电源管理设置)
- 管理员角色和范围
- 主机资源和连接
- Citrix通过Studio制定政策
记录管理更改的示例包括:
- 虚拟机或用户桌面的电源管理
- 工作室或导演向用户发送消息
以下操作不会记录日志:
- 支持虚拟机池管理、上电等自主操作。
- 通过组策略管理控制台(GPMC)实现的策略操作;使用微软工具查看这些操作的日志。
- 通过注册表、直接访问数据库或从Studio、Director或PowerShell以外的源进行的更改。
- 初始化部署后,当第一个配置日志服务实例向配置服务注册时,配置日志记录就可用了。因此,不记录配置的早期阶段(例如,当获得并应用数据库模式时,当初始化管理程序时)。
管理配置日志
默认情况下,配置日志记录使用创建站点时创建的数据库(也称为站点配置数据库)。出于以下原因,Citrix建议您为配置日志数据库(和监视数据库)使用单独的位置:
- 配置日志数据库的备份策略可能与站点配置数据库的备份策略不同。
- 为配置日志记录(和监视服务)收集的数据量可能会对站点配置数据库的可用空间产生不利影响。
- 它分离了三个数据库的单故障点。
不支持配置日志记录的产品版本在Studio中没有logging节点。
启用和禁用配置日志和强制日志
缺省情况下,配置日志记录是启用的,强制日志记录是禁用的。
- 选择日志记录在Studio导航窗格中。
- 选择首选项在操作窗格中。配置日志对话框包含数据库信息,并指示是否启用或禁用配置日志和强制日志。
选择所需的操作:
要启用配置日志记录,请选择启用.这是默认设置。如果无法写入数据库,则日志信息将被丢弃,但操作将继续进行。
若要禁用配置日志记录,请选择禁用.如果之前启用了日志记录,那么PowerShell SDK仍然可以读取现有日志。
若要启用强制日志记录,请选择当数据库不可用时,防止更改站点配置.不允许正常记录的配置更改或管理活动,除非可以将其写入配置日志数据库。只有当配置日志被启用时(当启用被选中)。如果Configuration Logging Service失败,并且没有使用高可用性,则假定必须进行日志记录。在这种情况下,通常会被记录的操作不会被执行。
若要禁用强制日志记录,请选择当数据库不可用时,允许更改站点配置.即使不能访问配置日志数据库,也允许进行配置更改和管理活动。这是默认设置。
更改配置日志数据库位置
在启用强制日志记录时,不能更改数据库位置,因为位置更改包括一个不能记录的短暂断开连接间隔。
- 使用受支持的SQL server版本创建数据库服务器。
- 选择日志记录在Studio导航窗格中。
- 选择首选项在操作窗格中。
- 在“Logging Preferences”对话框中,选择更改日志数据库.
- 在“更改日志数据库”对话框中,指定包含新数据库服务器的服务器的位置。看到数据库地址格式对于有效的格式。
- 要允许Studio创建数据库,请单击好吧.出现提示时,单击好吧,并自动创建数据库。Studio尝试使用当前Studio用户的凭据访问数据库。如果失败,系统将提示您输入数据库用户的凭据。然后Studio将数据库模式上传到数据库。(仅在数据库创建期间保留凭据。)
- 如需手动创建数据库,请单击生成数据库脚本.生成的脚本包括手动创建数据库的说明。在上传模式之前,确保数据库为空,并且至少有一个用户拥有访问和修改数据库的权限。
前一个数据库中的配置日志记录数据没有导入到新数据库中。在检索日志时,不能从两个数据库聚合日志。新配置日志数据库中的第一个日志条目表明发生了数据库更改,但它没有标识之前的数据库。
显示配置日志内容
当启动配置更改和管理活动时,Studio和Director创建的高级操作将列在Studio的中上窗格中。高级操作导致一个或多个服务和SDK调用,这些都是低级操作。在上窗格中选择高级操作时,下窗格将显示低级操作。
如果操作在完成前失败,则数据库中的日志操作可能无法完成。例如,一个开始记录将没有相应的停止记录。在这种情况下,日志表明缺少信息。按时间范围显示日志时,如果日志中的数据符合条件,则显示不完整的日志。例如,如果请求最近5天的所有日志,并且有一个日志的开始时间是最近5天,但没有结束时间,则包含该日志。
在使用调用PowerShell cmdlets的脚本时,如果创建了低级操作而没有指定父级高级操作,则配置日志记录将创建代理级高级操作。
选中,显示配置日志内容日志记录在Studio导航窗格中。默认情况下,中心窗格按时间顺序列出日志内容(最前面是最新的条目),按日期分隔。您可以:
- 按列标题对显示进行排序。
- 筛选显示,方法是指定日期间隔或在搜索盒子。控件中的文本若要在使用搜索后返回标准显示,请清除搜索盒子。
生成报告
您可以生成包含配置日志数据的CSV和HTML报告。
- CSV报告包含指定时间间隔内的所有日志数据。数据库中的层次数据被平铺成一个CSV表。数据的任何方面在文件中都没有优先级。不使用格式,也不考虑人为的可读性。该文件(名为MyReport)以通用的可消费格式包含数据。CSV文件通常用于归档数据或作为报表或数据操作工具(如Microsoft Excel)的数据源。
- HTML报告为指定时间间隔的日志数据提供了一种人类可读的形式。它为检查更改提供了一个结构化的、可导航的视图。HTML报告包括两个文件,Summary和Details。Summary列出了高级操作:每个操作发生的时间、操作人员和结果。点击一个细节每个操作旁边的链接将带您到Details文件中的低级操作,其中提供了额外的信息。
如需生成配置日志报告,请选择日志记录在Studio导航窗格中,然后选择创建自定义报表在操作窗格中。
- 选择报表的日期范围。
- 选择报告格式:CSV、HTML或两者兼有。
- 浏览到要保存报表的位置。
删除配置日志内容
要删除配置日志,您必须具有一定的授权管理和SQL Server数据库权限。
授权管理:您必须具有授权的管理角色,该角色允许读取部署配置。Full管理员具有此权限。自定义角色必须在“其他权限”类别中选择“只读”或“管理”。
要在删除配置日志数据之前创建备份,自定义角色还必须在“日志权限”类别中选择“只读”或“管理”。
SQL Server数据库:您必须具有从数据库中删除记录的权限的SQL服务器登录。有两种方法:
使用sysadmin服务器角色登录SQL Server数据库,该角色允许您在数据库服务器上执行任何活动。或者,
服务器
或setupadmin
服务器角色可以执行删除操作。如果您的部署需要更高的安全性,请使用映射到数据库用户的非sysadmin数据库登录,该用户有权从数据库中删除记录。
- 在SQL Server Management Studio中,使用非“系统管理员”的服务器角色创建一个SQL Server登录名。
- 将登录信息映射到数据库中的用户。SQL Server会自动在数据库中创建一个与登录用户同名的用户。
- 在“数据库角色成员”中,为数据库用户指定至少一个角色成员:
ConfigurationLoggingSchema_ROLE
或dbowner
.
有关更多信息,请参阅SQL Server Management Studio文档。
删除配置日志。
- 选择日志记录在Studio导航窗格中。
- 选择删除日志在操作窗格中。
- 系统将询问您是否要在删除日志之前创建日志备份。如果选择创建备份,请浏览到保存备份存档的位置。备份以CSV文件的形式创建。
清除配置日志后,删除日志是发布到空日志的第一个活动。该条目提供了关于何人在何时删除日志的详细信息。