这是本节的多页打印视图。点击此处打印.

告警管理

1: 平台组件告警
2: 通知策略管理
3: 告警规则管理

1 - 平台组件告警

本文档介绍了如何在 KubeCube 中配置平台级告警，包括配置集群内的 Alertmanager 、告警通知联系人、通知路由规则、告警规则。

简介

默认情况下，KubeCube 会在平台部署kubecube-monitoring Chart，该 Chart 包含 Alertmanager 组件和默认的 Alertmanager Config Secret配置以及平台基础组件的告警规则。默认情况下，KubeCube 创建的 Alertmanager Config Secret 不会因为 Chart 的升级或删除操作而被修改，以防用户的配置丢失。

准备工作

以平台管理员角色登录 KubeCube 平台。

配置 AlertManager

登录到 KubeCube 平台，点击【运维管理】，侧边栏选择【告警–全局告警配置】，列表页可以看到各个集群的AlertManager 的配置信息，点击【设置】按钮进行配置，

全局配置

am-global

若使用企业邮箱作为告警通知方式，需要在全局配置中配置以下字段：

smtp_smarthost : 邮箱服务器域名和端口信息，e.g. imap.163.com:465
smtp_from : 发件人邮箱
smtp_auth_username : 邮件服务器认证用户名
smtp_auth_password : 邮件服务器认证密码或授权码

若使用企业微信作为告警通知方式，需要在全局配置中配置以下字段：

wechat_api_url : 默认使用https://qyapi.weixin.qq.com/cgi-bin/
wechat_api_secret : 第三方企业应用的密钥
wechat_api_corp_id : 企业微信账号唯一 ID

通知方式

目前页面支持配置Email、WeChat、Webhook三种联系方式，其他联系方式如Slack、OpsEngine等会在后续版本支持 am-receivers

更多字段含义请参考Alertmanager官方文档中关于receivers的定义

通知路由规则

管理告警规则

查看告警规则组

登录到 KubeCube 平台，点击【运维管理】，侧边栏选择【告警–告警规则】，列表页可以看到各个集群的PrometheusRule 的配置信息，默认情况下， KubeCube 为每个集群内置了基础资源以及平台组件的 PrometheusRule,

component-alerting

配置告警规则内容

可以点击【设置】按钮查看并配置每条告警规则的具体内容，包括

表达式 : Promql表达式
for : 告警持续时长
告警程度 : 可以在上述通知方式中配置不同告警程度对应的 Receiver 来接收告警通知
Annotations
- 摘要: 接收告警通知的摘要信息
- 描述信息: 接收告警通知的具体描述信息，如发生故障的 Pod 所在的集群，空间等
- Runbook Url: 针对该告警规则的运维排障文档，应作为最佳实践在企业内部进行维护
- 也可以【展开更多配置】，添加更多自定义的Annotations(键-值对)
Labels: 为告警规则附带的标签信息(键-值对)，可以配合通知路由规则实现告警通知的高级配置

component-PrometheusRule

更多字段含义请参考Prometheus-Operator的API文档

2 - 通知策略管理

本文档介绍了如何在 KubeCube 中管理项目级别的告警联系人与通知策略。

准备工作

联系人管理

推荐在一个告警通知策略内配置多个联系人，代表联系人组信息，而不是为每个联系人都创建一个通知策略。

登录到 KubeCube 控制台，选择租户项目后，侧边栏展开【告警】菜单，选择【告警策略组】，并点击创建.
弹出对话框后，填写告警联系人基本信息，目前页面支持配置Email、WeChat、Webhook三种联系方式，其他联系方式如Slack、OpsEngine等会在后续版本支持，如有需求可以通过列表页的【yaml配置】进行设置。

名称: 标识联系人组的名称，如"frontend"，在后续创建告警规则时作为关联。

Email配置

create-amc-email

是否接收告警恢复通知
收件人: 收件人的邮箱地址
更多配置：注意：以下配置默认使用集群全局配置，可以询问集群管理员获知。
- smarthost: 邮箱服务器域名和端口信息，e.g. imap.163.com:465
- from: 发件人邮箱
- authUsername: 邮件服务器认证用户名
- authPassword: 邮件服务器认证密码，需要提前在项目空间(kubecube-project-
  )创建一个Secret，再指定Secret和key
  - Secret: 选择已创建的Secret的名称
  - key: 选择指定Secret的key

更多配置请参考EmailConfig

WeChat配置

create-amc-wechat

是否接收告警恢复通知
toUser: 接收告警通知的企业微信用户名
toParty: 接收告警通知的企业微信用户组
toTag: 接收告警通知的企业微信用户标签
更多配置：注意：以下配置默认使用集群全局配置，可以询问集群管理员获知。
- apiURL: 微信第三方通知的apiURL
- corpID: 企业微信账号唯一 ID，可以在我的企业中查看。
- agentID: 第三方企业应用的 ID，可以在已创建的第三方企业应用详情页面查看。
- apiSecret: 需要根据第三方企业应用的密钥，提前在项目空间(kubecube-project-
  )创建一个Secret，再指定Secret和key
  - Secret: 选择已创建的Secret的名称
  - key: 选择指定Secret的key

更多配置请参考企业微信文档以及WeChatConfig。