接收器配置

Alertmanager Config Secret 包含 Alertmanager 实例的配置，该实例根据 Prometheus 发出的告警发送通知。

接收器配置 - 图1备注

本节参考假设你已经熟悉 Monitoring 组件的协同工作方式。有关 Alertmanager 的详细信息，请参阅本节。

在 Rancher UI 中创建接收器

接收器配置 - 图2先决条件：

  • 已安装 Monitoring 应用。
  • 如果你使用现有的 Alertmanager Secret 配置 Monitoring，则它必须具有 Rancher 的 UI 支持的格式。否则，你将只能直接修改 Alertmanager Secret 来进行更改。请注意，对于通过使用路由和接收器 UI 支持的 Alertmanager 配置类型，我们会继续进行强化。因此如果你有增强功能的请求，请提交 issue。

要在 Rancher UI 中创建通知接收器：

  • Rancher v2.6.5+
  • Rancher 版本低于 v2.6.5
  1. 转到要创建接收器的集群。单击 监控 -> 告警 -> AlertManagerConfigs。
  2. 单击创建。
  3. 点击添加接收器。
  4. 输入接收器的名称。
  5. 为接收器配置一个或多个提供程序。如需获取填写表单的帮助，请参阅下方的配置选项。

  6. 单击创建。

  7. 转到要创建接收器的集群。单击监控，然后单击接收器。

  8. 输入接收器的名称。
  9. 为接收器配置一个或多个提供程序。如需获取填写表单的帮助，请参阅下方的配置选项。
  10. 单击创建。

结果：告警可以向接收器发送通知。

接收器配置

通知集成是通过 receiver 配置的，Prometheus 文档对此进行了说明。

原生和非原生接收器

默认情况下，AlertManager 提供与一些接收器的原生集成，这些接收器在本节中列出。所有原生支持的接收器都可以通过 Rancher UI 进行配置。

对于 AlertManager 不提供原生支持的通知机制，可使用 webhook 接收器实现集成。你可以在此处找到提供此类集成的第三方驱动程序列表。Alerting Drivers 应用能让你访问这些驱动程序，以及它们相关的集成。启用后，你将可以在 Rancher UI 中配置非原生的接收器。

目前 Rancher Alerting Drivers 应用支持访问以下集成：

  • Microsoft Teams，基于 prom2teams 驱动程序
  • SMS，基于 Sachet 驱动程序

你可以在 Rancher UI 中可以配置以下类型的接收器：

你可以在 YAML 中使用自定义接收器选项，从而配置无法通过 Rancher UI 表单配置的接收器。

Slack

字段类型描述
URLString输入你的 Slack webhook URL。有关创建 Slack webhook 的说明，请参阅 Slack 文档。
默认频道String输入要发送告警通知的频道名称。格式：#<channelname>。
代理 URLStringwebhook 通知的代理。
发送已解决告警Bool如果告警已解决（例如 [已解决] CPU 使用率过高问题），是否发送后续通知。

电子邮件

字段类型描述
默认收件人地址String接收通知的电子邮件地址。
发送已解决告警Bool如果告警已解决（例如 [已解决] CPU 使用率过高问题），是否发送后续通知。

SMTP 选项：

字段类型描述
发件人String你的 SMTP 邮件服务器上可用的电子邮件地址，用于发送通知。
主机StringSMTP 服务器的 IP 地址或主机名。示例：smtp.email.com。
使用 TLSBool使用 TLS 进行加密。
用户名String用户名，用于通过 SMTP 服务器进行身份验证。
密码String密码，用于通过 SMTP 服务器进行身份验证。

PagerDuty

字段类型描述
集成类型StringEvents API v2 或 Prometheus。
默认集成密钥String有关获取集成密钥的说明，请参阅 PagerDuty 文档。
代理 URLStringPagerDuty 通知的代理。
发送已解决告警Bool如果告警已解决（例如 [已解决] CPU 使用率过高问题），是否发送后续通知。

Opsgenie

字段描述
API 密钥有关获取 API 密钥的说明，请参阅 Opsgenie 文档。
代理 URLOpsgenie 通知的代理。
发送已解决告警如果告警已解决（例如 [已解决] CPU 使用率过高问题），是否发送后续通知。

Opsgenie 响应者：

字段类型描述
类型String计划程序、团队、用户或升级。有关告警响应者的更多信息，请参阅 Opsgenie 文档。
发送至StringOpsgenie 收件人的 ID、名称或用户名。

Webhook

字段描述
URL你所选的应用的 Webhook URL。
代理 URLwebhook 通知的代理。
发送已解决告警如果告警已解决（例如 [已解决] CPU 使用率过高问题），是否发送后续通知。

自定义

此处提供的 YAML 将直接附加到 Alertmanager Config Secret 的接收器中。

Teams

为 Rancher 管理的集群启用 Teams 接收器

Teams 接收器不是原生接收器，因此需要启用后才能使用。你可以通过转到应用页面，安装 rancher-alerting-drivers 应用，然后选择 Teams 选项，从而为 Rancher 管理的集群启用 Teams 接收器。

  1. 在 Rancher UI 中，转到要安装 rancher-alerting-drivers 的集群，然后单击 Apps。
  2. 点击 Alerting Drivers 应用。
  3. 单击 Helm 部署选项选项卡。
  4. 选择 Teams 并单击安装。
  5. 记下使用的命名空间，后续步骤中将需要该命名空间。

配置 Teams 接收器

可以通过更新 ConfigMap 来配置 Teams 接收器。例如，以下是最小的 Teams 接收器配置：

  1. [Microsoft Teams]
  2. teams-instance-1: https://your-teams-webhook-url

配置完成后，按照本节中的步骤添加接收器。

使用以下示例作为 URL，其中：

  • 将 ns-1 替换为安装 rancher-alerting-drivers 应用的命名空间。
  1. url: http://rancher-alerting-drivers-prom2teams.ns-1.svc:8089/v2/teams-instance-1

SMS

为 Rancher 管理的集群启用 SMS 接收器

SMS 接收器不是原生接收器，因此需要启用后才能使用。你可以通过转到应用页面，安装 rancher-alerting-drivers 应用，然后选择 SMS 选项，从而为 Rancher 管理的集群启用 SMS 接收器。

  1. 在左上角，单击 ☰ > 集群管理。
  2. 在集群页面上，转到要安装 rancher-alerting-drivers 的集群，然后单击 Explore。
  3. 在左侧导航栏中，单击应用 & 应用市场。
  4. 点击 Alerting Drivers 应用。
  5. 单击 Helm 部署选项选项卡。
  6. 选择 SMS 并单击安装。
  7. 记下使用的命名空间，后续步骤中将需要该命名空间。

配置 SMS 接收器

可以通过更新 ConfigMap 来配置 SMS 接收器。例如，以下是最小的 SMS 接收器配置：

  1. providers:
  2.   telegram:
  3.     token: 'your-token-from-telegram'
  5. receivers:
  6. - name: 'telegram-receiver-1'
  7.   provider: 'telegram'
  8.   to:
  9.     - '123456789'

配置完成后，按照本节中的步骤添加接收器。

使用以下示例作为名称和 URL，其中：

  • 分配给接收器的名称（例如 telegram-receiver-1）必须与 ConfigMap 中 receivers.name 字段中的名称（例如 telegram-receiver-1）匹配。
  • 将 URL 中的 ns-1 替换为安装 rancher-alerting-drivers 应用的命名空间。
  1. name: telegram-receiver-1
  2. url http://rancher-alerting-drivers-sachet.ns-1.svc:9876/alert

配置多个接收器

你可以编辑 Rancher UI 中的表单来设置一个接收器资源，其中包含 Alertmanager 将告警发送到你的通知系统所需的所有信息。

也可以向多个通知系统发送告警。一种方法是使用自定义 YAML 来配置接收器。如果你需要让两个系统接收相同的消息，则可以为多个通知系统添加配置。

你还可以通过使用路由的 continue 选项来设置多个接收器。这样，发送到接收器的告警会在路由树（可能包含另一个接收器）的下一级进行评估。

Alertmanager 配置示例

Slack

要通过 Slack 设置通知，你可以将以下 Alertmanager Config YAML 放入 Alertmanager Config Secret 的 alertmanager.yaml 键中，你需要更新 api_url 来使用来自 Slack 的 Webhook URL：

  1. route:
  2.   group_by: ['job']
  3.   group_wait: 30s
  4.   group_interval: 5m
  5.   repeat_interval: 3h
  6.   receiver: 'slack-notifications'
  7. receivers:
  8. - name: 'slack-notifications'
  9.   slack_configs:
  10.   - send_resolved: true
  11.     text: '{{ template "slack.rancher.text" . }}'
  12.     api_url: <user-provided slack webhook url here>
  13. templates:
  14. - /etc/alertmanager/config/*.tmpl

PagerDuty

要通过 PagerDuty 设置通知，请使用 PagerDuty 文档 中的以下示例作为指导。此示例设置了一个路由，该路由捕获数据库服务的告警，并将告警发送到链接到服务的接收器，该服务将直接通知 PagerDuty 中的 DBA，而其他告警将被定向到具有不同 PagerDuty 集成密钥的默认接收器。

你可以将以下 Alertmanager Config YAML 放入 Alertmanager Config Secret 的 alertmanager.yaml 键中。你需要将 service_key 更新为使用你的 PagerDuty 集成密钥，可以根据 PagerDuty 文档的 “Integrating with Global Event Routing” 找到该密钥。有关配置选项的完整列表，请参阅 Prometheus 文档。

  1. route:
  2.  group_by: [cluster]
  3.  receiver: 'pagerduty-notifications'
  4.  group_interval: 5m
  5.  routes:
  6.   - match:
  7.       service: database
  8.     receiver: 'database-notifcations'
  10. receivers:
  11. - name: 'pagerduty-notifications'
  12.   pagerduty_configs:
  13.   - service_key: 'primary-integration-key'
  15. - name: 'database-notifcations'
  16.   pagerduty_configs:
  17.   - service_key: 'database-integration-key'

CIS 扫描告警的示例路由配置

在为 rancher-cis-benchmark 告警配置路由时，你可以使用键值对 job:rancher-cis-scan 来指定匹配。

例如，以下路由配置示例可以与名为 test-cis 的 Slack 接收器一起使用：

  1. spec:
  2.   receiver: test-cis
  3.   group_by:
  4. #    - string
  5.   group_wait: 30s
  6.   group_interval: 30s
  7.   repeat_interval: 30s
  8.   match:
  9.     job: rancher-cis-scan
  10. #    key: string
  11.   match_re:
  12.     {}
  13. #    key: string

有关为 rancher-cis-benchmark 启用告警的更多信息，请参阅本节。

Notifiers 的可信 CA

如果你需要将受信任的 CA 添加到 Notifiers，请按照本节中的步骤操作。