Skip to content

关于本页

本页介绍更夫所基于的开源内核 Keep 的通用能力。更夫在其上提供国内化增强:钉钉/企业微信/飞书通知、国产大模型接入、LDAP 认证与值班管理。部署与上手请看快速上手。

概述 ​

SignalFX Provider 通过与 SignalFX Alerting 的 webhook 无缝集成来增强您的监控和告警功能。这种集成允许您直接从 SignalFX 接收告警,确保您能够及时了解基础设施内的重要事件和指标。

主要功能:

  • Webhook 自动检测:自动将 Keep 配置为 SignalFX 内的 Webhook 集成,订阅所有可用的 SignalFX 检测器和规则以进行全面的监控。
  • 手动和自动订阅管理:在向新检测器添加 Keep 作为订阅者方面提供灵活性,可以手动完成,也可以通过从 UI 重新运行"设置 webhook"功能来完成维护。

TIP

如需了解更多信息或帮助,请随时在我们的 Slack 社区上联系。

连接 Provider ​

有三种方法连接 SignalFX:

  • 推送(手动) - 将 Keep 安装为 Webhook 集成。
  • 推送(自动检测) - 让 Keep 将自身检测为 webhook 集成并订阅您的 SignalFx 检测器。
  • 拉取 - Keep 将从 SignalFx 拉取告警。

TIP

安装 SignalFx 的推荐方式是通过推送(自动检测)。使用这种方法,您将受益于推送方法的优势(因为 SignalFx 在 Webhooks 上发送更多上下文)和拉取集成的便利性(只需提供凭据,Keep 会完成其余工作)的结合。

在以下部分中,我们将详细说明每种方法。

推送(手动) ​

INFO

有关 SignalFx 如何与 Webhooks 集成的更多信息,您可以阅读 https://docs.splunk.com/observability/en/admin/notif-services/webhook.html#webhook2

  1. 从您的 SignalFx 控制台,点击"Data Management":
  1. 点击"+ Add Integration"
  1. 将"By Use Case"选择改为"All"并过滤"webhook":
  1. 点击 Webhook 磁贴并填写以下详细信息:
  1. 现在,转到检测器和 SLO 页面:
  1. 对于每个检测器和规则,将 Keep 添加为告警接收者:

推送(自动检测) ​

使用这种方法:

  1. Keep 将自身安装为 Webhook 集成。
  2. Keep 迭代所有检测器和规则,并将自身添加为订阅者

INFO

这种方法的缺点是您需要一个具有管理员角色的用户的电子邮件/密码。这是由于 SignalFx 在安装集成方面的限制:您可以在这里阅读更多 - https://dev.splunk.com/observability/reference/api/integrations/latest#endpoint-create-integration

要安装带有推送(自动检测)的 Keep:

  1. 具有读取权限的 SF 令牌 - 转到 Settings -> Access Tokens -> New Token
  1. 具有管理员角色用户的电子邮件/密码 - 这将仅用于创建 Webhook 集成
  2. orgid - 这将仅用于创建 Webhook 集成

获得我们需要的一切后,转到 Keep 并安装 SignalFx provider:

拉取 ​

使用这种方法,Keep 将在您每次刷新控制台页面时从 SignalFx 拉取告警。

  1. 具有读取权限的 SF 令牌 - 转到 Settings -> Access Tokens -> New Token
  1. 在 Keep 的 UI 中,安装 SignalFx Provider:

指纹 ​

SignalFx 中的指纹基于(incidentId, detectorId)计算。

Webhook 集成修改 ​

自动 webhook 集成获得 API authScope 的访问权限,这使 Keep 有能力读取和写入 SignalFx API。

认证 ​

此提供商需要身份验证。

  • sf_token: SignalFX 令牌(必需:True,敏感:True)
  • realm: SignalFX 领域(必需:False,敏感:False)
  • email: SignalFX 电子邮件。设置 webhook 需要。(必需:False,敏感:True)
  • password: SignalFX 密码。设置 webhook 需要。(必需:False,敏感:True)
  • org_id: SignalFX 组织 ID。设置 webhook 需要。(必需:False,敏感:False)

某些范围可能需要才能通过提供商执行特定操作或查询。以下是相关范围及其用例的摘要:

  • API: API authScope - SignalFx API 的读取权限(强制)(文档)

在工作流中 ​

此提供商不能用作工作流中的"步骤"或"操作"。如果您想使用它,请通过在 GitHub 仓库 创建问题告诉我们。

相关链接 ​

基于 MIT 协议开源的 Keep · 由更夫社区维护