配置企业微信通知

本教程演示如何配置企业微信通知并添加相应 ID 来接收告警策略的通知。

准备工作

您需要准备一个企业微信帐号。

动手实验

步骤 1：创建应用

  1. 登录企业微信管理后台，点击应用管理。

  2. 在应用管理页面，点击自建下的创建应用。

  3. 在创建应用页面，上传应用 Logo、输入应用名称（例如，通知测试），点击选择部门 / 成员编辑可见范围，然后点击创建应用。

    备注

    请确保将需要接收通知的用户、部门或标签加入可见范围中。

  4. 应用创建完成后即可查看其详情页面，AgentId 右侧显示该应用的 ID。点击 Secret 右侧的查看，然后在弹出对话框中点击发送，便可以在企业微信客户端查看 Secret。此外，您还可以点击编辑来编辑可见范围。

步骤 2：创建部门或标签

  1. 在通讯录页面的组织架构选项卡下，点击测试（本教程使用测试部门作为示例）右侧的 配置企业微信通知 - 图1，然后选择添加子部门。

  2. 在弹出对话框中，输入部门名称（例如测试二组），然后点击确定。

  3. 创建部门后，您可以点击右侧的添加成员、批量导入或从其他部门移入来添加成员。添加成员后，点击该成员进入详情页面，查看其帐号。

  4. 您可以点击测试二组右侧的 配置企业微信通知 - 图2 来查看其部门 ID。

  5. 点击标签选项卡，然后点击添加标签来创建标签。若管理界面无标签选项卡，请点击加号图标来创建标签。

  6. 在弹出对话框中，输入标签名称，例如组长。您可以按需指定可使用人，点击确定完成操作。

  7. 创建标签后，您可以点击右侧的添加部门/成员或批量导入来添加部门或成员。点击标签详情进入详情页面，可以查看此标签的 ID。

  8. 要查看企业 ID，请点击我的企业，在企业信息页面查看 ID。

步骤 3：在 KubeSphere 控制台配置企业微信通知

您必须在 KubeSphere 控制台提供企业微信的相关 ID 和凭证，以便 KubeSphere 将通知发送至您的企业微信。

  1. 使用具有 platform-admin 角色的用户（例如，admin）登录 KubeSphere Web 控制台。

  2. 点击左上角的平台管理，选择平台设置。

  3. 前往通知管理下的通知配置，选择企业微信。

  4. 在服务器设置下的企业 ID、应用 AgentId 以及应用 Secret 中分别输入您的企业 ID、应用 AgentId 以及应用 Secret。

  5. 在接收设置中，从下拉列表中选择用户 ID、部门 ID 或者标签 ID，输入对应 ID 后点击添加。您可以添加多个 ID。

  6. 勾选通知条件左侧的复选框即可设置通知条件。

    • 标签：告警策略的名称、级别或监控目标。您可以选择一个标签或者自定义标签。
    • 操作符：标签与值的匹配关系，包括包含值，不包含值，存在和不存在。

    • 值：标签对应的值。

      备注

      • 操作符包含值和不包含值需要添加一个或多个标签值。使用回车分隔多个值。
      • 操作符存在和不存在判断某个标签是否存在，无需设置标签值。

    您可以点击添加来添加多个通知条件，或点击通知条件右侧的 配置企业微信通知 - 图3 来删除通知条件。

  7. 配置完成后，您可以点击右下角的发送测试信息进行验证。

  8. 在右上角，打开未启用开关来接收企业微信通知，或者关闭已启用开关来停用企业微信通知。

    备注

    • 通知条件设置后，接收人只会接受符合条件的通知。
    • 如果您更改了现有配置，则必须点击确定以应用更改。

步骤 4：接收企业微信通知

配置企业微信通知并添加 ID 后，您需要启用 KubeSphere 告警系统，并为工作负载或节点创建告警策略。告警触发后，接收设置中添加的用户或部门将收到通知消息。

请参考下方截图中的企业微信通知消息示例。

notification-message

备注

  • 如果您更新了企业微信服务器配置，KubeSphere 将根据最新配置发送通知。

  • 默认情况下，KubeSphere 大约每 12 小时针对同一告警发送通知。告警重复间隔主要由 kubesphere-monitoring-system 项目中 alertmanager-main 密钥的 repeat_interval 所控制。您可以按需自定义重复间隔。

  • KubeSphere 设有内置告警策略，在不设置任何自定义告警策略的情况下，只要内置告警策略被触发，您的企业微信仍能接收通知消息。