告警相关概念 - 云平台 OCP V4.3.0

告警相关概念

更新时间：2026-04-14 11:55:54

本章节为您介绍告警对象、告警范围、告警规则、告警、告警规则分组、告警等级、模板、告警聚合和告警消除的概念。

告警对象

是告警任务所监控的主体，唯一标识一个告警对应的对象，可以是一个 OceanBase 集群、一台机器或一个服务。

告警对象的格式取决于告警项的维度，可能是标签值或标签值的组合，如 obregion=obocp:svr_ip=*.*.*.* 标识 OceanBase 或 OCP 集群上的一台服务器。

告警范围用于定义某个告警对应的范围，和指标范围保持一致。例如，CPU 使用率超限可能是集群整体使用率超限、租户 CPU 使用率超限、磁盘使用率超限等不同范围的含义。

告警范围包括以下值：

告警规则是告警的元数据，包括告警对象、名称、触发规则和告警详情配置等。

告警项按照生成方式可以分为 2 种类型：

对于表达式触发的告警，其告警规则表达式在告警项里配置；对于自定义触发的告警，告警规则表达式为空。

告警是一个告警规则在一个告警对象上发生的状态。

例如，告警对象机器 A 产生告警项 alarm_b，在故障期间每分钟触发一个告警信号，但是在 OCP 这属于一个告警。在告警事件页面只有一条记录。

每个告警项可以设置多个分组，分组的目的是为了方便对告警项进行管理及推送告警消息。

每个告警项都有对应的告警级别。

级别	英文含义	中文含义	颜色	说明
1	Down	停服	紫	完全不可用，需要立即介入修复，如 `OceanBase 服务启动失败`。
2	Critical	严重	红	系统可用性下降，需要紧急修复，避免完全不可用，如 `机器内存使用率大于 90% 持续 3 分钟`。
3	Alert	警告	橙	系统仍然可用，但是即将达到不可用状态，需要采取措施防止可用性下降，如 `OceanBase 租户连接数大于上限的 80%`。
4	Caution	注意	蓝	根据趋势判断，系统关键性能指标正在下降，但是还没达到触发警告的程度，此时可以通过排查发现潜在的问题，避免警告产生（保留类型，目前尚未有匹配的告警项）。
5	Info	提醒	绿	操作提醒，本质上不是告警，通常是管理员执行重要操作，如 `管理员执行集群下线操作`。

模板用于运行期根据变量生成动态内容，可以用于：

模板样例：

alarm_summary: ${alarm_targe} CPU 使用率超限
alarm_description: ${alarm_targe} CPU 使用率持续 ${alarm_duration} 超过 ${alarm_threshold}

支持的模板变量参见 OCP 告警模板变量。

为避免告警数量过多导致的告警风暴，告警通道支持配置聚合。

聚合规则为：

告警消除的概念就是故障恢复。故障恢复的感知可能通过监控模块确定故障消除了通知告警服务，也可能由告警服务基于告警消除超时自动实现。

告警超时自动消除逻辑：

为方便管理 OceanBase 资源和开发自己的应用程序，OCP 公开符合 REST 规范的 HTTP API。告警 API 中提供了告警相关的 API 的描述、语法及示例。API 文档面向开发人员。在调用接口前，请确保已充分了解 OCP 平台的的相关概念。

根据对接方式方式选择合适的方法调用 API：

告警和告警通知是 OCP 重要的状态监控功能，不同的角色在使用告警功能时需要采取不同的操作。

OCP 提供了通用的告警规则和告警模板，在不对告警规则和告警模板进行配置的情况下，您只需配置告警通道和告警推送，即可完成一个简单的告警配置流程。

OCP 告警模块推荐配置流程为：

管理员操作：
1. （可选）配置告警规则和告警模板。部署 OCP 之后，管理员可以根据业务需求，对已存在的告警规则与告警模板进行管理。
2. 配置告警通道。设置告警推送方式（钉钉、飞书、邮件等）及推送目标、消息格式。
3. 配置告警推送。将平台产生的告警消息通过指定的告警通道通知用户。
用户操作：
1. 查看告警事件。 OCP 用户在日常使用中，可以针对不同模块查看告警事件和通知。
2. （可选）屏蔽告警。支持 OCP 用户对告警信息进行屏蔽。