配置 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 接收告警。
要设置机器人,请完成以下步骤。
- 在您的设备上 **打开 Telegram 应用**。
- 找到名为 **BotFather** 的 Telegram 机器人。
- 输入或按下
/newbot
。 - 选择机器人的名称。名称必须以 **bot** 或 **_bot** 结尾。例如:“my_bot”。
- 复制 API token.
Chat ID
按照以下步骤将机器人添加到群聊。机器人添加到聊天后,您就可以将告警通知路由到该群组。
在 Telegram 应用中,**打开一个群组或开始一个新的群组**。
搜索并 **将机器人添加到群组**。
从浏览器地址栏的 URL 中复制 **chat ID**。它应该看起来像这样:
https://web.telegram.org/a/#-4266674385
。chat ID 是跟随在
#
符号后面的一串数字。例如:-4266674385
。
步骤
要在 Grafana Alerting 中创建 Telegram 集成,请完成以下步骤。
导航到 **Alerts & IRM** -> **Alerting** -> **Contact points**。
点击 **+ Add contact point**。
输入联系点名称。
从集成列表中选择 Telegram。
在 **BOT API Token** 字段中,复制 bot API token。
在 **Chat ID** 字段中,复制 chat ID。
点击 **Test** 检查您的集成是否正常工作。
** 仅适用于 Grafana Alertmanager。**
点击 **Save contact point**。
下一步
Telegram 联系点已准备好接收告警通知。
要将此联系点添加到您的告警,请完成以下步骤。
- 在 Grafana 中,导航到 **Alerting** > **Alert rules**。
- 编辑或创建一个新的告警规则。
- 向下滚动到 **Configure labels and notifications** 部分。
- 在 Notifications 下点击 **Select contact point**。
- 从下拉菜单中选择之前创建的联系点。
- 点击 Save rule and exit.