# 資料保留{#data-retention}

Tuist 對上傳的構件檔案，以及用於儀表板和洞察的記錄，分別應用不同的保留政策。刪除已過期的構件檔案不會刪除其關聯的洞察記錄。

對於構件檔案，託管式 Tuist 伺服器採用基於方案的保留期，上限為 30 天。在自託管實例上，構件清理預設為停用；營運者可以選擇啟用，並為每種支援的構件類型設定獨立的保留期。

## 構件檔案{#artifact-files}

### 託管式 Tuist 伺服器{#hosted-artifact-files}

這些保留期定義了構件檔案在託管式 Tuist 伺服器上的可用時長。

| 構件 | Air 與開源 | Pro | Enterprise |
| --- | --- | --- | --- |
| 快取構件，包括 Xcode 快取、模組快取、Gradle 快取、Bazel 遠端快取檔案，以及來自 Tuist Runners 的 GitLab CI 快取歸檔 | 14 天 | 30 天 | 30 天 |
| App 預覽建構與圖示 | 30 天 | 30 天 | 30 天 |
| 建構歸檔 | 7 天 | 30 天 | 30 天 |
| 執行構件，包括結果套件與工作階段歸檔 | 7 天 | 30 天 | 30 天 |
| 測試執行附件 | 30 天 | 30 天 | 30 天 |
| 分片套件 | 7 天 | 14 天 | 30 天 |

有效的帳戶方案決定託管保留期。如果帳戶沒有有效訂閱，Tuist 會使用 Air 保留期。部分構件類型的保留期較短，因為預期它們會被重新產生。

在 Tuist 記錄測試執行識別碼之前建立的測試附件，會被排除在自動刪除之外。這些檔案會保持可用，以便 Tuist 在保留清理期間避免進行無邊界的歷史擁有權查找。

### 自託管實例{#self-hosted-artifact-files}

自託管構件清理為選擇性啟用，可針對每種構件類型分別設定，且不受 30 天上限限制。請參閱<.localized_link href="/guides/server/self-host/server#artifact-retention">自託管構件保留設定</.localized_link>以了解支援的構件類型與部署選項。

## 儀表板與活動資料{#dashboard-and-activity-data}

儀表板與活動記錄的保留政策獨立於構件檔案清理。以下保留期不因託管方案而異，包括 Enterprise。

### Xcode 建構與測試洞察 {#xcode-build-and-test-insights}

核心 Xcode 建構與測試記錄目前沒有固定的時間刪除排程。其他報告資料（例如時間軸步驟與機器指標）則有獨立的過期規則：

| 資料 | 保留期 |
| --- | --- |
| 建構摘要、每檔案與每目標的建構記錄，以及建構問題 | 沒有固定的時間刪除排程 |
| 測試執行、模組與套件結果，以及個別測試結果 | 沒有固定的時間刪除排程 |
| 建構時間軸步驟及其擷取的日誌 | 90 天 |
| 建構機器指標 | 90 天 |
| Xcode 專案圖記錄 | 30 天 |

這些記錄獨立於[構件檔案保留期](#hosted-artifact-files)所涵蓋的可下載建構歸檔、結果套件與測試附件。在 Enterprise 方案中，這些檔案會保留 30 天；相關的建構與測試記錄在檔案過期後仍然可用。沒有固定時間刪除排程的記錄並不保證永久可用。

### 其他儀表板與活動資料 {#other-dashboard-and-activity-data}

Bazel 索引剖析步驟包含可為空的每個動作遠端佇列、輸入擷取、執行與輸出上傳計時（當能安全關聯至某個動作時）。這些資料與剖析檔案共用 90 天保留期，獨立於快取構件與帳單記錄。

| 資料 | 保留期 |
| --- | --- |
| Gradle 建構記錄、任務記錄及失敗任務與設定步驟的失敗訊息、快取事件記錄、Mix 建構記錄、編譯檔案記錄、建構步驟記錄與診斷、Cargo 建構記錄（包括彙總編譯快取測量）與編譯器觀察、Bazel 叫用、Bazel 追蹤剖析、索引剖析步驟與動作診斷、待處理的 Bazel 剖析與測試攝取記錄、Bazel 叫用日誌，以及 Bazel 遠端動作快取觀察 | 90 天 |
| Bazel 叫用的開始時間，將其列為正在執行直至完成 | 2 天 |
| 持久模組詳情頁面上的 Xcode 模組編譯與快取歷史 | 30 天 |
| 持久詳情頁面上的任務、宣告的 Once 動作、Bazel BEP 動作、編譯檔案與模組觀察 | 90 天（上述 Xcode 模組除外） |
| 持久任務／動作／模組／檔案身分元數據 | 365 天（若無觀察記錄） |
| Runner 工作日誌、歸檔的 Runner 日誌，以及 Runner 工作機器指標 | 90 天 |
| 程式碼覆蓋率行詳細資料（每次測試執行的每行與每函數覆蓋率，顯示於檔案的覆蓋率頁面） | 31 天 |
| 每次測試執行的程式碼覆蓋率總計 | 365 天 |
| 提交的程式碼覆蓋率（其總計、目標與每檔案數據） | 3 年；僅由拉取請求新增的提交則為 90 天 |
| Webhook 傳送歷史 | 沒有固定的刪除排程 |

持久詳情 URL 不依賴特定建構保持可用。其身分辨識元數據可能比個別觀察記錄更長久，因此詳情頁面在所選期間內可能沒有歷史記錄。新歷史記錄從功能部署後收到的報告中建立索引；現有的執行層級歷史記錄不會回溯複製。

ClickHouse 的內部 `system.*` 運作日誌表是在 ClickHouse 層級設定，而非由 Tuist 的產品資料保留政策管理。預設情況下這些表沒有上限；捆綁的自託管 Docker Compose 和內嵌 Helm ClickHouse 設定可以限制它們，詳情請參閱<.localized_link href="/guides/server/self-host/server#capping-operational-log-retention">限制運作日誌保留</.localized_link>。
