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-TW.md