菜单
Grafana Cloud 企业版 开源版

配置 Telegram 进行告警

使用 Grafana Alerting - Telegram 集成,可在告警触发时发送 Telegram 通知。

开始之前

Telegram 限制

Telegram 消息限制为 4096 个 UTF-8 字符。如果您使用的 parse_mode 不是 None,截断可能导致消息无效,从而导致通知失败。对于较长的消息,我们建议使用其他联系方式。

Telegram bot API token 和 chat ID

要将 Grafana 与 Telegram 集成,您需要获取 Telegram 的 **bot API token** 和 **chat ID**(即您希望接收告警通知的 Telegram 聊天的 ID)。要完成集成,请使用 Telegram 的浏览器版本。

设置您的 Telegram bot

创建一个 Telegram bot。您可以将此机器人关联到您的聊天,并使用它执行不同的操作,例如从 Grafana 接收告警。

要设置机器人,请完成以下步骤。

  1. 在您的设备上 **打开 Telegram 应用**。
  2. 找到名为 **BotFather** 的 Telegram 机器人。
  3. 输入或按下 /newbot
  4. 选择机器人的名称。名称必须以 **bot** 或 **_bot** 结尾。例如:“my_bot”。
  5. 复制 API token.

Chat ID

按照以下步骤将机器人添加到群聊。机器人添加到聊天后,您就可以将告警通知路由到该群组。

  1. 在 Telegram 应用中,**打开一个群组或开始一个新的群组**。

  2. 搜索并 **将机器人添加到群组**。

  3. 从浏览器地址栏的 URL 中复制 **chat ID**。它应该看起来像这样:https://web.telegram.org/a/#-4266674385

    chat ID 是跟随在 # 符号后面的一串数字。例如:-4266674385

步骤

要在 Grafana Alerting 中创建 Telegram 集成,请完成以下步骤。

  1. 导航到 **Alerts & IRM** -> **Alerting** -> **Contact points**。

  2. 点击 **+ Add contact point**。

  3. 输入联系点名称。

  4. 从集成列表中选择 Telegram。

  5. 在 **BOT API Token** 字段中,复制 bot API token。

  6. 在 **Chat ID** 字段中,复制 chat ID。

  7. 点击 **Test** 检查您的集成是否正常工作。

    ** 仅适用于 Grafana Alertmanager。**

  8. 点击 **Save contact point**。

下一步

Telegram 联系点已准备好接收告警通知。

要将此联系点添加到您的告警,请完成以下步骤。

  1. 在 Grafana 中,导航到 **Alerting** > **Alert rules**。
  2. 编辑或创建一个新的告警规则。
  3. 向下滚动到 **Configure labels and notifications** 部分。
  4. 在 Notifications 下点击 **Select contact point**。
  5. 从下拉菜单中选择之前创建的联系点。
  6. 点击 Save rule and exit.