Citrix Application Delivery Management

创建事件规则

May 24, 2018

可以配置规则以监视特定事件。规则可以更轻松地监控 Citrix 应用程序 Delivery Controller (ADC) 基础架构中生成的大量事件。

可以通过为规则配置特定条件及为规则分配操作来过滤一组事件。当生成的事件满足规则中的过滤条件时,将执行与规则关联的操作。您可以创建筛选器的条件包括:严重性、Citrix ADC 实例、类别、故障对象、配置命令和消息。

可以为事件分配以下操作:

  • 发送电子邮件操作:发送与筛选条件匹配的事件的电子邮件。

  • 发送陷阱操作:向外部陷阱目标发送或转发 SNMP 陷阱

  • 发送 SMS 操作:为符合筛选条件的每个事件发送短消息服务 (SMS) 消息。

  • 运行命令操作:当传入事件满足配置的规则时运行命令。

  • 执行作业操作:执行作业是针对与您指定的筛选条件匹配的事件。

  • 隐藏操作:在特定时间段内禁止删除事件。

您还可以设置以指定的时间间隔重新发送通知,直到清除了事件。并且,您可以为电子邮件自定义特定主题行、用户消息和/或附件。

本地化后的图片

例如,作为管理员,您可能希望监视特定 Citrix ADC 实例的 “CPU 使用率高” 事件,如果这些事件可能导致 Citrix ADC 实例中断。您可以创建规则以监视实例,指定操作以在发生“高 CPU 使用率”类别的事件时向您发送电子邮件通知。您可以计划规则以在特定时间(例如 11 AM 到 11 PM 之间)运行,这样,您不会在每次生成事件时收到通知。

配置事件规则涉及以下任务:

  1. 定义规则

  2. 选择规则检测的事件的严重性

  3. 指定事件的类别

  4. 指定应用规则的 Citrix ADC 实例

  5. 指定失败对象

  6. 指定任何其他过滤器

  7. 指定规则检测到事件时采取的操作

步骤 1-定义事件规则

导航到 网络 > 事件 > 规则 ”,然后单击 添加。如果要启用规则,请选中 启用规则 复选框。

您可以设置事 件时 间选项以指定时间间隔(以秒为单位),在此之后 Citrix Application Delivery Management (ADM) 刷新事件规则。

注意:

事件时间的最小值为 60 秒。如果将 “事 件时 间” 字段保留为空,则事件发生后立即应用事件规则。

基于上面的示例,每当 Citrix ADC 实例在 60 秒或更长时间内发生 “高 CPU 使用率” 事件时,您可能希望通过电子邮件通知您。您可以将事件时间设置为 60 秒,这样,每当 Citrix ADC 实例的 “高 CPU 使用率” 事件持续 60 秒或更长时间时,您都会收到一封包含事件详细信息的电子邮件通知。

本地化后的图片

您还可以按 设备系列 筛选事件规则,以跟踪 Citrix ADM 从中接收事件的 Citrix ADC 实例。

步骤 2-选择事件的严重性

可以创建使用默认严重性设置的事件规则。“Severity”(严重性)指定要为其添加事件规则的事件的当前严重性。

可以定义以下级别的严重性:Critical(严重)、Major(重大)、Minor(较小)、Warning(警告)、Clear(清除)及 Information(信息)。

本地化后的图片

注意

可以为一般事件和企业特定的事件配置严重性。要修改 Citrix ADM 上管理的 Citrix ADC 实例的事件严重性,请导航至 网络 > 事件设置。选择要为其配置事件严重性的类别,然后单击配置严重性。分配新的严重性级别,然后单击确定”。

步骤 3 - 指定事件类别

您可以指定 Citrix ADC 实例生成的事件的类别或类别。所有类别都在 Citrix ADC 实例上创建。然后,这些类别将使用 Citrix ADM 进行映射,该 ADM 可用于定义事件规则。选择要考虑的类别,然后将其从 可用 表移动到 已配置 表。

在上述示例中,您需要从显示的表中选择“cpuUsageHigh”作为事件类别。

本地化后的图片

步骤 4-指定 Citrix ADC 实例

选择要为其定义事件规则的 Citrix ADC 实例的 IP 地址。在 “实 ” 部分,单击 “ 选择实例”。在 “选 择实例 页面中,选择您的实例,然后单击 “选

本地化后的图片

步骤 5-选择失败对象

您可以从提供的下拉列表中选择失败对象,也可以添加已为其生成事件的失败对象。失败对象是已为其生成事件的实体实例或计数器。

失败对象影响事件的处理方式,并确保失败对象反映通知的确切问题。这可以用于快速追查问题以及确定失败的原因,而不是仅仅报告原始事件。例如,如果用户有登录问题,则此处的失败对象是用户名或密码,例如 nsroot。

此列表可以包含所有阈值相关事件的计数器名称、所有实体相关事件的实体名称、证书相关事件的证书名称等。

本地化后的图片

步骤 6-指定其他过滤器

您可以按以下内容进一步过滤事件规则:

  • 配置命令 -您可以指定完整的配置命令,或在星号 (*) 中指定描述模式以过滤事件。除了命令外,您还可以选择按命令的身份验证状态和/或其执行状态进一步过滤事件规则。例如,对于 NetscalerConfigChange 事件,键入 *bind system global policy_name*。

    本地化后的图片

  • 消息 -您可以指定完整的消息描述,或在星号 (*) 中指定描述模式以筛选事件。
    例如,对于 NetscalerConfigChange 事件,键入 *ns_client_ipaddress :10.102.126.250*。

    本地化后的图片

步骤 7-添加事件规则操作

您可以添加事件规则操作来为事件分配通知操作。当某个事件满足您在上面设置的已定义过滤条件时,将会发送或执行这些通知。您可以添加以下事件操作:

  • Send e-mail Action(发送电子邮件操作)

  • Send Trap Action(发送陷阱操作)

  • Send SMS Action(发送 SMS 操作)

  • Run Command Action(运行命令操作)

  • Execute Job Action(执行作业操作)

  • Suppress Action(阻止操作)

要设置电子邮件事件规则操作,请执行以下操作:

选择“Send e-mail Action”(发送电子邮件操作)事件操作类型后,当事件满足定义的过滤条件时将触发电子邮件。您将需要通过提供邮件服务器或邮件配置文件详细信息来创建电子邮件通讯组列表,也可以选择您之前创建的电子邮件通讯组列表。

您还可以在传入事件满足配置的规则时添加自定义的主题行和用户消息,以及将附件上载到您的电子邮件。

使用此选项,您还可以通过选中 “重复电子邮件通知 直到事件被清除” 复选框来为符合所选条件的事件规则发送重复的电子邮件通知 ,从而确保所有关键事件都得到处理,没有错过重要的电子邮件通知。例如,如果为涉及磁盘故障的实例创建了事件规则,并希望在问题解决之前一直收到通知,可以选择接收有关那些事件的重复电子邮件通知。

本地化后的图片

要设置陷阱事件规则操作,请执行以下操作:

选择 发送陷阱操 作” 事件操作类型时,SNMP 陷阱将被发送或转发到外部陷阱目标。通过定义陷阱通讯组列表(或陷阱目标和陷阱配置文件详细信息),当事件满足定义的过滤条件时将向特定的陷阱侦听器发送陷阱消息。

要设置 SMS 事件规则操作,请执行以下操作:

选择 “ 发送 SMS 操作 ” 事件操作类型时,每个符合筛选条件的事件都会显示 短消息服务 (SMS) 消息。您将需要通过提供 SMS 服务器或 SMS 配置文件详细信息来创建 SMS 通讯组列表,也可以选择您之前创建的 SMS 通讯组列表。

要设置“Run Command Action”(运行命令操作),请执行以下操作:

选择 运行命令操作” 事件操 作时,可以创建一个命令或脚本,这些命令或脚本可以在 Citrix ADM 上执行匹配特定筛选条件的事件。例如,如果在托管实例上更改了配置时发生严重性为“Critical”(严重)的事件,则可以运行命令脚本。

您还可以为 运行命令操作 脚本设置以下参数:

   
参数 说明
$source 此参数对应于接收的事件的源 IP 地址。
$category 此参数对应于过滤器类别下定义的陷阱类型。
$entity 此参数对应于已为其生成事件的实体实例或计数器。它可以包含所有阈值相关事件的计数器名称、所有实体相关事件的实体名称、所有证书相关事件的证书名称。
$severity 此参数对应于事件的严重性。
$failureobj 失败对象影响事件的处理方式,并确保失败对象反映通知的确切问题。这可以用于快速追查问题以及确定失败的原因,而不是仅仅报告原始事件。

注意

在命令执行期间,这些参数将替换为实际值。

要在 Citrix ADM 上配置 “运行命令操作” 事件操作:

  1. 事件规则操作下,单击 添加操 作,然后从 操作类型下拉列表中选择运行命令

  2. 创建命令分发列表 页面上,指定配置文件名称和要运行的命令。当事件满足定义的过滤条件时,将执行此命令。

    本地化后的图片

    注意

    如果要在 Citrix ADM 服务器日志文件中运行命令脚本时存储输出和生成的错误(如果有),则可以启用加输出” 和 “追加错误” 选项。如果不启用这些选项,Citrix ADM 将放弃运行命令脚本时生成的所有输出和错误。

要设置“Execute Job Action”(执行作业操作),请执行以下操作:

通过创建包含配置作业的配置文件,作业将作为 Citrix ADC、Citrix SDX 和 Citrix SD-WAN WO 实例的内置作业或自定义作业来执行,以满足您指定的筛选条件的事件和警报。

  1. 事件规则操作下,单击 添加操 作,然后从 操作类型菜单中选择执行作业 作。

  2. 与要在事件满足定义的过滤条件时运行的作业一起创建配置文件。

  3. 创建作业时,指定配置文件名称、实例类型、配置模板以及作业上的命令失败时要执行的操作。

  4. 根据选定的实例类型和所选配置模板,指定变量值,然后单击 “ 完成 ” 创建作业。

    本地化后的图片

要设置“Suppress Action”(阻止操作),请执行以下操作:

选择 禁止操 作” 事件操作时,可以配置禁止或删除事件的时间段(以分钟为单位)。可以最短阻止事件 1 分钟。

本地化后的图片

现在已创建具有适当过滤器和定义明确的事件规则操作的事件规则。