1 配置触发器

概述

要配置触发器,请执行以下步骤:

  • 转至:数据采集主机
  • 点击 主机 行中的 触发器
  • 点击右侧的 创建触发器(或者点击触发器名称以编辑现有触发器)
  • 在表单中输入触发器的参数

另请参阅有关触发器及其计算时间的 general information

配置

Trigger(触发器)选项卡包含所有关键的触发器属性。

所有必填输入字段均以红色星号标记。

参数 描述
Name 触发器名称。
支持的macros包括:{HOST.HOST}、{HOST.NAME}、{HOST.PORT}、{HOST.CONN}、{HOST.DNS}、{HOST.IP}、{ITEM.VALUE}、{ITEM.LASTVALUE}、{监控项.LOG.*} 和 {$MACRO} 用户宏。
$1、$2...$9 宏可用于引用表达式中的第一个、第二个...第九个常量。
注意:$1-$9 宏在引用相对简单、直接的表达式中的常量时将正确解析。例如,如果表达式为 last(/New 主机/system.cpu.load[percpu,avg1])>5,名称“Processor load above $1 on {HOST.NAME}”将自动更改为“Processor load above 5 on New 主机”
Event name 如果定义了此名称,将会使用此名称来 create 问题事件名称,而不是触发器名称。
事件名称可用于构建包含问题数据的有意义的告警(参见 示例-18)。
所支持的宏与触发器名称中的宏相同,此外还包括 {TIME} 和 {?EXPRESSION} 表达式宏。
Operational data 运行数据允许定义任意字符串以及宏。这些宏将在 监控Problems 中动态解析为实时数据。虽然触发器名称中的宏(见上文)将在问题发生时解析为其对应的值,并作为静态问题名称的基础,运行数据中的宏则保留动态显示最新信息的能力。如果在触发器级别未配置运行数据,则将显示表达式中所有监控项的最新值。
所支持的宏集合与触发器名称中的相同。
Severity 通过点击按钮设置所需的触发器 severity
Expression 逻辑 expression,用于定义问题的条件。
支持 时间后缀memory size suffixes
当表达式中包含的所有条件都满足时,即表达式计算结果为 TRUE 时,会创建一个问题。除非在 恢复表达式 中指定了额外的恢复条件,否则一旦表达式计算结果为 FALSE,问题就会被解决。
OK event generation OK事件生成选项:
表达式 - OK事件基于与问题事件相同的表达式生成;
恢复表达式 - 如果问题表达式计算结果为FALSE且恢复表达式计算结果为TRUE,则生成OK事件;
- 此情况下触发器不会自动返回到OK状态。
Recovery expression 逻辑 expression(可选),用于定义在原始问题表达式已被评估为 FALSE 后,解决该问题之前必须满足的额外条件。
恢复表达式对触发器 迟滞 很有用。如果问题表达式仍然为 TRUE,则无法仅通过恢复表达式来解决该问题。
仅当为“正常事件生成”选择“恢复表达式”时,此字段才可用。
PROBLEM event generation mode 生成问题事件的模式:
Single - 当触发器首次进入“Problem”状态时生成单个事件;
Multiple - 每次触发器评估为“Problem”时均生成事件。
OK event closes 选择是否触发恢复事件关闭:
所有问题 - 此触发器的所有问题
标签值匹配时关闭所有问题 - 仅关闭与此事件标签值匹配的触发器问题
Tag for matching 输入用于事件关联的事件标签名称。
如果为 OK事件关闭 属性选择“如果标签值匹配则关闭所有问题”,则会显示此字段,并且在此情况下该字段为必填项。
Allow manual close 勾选此项可允许手动关闭manual closing由此触发器生成的问题事件。在确认问题事件时,可以进行手动关闭。
Menu entry name 如果非空,则此处输入的名称(最多 64 个字符)将在前端多个位置用作 菜单条目 URL 参数中指定的触发器 URL 的标签。如果为空,则使用默认名称 触发器 URL
支持的宏集合与触发器 URL 中相同。
Menu entry URL 如果非空,此处输入的 URL(最多 2048 个字符)将作为链接在前端多个位置的 event menu 中显示,例如在 监控 → Problems使用部件 仪表板小部件中点击问题名称时。
支持与触发器名称中相同的宏集合,外加 {EVENT.ID}、{HOST.ID} 和 {TRIGGER.ID}。注意:URL 中不会解析具有密文值的用户宏。
Description 用于提供与此触发器相关更多信息的文本字段。可以包含解决特定问题的说明、负责人员的联系方式等。
支持的宏集与触发器名称中支持的相同。
Enabled 如果需要,取消选中此复选框将禁用触发器。
前端将不再显示已禁用触发器的问题,但不会将其删除。

标签选项卡允许你定义触发器级别的 tags。此触发器的所有问题将被 标记为在此处输入的值。

此外,继承的和触发器标签 选项允许查看标签 如果触发器来自该模板,则在模板级别定义。如果 存在多个具有相同标签的模板,这些标签将被显示 一旦触发条件满足,模板名称将用逗号分隔。触发器不会 “继承”并显示主机级别标签。

参数 描述
Name/Value 设置自定义标签以标记触发器事件。
标签由标签名称和值组成。您可以仅使用名称,或者将其与值配对使用。一个触发器可以具有相同名称但不同值的多个标签。
事件标签中支持用户宏、带上下文的用户宏、低级别自动发现宏以及与 {{ITEM.VALUE}}{{ITEM.LASTVALUE}} 和低级别自动发现宏组合使用的宏functions。低级别自动发现宏可以在宏上下文中使用。
触发器标签值中支持 {TRIGGER.ID} 宏。这对于标识从触发器原型创建的触发器非常有用,例如,在维护期间抑制这些触发器产生的问题。
如果展开后的值总长度超过 255,则会被截断为 255 个字符。
查看所有 宏支持 事件标签支持的宏。
标签 Event tags 可用于事件相关性、动作条件中,并且还将在 监控问题问题 小组件中显示。

依赖关系选项卡包含所有dependencies 触发器的。

单击 添加 以添加新的依赖项。

::: noteclassic 您也可以通过打开现有触发器来配置触发器, 按下 克隆 按钮,然后以不同的名称保存 名称。 仅返回OutputFormat格式要求结果

测试表达式

可以测试配置的触发器表达式,以查看根据接收到的值,表达式结果会是什么。

以下是一个来自官方模板的表达式示例:

avg(/Cisco IOS SNMPv2/sensor.temp.value[ciscoEnvMonTemperatureValue.{#SNMPINDEX}],5m)>{$TEMP_WARN}
       or
       last(/Cisco IOS SNMPv2/sensor.temp.status[ciscoEnvMonTemperatureState.{#SNMPINDEX}])={$TEMP_WARN_STATUS}

要测试该表达式,请点击表达式字段下方的 表达式构造器(Expression constructor)

在表达式构造器中,会列出所有单独的表达式。要打开测试窗口,请点击表达式列表下方的 测试(Test)

在测试窗口中,您可以输入示例值(例如中的 '80'、'70'、'0'、'1'),然后点击 测试(Test) 按钮查看表达式结果。

可以看到各个表达式的结果以及整个表达式的最终结果。

"TRUE" 表示指定的表达式成立。在此特定情况 A 中,"80" 大于指定值 {$TEMP_WARN},例如中的 "70"。正如预期,结果显示为 "TRUE"。

"FALSE" 表示指定的表达式不成立。在此特定情况 B 中,{$TEMP_WARN_STATUS} 的 "1" 需要等于指定值,例如中的 "0"。正如预期,结果显示为 "FALSE"。

所选的表达式类型为 "OR"。如果至少有一个指定条件(在此例中为 A 或 B)为 TRUE,则整体结果也将为 TRUE。这意味着当前值超过了警告值,并且已发生问题。