Runbook 日志

 

发布日期: 2016年3月

适用于: System Center 2012 SP1 - Orchestrator,System Center 2012 - Orchestrator,System Center 2012 R2 Orchestrator

每个 Runbook 在运行时都会生成日志。 利用 Runbook Designer,你既可以查看实时日志信息,也可以查看历史日志。

实时日志

你可以在 Runbook Designer 的“日志”窗格的“日志”选项卡上查看 Runbook 的实时日志。 在此日志中,Runbook 的每个运行实例都有一个条目,并且记录了其开始时间。 如果你展开此条目,则可以查看当前正在运行的活动。 双击活动以查看其详细信息。 如果已将工作簿日志记录配置为包括已发布数据,则活动详细信息中包含此信息。

历史日志

你可以在 Runbook Designer 的“日志”窗格的“日志历史记录”选项卡上查看 Runbook 的历史日志。 在此日志中,Runbook 的每个已完成的实例都有一个条目,并且记录了其开始和结束时间以及完成状态。 如果双击某个条目,则会打开“Runbook 详细信息”对话框,其中包括 Runbook 中的每个活动及其完成状态。 双击每个活动以查看其详细信息。 如果已将工作簿日志记录配置为包括已发布数据,则活动详细信息中包含此信息。

Runbook 日志选项

默认情况下,Runbook 日志不包括每个活动的已发布数据。 对于标准活动,请参阅标准活动,以获取可用于每项的已发布数据项的列表。 对于集成包,请参阅特定集成包指南。 你可以更改单个 Runbook 的日志记录属性以在日志中包括此信息。 你可以包括以下两种已发布数据中的任何一种或者两种都包括。

  • “特定于活动的已发布数据”是特定于特定活动的已发布数据。 通常,应仅为调试目的启用此选项。

  • “常用已发布数据”是所有活动共有的一组数据项。 这些数据项如下:

    • 活动名称

    • 活动类型

    • 活动 ID

    • 活动结束时间年份、月份、天、工作日、小时、分钟、秒

    • 活动持续时间

    • 上一个活动

    • 上一个活动名称

    • 时间已发布数据

System_CAPS_ICON_caution.jpg 小心

默认情况下,记录选项处于禁用状态。 请注意,向日志中添加这些项会增加数据存储的大小。

Runbook 审核历史记录

“Runbook 审核历史记录”跟踪对 Runbook 中的每个活动所做的更改。 这包括进行更改的用户、发生更改的日期和时间、更改的活动以及任何已更改属性的当前值和以前值。 只要 Runbook 存在,就会维护审核历史记录,并且无法清除审核历史记录。

你可以在 Runbook Designer 的“审核历史记录”选项卡上查看“Runbook 审核历史记录”。 系统将显示当前所选的 Runbook 的条目。 如果双击某个条目以打开“详细信息”对话框,你可在其中查看作为更改一部分的所有活动的列表。 选择其中一个条目以查看执行的活动,以及任何已更改属性的旧值和新值。

清除 Runbook 日志

“Runbook Designer”提供“日志清除”功能。 可以按需或根据计划安排清除 Orchestrator 日志数据。 在非高峰时段定期计划日志清除以维护数据库是一种好的做法。

System_CAPS_ICON_note.jpg 说明

清除日志后,会从 Orchestration 数据库中删除数据,并且无法恢复该数据。

如果允许日志条目数量不加选择地增长,则可能会导致针对 Orchestration 数据库的过度存储要求。 为了维护数据库的运行状况和性能,你应定期清除旧日志条目。 可以按自动日程安排或手动清除它们。

自动清除 Runbook 日志

通过选择频率选项以及要保留的条目数,你可以计划定期清除 Runbook 日志。 默认情况下,会使用以下设置自动清除 Runbook 日志。

设置 默认值
频率 每日一次
时间 01:00:00
保留 保留最后 5000 个条目

默认日志清除作业会清除每个 Runbook 最后 500 个日志条目之外的所有条目。 这意味着如果 Orchestrator 部署具有 20 个 Runbook,则默认清除会保留每个 Runbook 的最后 500 个日志条目,因此所有 Runbook 的数据库最多具有 10,000 个日志条目。

你可以继续使用这些默认值,或使用以下过程在 Runbook Designer 中更改设置。

按需清除 Runbook 或设置清除频率
  1. 在“Runbook Designer”中,右键单击“Management 服务器”以选择“日志清除”。

    如果想要立即清除所有 Runbook,请单击“立即清除”。

    如果想要立即清除特定 Runbook,请单击“日志历史记录”选项卡以选择要清除的 Runbook。

  2. 确保选择了“日程安排日志清除”选项。

  3. 选择运行清除过程的间隔天数以及运行该过程的时间。

  4. 如果不希望删除所有条目,请设置“日志清除选项”以指定要保留的日志条目。

  5. 单击**“完成”**。

手动清除 Runbook 日志

审核历史记录是一种特殊情况,因为无法用“日志清除”功能清除这些日志。 审核历史记录功能跟踪对“Runbook Designer”中的 Runbook 所做的更改,并且无法被删除。 删除审核历史记录日志的唯一方法是删除与其关联的 Runbook。 但是给定 Runbook 的审核历史记录日志的数据量通常不大,甚至在大型部署中,存储要求也不高于最低系统要求。

存在两个用于手动清除 Runbook 日志的选项,如以下两个过程中所示。 它们将在 Runbook Designer 中执行。

手动清除所有 Runbook 的 Runbook 日志
  1. 右键单击“Management 服务器”以选择“日志清除”。

  2. 设置“日志清除选项”以指定要保留的日志条目。

  3. 单击“立即清除”。

手动清除单一 Runbook 的所有 Runbook 日志条目
  1. 在“连接”窗格中,选择“Runbook”文件夹。

  2. 在工作区窗格中,单击 Runbook 的选项卡。

  3. 在“日志历史记录”窗格中,单击“日志历史记录”选项卡。

  4. 单击窗格顶部的“回收站”图标。

  5. 在提示你是否确实要清除日志时,单击“是”。

删除单一 Runbook 的一组特定 Runbook 日志条目
  1. 在“连接”窗格中,选择“Runbook”文件夹。

  2. 在工作区窗格中,单击 Runbook 的选项卡。

  3. 在“日志历史记录”窗格中,单击“日志历史记录”选项卡。

  4. 选择单一日志条目,或使用 Ctrl+Shift 组合键选择多个条目。

  5. 单击窗格顶部的红色“删除”图标。

  6. 在提示你是否确实要删除所选条目时,单击“是”。

删除孤立的日志条目

如果在运行 Runbook 实例时 Runbook Server Service 突然停止,则孤立的日志文件可能会保留在 Orchestration 数据库中。 如果发生这种情况,则不会用实例结束时间正确更新 Runbook 实例状态。 使用上述清除方法之一清除日志条目时,会删除这些条目。 如果想要在下次清除条目之前删除孤立的条目,则可以手动运行“ClearOrphanedRunbookInstances”存储过程以执行此功能。

以下过程描述如何使用 Orchestration 数据库服务器上安装的 Microsoft SQL Server Management Studio 运行此存储过程。 你可以从安装了能够访问 Orchestration 数据库的此工具的任何计算机中执行此过程。

删除孤立的日志条目
  1. 在具有 Orchestration 数据库的服务器上,单击“开始”,指向“所有程序”,单击“Microsoft SQL Server 2008”,然后单击“SQL Server Management Studio”。

  2. 在“连接到服务器”对话框内的“服务器名称”列表中,选择“(本地)”,然后单击“连接”。

  3. 在“对象浏览器”中,展开“数据库”,然后单击“Orchestrator”。

    System_CAPS_ICON_note.jpg 说明

    如果对 Orchestrator 数据库使用了不同的名称,请选择该名称。

  4. 展开“可编程性”,然后单击“存储过程”。

  5. 右击“Microsoft.SystemCenter.Orchestrator.Runtime.Internal.ClearOrphanedRunbookInstances”以选择“执行存储过程”。

  6. 在“执行过程”对话框中,单击“确定”。

  7. 在工具栏上,单击“执行”。

  8. 在“日志记录”窗格底部收到一条指明查询已经完成的消息时,关闭“SQL Server Management Studio”。

请参阅

Orchestrator 日志