6.1 事件模板
事件模板定义了事件的架构和行为。分析生成的每个事件都必须基于某个事件模板。模板在基础库 → 事件模板中集中管理,可被系统中任意分析复用。
6.1.1 创建事件模板
创建新事件模板的步骤:
- 在左侧导航中进入基础库 → 事件模板。
- 点击 +(新建事件模板)按钮。
- 配置模板字段(见下文)。
- 点击保存。
6.1.2 模板配置
基本设置
| 字段 | 说明 |
|---|---|
| 名称 | 模板的唯一标识符 |
| 分类 | 用于组织模板的标签(例如"基础模板"或自定义分类) |
| 仅作为基础模板 | 启用后,该模板不能直接用于创建事件,只能作为其他模板的父模板 |
| 严重程度 | 由此模板创建的事件的默认严重等级:严重、主要、次要、警告或常规 |
| 允许扩展 | 启用后,其他模板可继承此模板 |
| 允许确认 | 启用后,由此模板创建的事件需要人工确认。未确认的活动事件将按照元素通知规则继续触发重新通知 |
| 原因代码 | 对事件原因进行分类的可选枚举集,需提前在基础库 → 枚举集中定义 |
| 原因代码值 | 原因代码枚举集中的某个具体值,提供更详细的原因描述 |
| 事件间通知最小发送间隔 | 同一分析产生的事件之间发送通知的最小时间间隔。防止分析频繁触发事件时产生通知过载——例如设置为 20 分钟后,无论触发多少次事件,每 20 分钟窗口内只发送一条通知 |
| 描述 | 模板用途的自由文本描述 |
事件命名规则
由模板生成的每个事件名称由事件命名规则构建。在字段中输入静态文本,并通过点击右侧的 + 图标插入占位变量。可用变量包括元素名称、分析名称、开始时间、结束时间等。
建议在命名规则中包含元素名称、分析名称和开始时间,使每个事件名称都具有自描述性:{elementName} - {analysisName} - {startTime}。
模板继承
事件模板支持继承。创建模板时,可选择基础模板,新模板将继承其配置。子模板可在基础模板属性架构的基础上进行扩展,并覆盖个别设置。
若模板标记为仅作为基础模板,则在配置分析时无法直接引用,只能作为父模板使用。
6.1.3 事件属性模板
事件可携带自定义属性,记录事件发生时的值——例如超限期间的峰值温度或故障时的批次 ID。这些属性在事件模板编辑器的事件属性模板部分定义。
每个属性的配置项如下:
| 字段 | 说明 |
|---|---|
| 名称 | 属性名称 |
| 分类 | 可选标签 |
| 数据类型 | 值的类型(数值、字符串等) |
| 默认值 | 分析未写入此属性时使用的值 |
| 常量 | 启用后,值在创建后不可修改 |
| 隐藏 | 启用后,属性在普通事件视图中不显示 |
配置分析时,计算输出可写入事件模板中定义的任意属性。这允许将计算值——例如窗口期间的平均值或最大超限值——直接捕获到事件记录中。
提示
事件属性数据存储在 TDengine IDMP 内置关系数据库中,而非时序存储中。事件属性不支持数据引用配置。
6.1.4 管理事件模板
基础库 → 事件模板列表显示所有模板及其名称、分类、严重程度和描述。使用每行右侧的操作图标可以:
- 编辑 — 修改模板配置
- 删除 — 删除模板(仅在没有分析引用该模板时才能删除)









