Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

管理 playbook 实例

查看有关 playbook 实例的信息

要查看有关 playbook 实例的信息,请执行以下作:

  1. 单击Paragon Automation菜单中的配置>作指南选项。

    您可以在 Playbook 主页上查看已保存的 playbook。

    User interface for managing Playbooks, includes options to create or upload playbooks, search bar, and table listing playbooks with names, instances, and actions.
    • 应用于设备组或网络组的 playbook 在 playbook 名称旁边有一个向右箭头。

    • 表中的“实例”列显示正在运行和暂停的 playbook 实例数。

    • 某些作指南需要购买和安装高级或高级许可证。这些剧本有一个绿色的圆圈,里面有一颗白色的星星。如上所示,当您将鼠标悬停在图标上时,它会告诉您需要哪个许可证。

    • Live 列(在表的“作”部分中)显示一个彩色圆圈指示器,该指示器表示每个 playbook 的 playbook 实例的总体状态。下表提供了颜色定义:

      表 1:实时列的颜色定义

      颜色

      定义

      绿

      与此 playbook 关联的所有实例当前都在运行。

      黄色

      与此 playbook 关联的一个或多个实例将暂停。

      灰色/黑色

      要么没有可用于此 playbook 的实例,要么有可用于此 playbook 的实例但尚未部署配置。

  2. 单击 playbook 名称旁边的向右箭头以展开或折叠 playbook 实例详细信息。如果不存在插入符号,则作指南不会应用于任何设备组或网络组。

    Playbook 实例具有以下详细信息:

    列名或小部件

    描述

    实例名称

    用户定义的实例名称。

    附表

    应用于 playbook 实例的计划配置文件的名称。有关如何配置计划配置文件的信息,请参阅 创建计划以自动播放/暂停 Playbook 实例

    单击名称以显示计划详细信息。

    设备/网络组

    运行调度程序的设备组或网络组。

    设备数量

    运行此 playbook 实例的设备数。此列仅适用于设备组实例,不适用于网络组实例。

    地位

    playbook 实例的当前状态。状态可以是“正在运行”或“已暂停”。“状态”列还指示作是自动执行还是手动执行。

    注意:如果 playbook 实例的状态为 “运行中(手动)”,则可以使用 “暂停实例 ”按钮手动暂停实例。在这种情况下,状态将更改为 “已暂停(手动)”。要恢复运行此实例的计划,您必须使用 “播放实例 ”按钮手动运行该实例。在这种情况下,状态将变回 “正在运行(手动)”。

    开始/暂停时间

    上次启动或暂停 playbook 实例的日期和时间。该日期反映本地浏览器时区。

    下一步行动

    此列仅适用于与计划关联的 playbook 实例。它指示 playbook 实例是否计划在将来自动暂停或播放。如果 playbook 实例上没有运行任何计划,或者实例的状态为 “暂停(手动)”,则此列为空。

    播放/暂停按钮

    暂停或播放 playbook 实例或 playbook 实例的计划。

    播放/暂停按钮在两种状态之间切换。有关更多信息,请参阅 手动暂停或播放 Playbook 实例

    垃圾桶图标

    删除 playbook 实例。

创建和运行 Playbook 实例

要为设备组创建 playbook 实例,请执行以下作:

  1. 单击左侧导航栏中的配置>作指南选项。
  2. 单击所需 playbook 的“应用”图标(在表格的“作”部分中)。

    此时将显示标题 为“运行 Playbook:” <playbook-name> 的窗格。

  3. “剧本实例的名称”字段中,必须为此剧本实例输入适当的名称。
  4. (可选)在“按计划运行”字段中,选择要应用于此 playbook 实例的计划的名称。您只能为一个 playbook 实例应用一个计划。如果您希望特定 playbook 运行多个计划,则必须创建多个实例。每个实例都必须有其自己唯一的名称和计划。

    有关如何配置计划的信息,请参阅 创建计划以自动播放/暂停 Playbook 实例

    要查看有关现有调度程序的信息,请执行以下作:

    1. 单击Paragon Automation菜单中的 配置>见解设置

    2. “调度器设置”中,您可以查看表中每个已保存调度的属性摘要。单击特定计划名称可查看其他详细信息。

  5. “规则”下的“设备组”部分中,使用列表将此 playbook 实例应用于相应的设备组。

    “设备”部分中的设备列表会根据所选设备组而变化。

    注意:

    如果您的 playbook 包含网络规则,则 不会显示“设备组” 部分。相反,您将配置 “网络组” 部分(未显示)。

  6. 单击“设备”部分中列出的设备之一。

    在这里,您可以自定义此设备的变量(在作指南中添加的规则中定义)。

  7. 在标题为“设备<Device Name>的变量值”的部分中,您可以看到与 playbook 关联的每个规则的各种参数。每个变量的默认值在字段中显示为灰色文本。您可以保留这些值不变,也可以通过输入新值来覆盖它们。

    根据需要对设备组中的每个设备重复步骤 6 和 7。

    创建默认 icmp-outlier playbook 的实例时,之前必须输入每个设备的往返时间 (RTT) XPath(使用设备 ID)。Paragon Automation 支持 ICMP 异常值检测作手册中的 splat 运算符。您可以在作指南中以正则表达式格式输入 splat 运算符 (*),以便将规则应用于设备组中的所有设备。

    例如:

    /device-group[device-group-name=core]/device[device-id=~/.*/]]/topic[topic-name=protocol.icmp]/rule[rule-name=check-icmp-statistics]/rtt-average-ms

    在添加具有自定义网络规则的 playbook 实例以进行异常值检测时,也可以使用 splat 运算符。

    注意:

    如果删除或添加运行 ICMP 异常值 playbook 实例的设备组中的设备,则必须暂停该 playbook 实例,修改 XPath 配置以反映设备的添加或删除,然后重新应用设备组的 playbook 实例。

  8. 如果您确信所有变量值都适用于设备组中的所有设备,请选择以下选项之一。

    保存您的编辑,但不要部署更新的配置,也不要运行实例。例如,当您要进行多项更改并希望同时部署所有更新时,可以使用此选项。

    保存和部署

    部署配置并立即运行实例。如果应用计划配置文件,则实例将根据配置文件的配置运行。

手动暂停或播放 Playbook 实例

当您暂停实例时,Paragon Automation 不会收集、分析或发出与 playbook 规则关联的设备或网络组的告警。暂停实例之前收集的数据会保留在系统中,但在您再次播放实例之前,Paragon Automation 不会收集或分析新数据。

下表描述了 Play/Pause 列中 playbook 实例的状态:

如果显示的播放/暂停按钮为...

那么 playbook 实例的状态是...

暂停实例

  • 实例正在运行。

  • 实例未与计划关联。

  • Paragon Automation 正在收集数据。

Play 实例

  • 实例未运行。

  • 实例未与计划关联。

  • Paragon Automation 不会收集数据。

要手动暂停 playbook 实例,请执行以下作:

  1. 单击左侧导航栏中的配置>作指南选项。
  2. 单击要暂停的 playbook 名称旁边的向右箭头。
  3. 单击“暂停实例”按钮可暂停 playbook 实例(未与计划关联)。
  4. 此时将显示“播放/暂停剧本实例”对话框。选择以下选项之一:

    暂停

    将此 playbook 实例标记为在下次部署配置时暂停。如果您要进行多项更改并希望同时部署所有编辑,请使用此选项。

    暂停和部署

    立即暂停 playbook 实例并部署配置。playbook 表需要几秒钟的时间才能更新,以显示实例已暂停。

    您会在表中看到状态更新略有延迟,因为播放和暂停作是异步的。您可以通过位于窗口右上角的部署图标(如部署作的成功消息中所示)跟踪此异步活动的状态。完成此作后,状态也会反映在 playbook 表中。

    应用程序刷新 playbook 表后,playbook 名称会在 Live 列中显示一个黄色图标,作为实例已暂停的可视指示器。

  5. 要恢复已暂停的 playbook 实例,请单击 Play Instance 按钮以恢复运行 playbook 实例(未与计划关联)。

创建计划以自动播放/暂停 Playbook 实例

若要自动播放/暂停 playbook 实例,必须先创建调度程序,然后将调度程序应用于 playbook 实例。您只能为一个 playbook 实例应用一个计划。如果您希望特定 playbook 实例在多个计划上运行,则必须创建该实例的多个版本,每个版本都有自己唯一的名称和计划程序。

要为 playbook 实例创建计划,请执行以下作:

  1. 单击左侧导航栏中的配置>见解设置选项。
  2. 单击 Scheduler 选项卡。
  3. “调度器设置”中,单击添加调度器按钮(+调度器)。
  4. 在文本框中输入必要的值,然后为 playbook 实例计划选择适当的选项。

    下表介绍了 “添加调度程序 ”和 “编辑调度程序” 窗格中的属性:

    属性

    描述

    名字

    输入 playbook 实例计划程序的名称。

    调度器类型

    选择 离散连续

    对于离散调度程序,您可以使用“ 运行方式” 字段配置一个离散的时间长度来播放 playbook 实例。运行时间结束后,Paragon Insights 将自动暂停实例。您还可以将 Paragon Insights 配置为使用 Repeat (重复 ) 字段自动恢复播放实例。

    对于连续调度程序,可以配置“开始时间”、“结束时间”和“重复时间”字段。

    开始时间

    使用弹出日历选择首次播放 playbook 实例的日期和时间。

    竞选对象

    为离散 playbook 实例配置时间段。首先输入一个整数值,然后从列表中选择度量单位(分钟、小时或天)。

    运行时间结束后,Paragon Insights 将自动暂停实例。您还可以将 Paragon Insights 配置为使用 Repeat (重复 ) 字段自动恢复播放实例。

    结束

    (选答)使用弹出日历选择暂停 playbook 实例的日期和时间。如果您希望 playbook 实例无限期地播放,请留空。

    对于离散调度程序,可以配置“ 按时间运行 ”和 “按时间结束” 。如果“ 结束时间 ”时间段短于“ 运行 时间”,则离散调度程序在“ 按时结束 ”之后停止运行。

    重复

    在配置“重复”字段之前,先配置“运行方式”字段。您输入的“自定义重复”间隔必须大于配置的“运行”时间长度。

    在列表中,选择以下选项之一:

    • 您希望 playbook 实例播放的频率(日、周、月或年)。

    • 如果您希望 playbook 只播放一次,则选择 “从不 ”选项。

    • “自定义”选项,用于指定您希望 playbook 实例播放的自定义频率。使用“重复每一次”字段配置自定义频率。

    重复每一次

    (选答)如果您为 “重复 ”字段选择了“自定义”选项,请输入您希望 playbook 实例播放的自定义频率。首先输入一个整数值,然后从列表中选择度量单位(分钟、小时或天)。

  5. 执行下列作之一:
    • 保存 — 单击“保存”可保存调度器配置,但不要将其部署在 Paragon Automation 中。

    • 保存并部署 — 单击“保存并部署”以在 Paragon Automation 应用程序中保存并部署配置。

  6. 现在,你已准备好将调度程序应用于 playbook 实例。有关更多信息,请参阅创建和运行 Playbook 实例