Skip to content

关于本页

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

认证 ​

此提供商需要身份验证。

  • token: 令牌(必需:True,敏感:False)
  • host: Grafana OnCall 主机(必需:True,敏感:False)

在工作流中 ​

此提供商可用于工作流。

作为"操作"来进行更改或更新数据,示例:

yaml
actions:
    - name: Query grafana_oncall
      provider: grafana_oncall
      config: "{{ provider.my_provider_name }}"
      with:
        title: {value}
        alert_uid: {value}
        message: {value}
        image_url: {value}
        state: {value}
        link_to_upstream_details: {value}

如果您需要此提供商的工作流示例,请提交 GitHub 问题。

连接 Provider ​

要连接到 Grafana OnCall,您需要创建一个 API 令牌:

  1. 登录您的 Grafana 账户。
  2. 进入 "Alerts & IRM" -> OnCall。
  3. 进入 Settings 页面。
  4. 点击 Create 按钮并为您的令牌提供一个名称。
  5. 复制令牌值并妥善保管。
  6. 在 Grafana Oncall Provider 配置的 authentication 部分添加令牌值。

注意事项 ​

  • 此 provider 允许您与 Grafana OnCall 交互以创建告警。
  • Keep 将在 Grafana OnCall 内部创建一个名为 "Keep Integration" 的 "Webhook" 类型集成。

Payload 示例:

json
{
    "alert_uid": "08d6891a-835c-e661-39fa-96b6a9e26552",
    "title": "The whole system is down",
    "image_url": "https://upload.wikimedia.org/wikipedia/commons/e/ee/Grumpy_Cat_by_Gage_Skidmore.jpg",
    "state": "alerting",
    "link_to_upstream_details": "https://en.wikipedia.org/wiki/Downtime",
    "message": "Smth happened. Oh no!"
}

相关链接 ​

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