# Tuist 與 Slack 的整合 {#slack}
Tuist 與 Slack 的整合會將建置、測試和套件大小的洞察直接呈現在你的頻道中。它讓監控從團隊必須記得去做的事情，變成自動發生的事情。例如，你的團隊可以收到每日的建置效能、快取命中率或套件大小趨勢摘要，並在關鍵指標惡化或測試變得不穩定時立即收到警示。
本頁說明此整合的功能、如何依頻道安裝，以及 Tuist 如何處理你的資料。如需了解 Tuist 如何收集、管理和儲存第三方資料的詳細資訊，請參閱我們的[隱私權政策](https://tuist.dev/privacy)。
## 整合運作方式 {#how-it-works}
Tuist 透過 Slack 的[Incoming Webhooks](https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks)將通知傳送至 Slack。此整合僅請求`incoming-webhook`權限範圍。每個通知目的地（專案報告、警示規則、不穩定測試警示、自動化動作）都對應你在安裝時選擇的一個 Slack 頻道。Slack 會為每個頻道建立一個 Webhook URL，而 Tuist 會儲存該 URL 以傳送訊息。
Tuist 絕不會讀取你工作區中的訊息、成員清單或任何其他資料。此整合只會將通知寫入你已明確授權的頻道。
## 設定 {#setup}
### 專案報告 {#project-reports}
專案報告會將你專案的建置、測試和快取指標的每日摘要傳送到你選擇的 Slack 頻道。
1. 在 Tuist 儀表板中開啟你專案的通知設定。
2. 點擊**選擇 Slack 頻道**，並選擇你希望 Tuist 張貼訊息的工作區和頻道。Slack 會要求你授權`incoming-webhook`權限範圍並選擇單一頻道。
3. 選擇你希望每日報告送達的星期幾與時間。
設定完成後，Tuist 會自動將每日報告傳送到所選頻道：
> [!NOTE] PRIVATE CHANNELS
>
> 若要張貼至私人頻道，請先在 Slack 中開啟該頻道，並在授權步驟期間將其新增至整合可見的頻道清單中。
>
### 警示規則 {#alert-rules}
當關鍵指標顯著惡化時，警示規則會在 Slack 中通知你，幫助你盡快發現建置變慢、快取效能下降或測試變慢的情況。
若要建立警示規則，請前往你專案的通知設定並點擊**新增警示規則**。你可以設定：
- **名稱**：警示的描述性名稱
- **類別**：要測量的項目（建置持續時間、測試持續時間、快取命中率或套件大小）
- **指標**：如何彙總資料（p50、p90、p99 或平均值）
- **偏差**：觸發警示的百分比變化
- **滾動視窗**：要比較的最近執行次數
- **分支**：針對快取命中率警示，將比較限制在單一分支上的執行。留空則考慮所有分支。套件大小警示一律針對單一分支。
- **Slack 頻道**：目的地頻道。你透過上述相同的`incoming-webhook`流程授權該頻道。
例如，你可以建立一個警示，當 p90 建置持續時間相較於前 100 次建置增加超過 20% 時觸發。
將快取命中率警示範圍限定在你的預設分支很有用，因為只有該分支會填充快取。触及低階模組的拉取請求分支合理地錯過快取，若將它們納入會導致警示在預期內的惡化時觸發。
快取命中率警示僅比較能夠公平比較的視窗。兩個視窗都必須包含與滾動視窗大小相同數量的執行，且僅出現在其中一個視窗中的快取資料來源會被排除在兩者之外。因此，尚未累積足夠兩次滾動視窗大小執行次數的分支，或名稱無法匹配的分支，永遠不會觸發規則。如果你將規則範圍限定在流量較低的分支，請將滾動視窗設得夠小，讓該分支能填滿它。
當警示觸發時，你將在 Slack 頻道中收到如下訊息：
> [!NOTE] COOLDOWN PERIOD
>
> 警示觸發後，同一規則在 24 小時內不會再次觸發。這可防止當指標持續偏高時造成通知疲勞。
>
### 不穩定測試警示 {#flaky-test-alerts}
當 Tuist 偵測到新的不穩定測試時，不穩定測試警示會立即觸發，幫助你在影響團隊之前發現測試不穩定的情況。
若要建立不穩定測試警示規則，請前往你專案的通知設定並點擊**新增不穩定測試警示規則**。你可以設定：
- **名稱**：警示的描述性名稱
- **觸發閾值**：過去 30 天內觸發警示所需的不穩定執行最小次數
- **Slack 頻道**：目的地頻道，透過`incoming-webhook`流程授權。
當測試變得不穩定並達到你的閾值時，你會收到包含直接連結的通知，以便調查該測試案例：
## 停用整合 {#disconnect}
若要停止通知，請在 Tuist 儀表板中從報告、警示規則或自動化動作移除已設定的 Slack 頻道。若要完全撤銷 Tuist 的存取權限，請在 Slack 內部透過**設定與管理 → 管理應用程式**移除 webhook 整合。