giip

Slack 机器人设置指南

引导您如何配置 GIIP 专用 Slack 机器人 (App),以便实时接收基础设施故障及主要事件的通知。

📋 概述

Slack 机器人可将 GIIP 平台检测到的关键问题或资源短缺情况立即发送到负责人的 Slack 频道。这样,即使不一直盯着 Web 仪表板,也能快速做出响应。

🔍 核心设置步骤

1. 创建 Slack App 并获取令牌

  • Slack API 网站上进行“Create New App”。
  • Bot Type: 授予
    chat:write
    incoming-webhook
    权限。
  • Bot User OAuth Token: 复制以
    xoxb-
    开头的令牌。

2. 在 GIIP 中注册机器人

  • 在 GIIP [通知设置] 菜单中输入复制的令牌。
  • 输入接收通知的默认频道 ID(例如:
    C0123456789
    )。

3. 选择通知过滤器与类型

为了避免过多的通知干扰,请仅选择需要的类型。

  • 关键问题 (Critical Issues): 需要立即处理的项目,如服务器停机、连接中断等。
  • AI 建议 (AI Recommendations): 成本节约或资源优化建议。
  • 安全警报 (Security Alerts): 检测到异常登录尝试或安全威胁。

🛠️ 设置方法

  1. 进入 GIIP [系统管理] > [Slack 机器人设置] 菜单。
  2. 点击 [Register New Bot] 按钮,输入获取的 Bot Token频道 ID
  3. 点击 [Send Test Message],确认对应的 Slack 频道是否收到“GIIP 关联成功”消息。
  4. 通过底部的通知复选框决定要接收的事件范围并保存。

💡 技巧

  • 频道分离: 为“运维”和“研发”分别设置频道,确保每位负责人只接收到与其相关的通知。
  • 利用 Slack 命令: (后续支持)通过向 GIIP 机器人输入
    /giip status
    等命令,可以在 Slack 内即时查询当前的基础设施摘要信息。

故障排除

症状原因解决方法
点击 [Send Test Message] 后频道仍未收到"GIIP 关联成功"消息机器人未被邀请进入该频道,或频道 ID 有误将机器人邀请进目标频道,并重新确认输入的频道 ID(例如:
C0123456789
)。
保存令牌时出现认证错误输入了非
xoxb-
开头的 Bot User OAuth Token
复制 Slack 应用的 Bot User OAuth Token
xoxb-
)并重新注册。
机器人无法发布消息或显示权限错误未授予
chat:write
incoming-webhook
权限
为 Slack 应用添加相应权限后重新安装 (Reinstall) 应用。
已保存设置但收不到通知未勾选通知类型复选框选择要接收的事件类型(如 Critical Issues)并保存。

版本: 1.0 最后更新: 2026-03-19 源文件:

giipv3/public/help/slack-bot-setup.zh-CN.md