Tuist 與 Slack 的整合

Tuist 與 Slack 的整合會將建置、測試和套件大小的洞察直接呈現在你的頻道中。它讓監控從團隊必須記得去做的事情，變成自動發生的事情。例如，你的團隊可以收到每日的建置效能、快取命中率或套件大小趨勢摘要，並在關鍵指標惡化或測試變得不穩定時立即收到警示。

本頁說明此整合的功能、如何依頻道安裝，以及 Tuist 如何處理你的資料。如需了解 Tuist 如何收集、管理和儲存第三方資料的詳細資訊，請參閱我們的隱私權政策。

整合運作方式#

Tuist 透過 Slack 的Incoming Webhooks將通知傳送至 Slack。此整合僅請求incoming-webhook權限範圍。每個通知目的地（專案報告、警示規則、不穩定測試警示、自動化動作）都對應你在安裝時選擇的一個 Slack 頻道。Slack 會為每個頻道建立一個 Webhook URL，而 Tuist 會儲存該 URL 以傳送訊息。

Tuist 絕不會讀取你工作區中的訊息、成員清單或任何其他資料。此整合只會將通知寫入你已明確授權的頻道。

設定#

專案報告#

專案報告會將你專案的建置、測試和快取指標的每日摘要傳送到你選擇的 Slack 頻道。

1. 在 Tuist 儀表板中開啟你專案的通知設定。
2. 點擊選擇 Slack 頻道，並選擇你希望 Tuist 張貼訊息的工作區和頻道。Slack 會要求你授權incoming-webhook權限範圍並選擇單一頻道。
3. 選擇你希望每日報告送達的星期幾與時間。

設定完成後，Tuist 會自動將每日報告傳送到所選頻道：

警示規則#

當關鍵指標顯著惡化時，警示規則會在 Slack 中通知你，幫助你盡快發現建置變慢、快取效能下降或測試變慢的情況。

若要建立警示規則，請前往你專案的通知設定並點擊新增警示規則。你可以設定：

• 名稱：警示的描述性名稱
• 類別：要測量的項目（建置持續時間、測試持續時間、快取命中率或套件大小）
• 指標：如何彙總資料（p50、p90、p99 或平均值）
• 偏差：觸發警示的百分比變化
• 滾動視窗：要比較的最近執行次數
• 分支：針對快取命中率警示，將比較限制在單一分支上的執行。留空則考慮所有分支。套件大小警示一律針對單一分支。
• Slack 頻道：目的地頻道。你透過上述相同的incoming-webhook流程授權該頻道。

例如，你可以建立一個警示，當 p90 建置持續時間相較於前 100 次建置增加超過 20% 時觸發。

將快取命中率警示範圍限定在你的預設分支很有用，因為只有該分支會填充快取。触及低階模組的拉取請求分支合理地錯過快取，若將它們納入會導致警示在預期內的惡化時觸發。

快取命中率警示僅比較能夠公平比較的視窗。兩個視窗都必須包含與滾動視窗大小相同數量的執行，且僅出現在其中一個視窗中的快取資料來源會被排除在兩者之外。因此，尚未累積足夠兩次滾動視窗大小執行次數的分支，或名稱無法匹配的分支，永遠不會觸發規則。如果你將規則範圍限定在流量較低的分支，請將滾動視窗設得夠小，讓該分支能填滿它。

當警示觸發時，你將在 Slack 頻道中收到如下訊息：

不穩定測試警示#

當 Tuist 偵測到新的不穩定測試時，不穩定測試警示會立即觸發，幫助你在影響團隊之前發現測試不穩定的情況。

若要建立不穩定測試警示規則，請前往你專案的通知設定並點擊新增不穩定測試警示規則。你可以設定：

• 名稱：警示的描述性名稱
• 觸發閾值：過去 30 天內觸發警示所需的不穩定執行最小次數
• Slack 頻道：目的地頻道，透過incoming-webhook流程授權。

當測試變得不穩定並達到你的閾值時，你會收到包含直接連結的通知，以便調查該測試案例：

停用整合#

若要停止通知，請在 Tuist 儀表板中從報告、警示規則或自動化動作移除已設定的 Slack 頻道。若要完全撤銷 Tuist 的存取權限，請在 Slack 內部透過設定與管理 → 管理應用程式移除 webhook 整合。