遙測{#telemetry}

您可以使用 Prometheus 和可視化工具（如 Grafana ）攝取 Tuist 伺服器收集的度量指標，以建立符合您需求的自訂儀表板。Prometheus metrics 透過/metrics 端點提供，連接埠為 9091。Prometheus 的 scrape_interval 應設為小於 10_000 秒（我們建議保持預設為 15 秒）。

Post Hog 分析{#posthog-analytics}#

Tuist 整合了 PostHog 用於用戶行為分析和事件追蹤。這可讓您瞭解使用者如何與 Tuist 伺服器互動、追蹤功能使用情況，並深入瞭解行銷網站、儀表板和 API 文件中的使用者行為。

組態{#posthog-configuration}#

PostHog 整合是可選的，可透過設定適當的環境變數來啟用。設定完成後，Tuist 會自動追蹤使用者事件、頁面檢視和使用者旅程。

環境變數	說明	必須	預設	範例
`tuist_posthog_api_key`	您的 PostHog 專案 API 金鑰	沒有		`phc_fpR9c0Hs5H5VXUsupU1I0WlEq366FaZH6HJR3lRIWVR`
`tuist_posthog_url`	PostHog API 端點 URL	沒有		`https://eu.i.posthog.com`

Analytics Enablement

只有同時設定TUIST_POSTHOG_API_KEY 和TUIST_POSTHOG_URL 時，才會啟用分析功能。如果缺少其中一個變數，就不會傳送分析事件。

特點{#posthog-features}#

啟用 PostHog 時，Tuist 會自動追蹤：

使用者識別 ：使用者以其獨特的 ID 和電子郵件地址進行識別
使用者別名 ：使用者以帳號名稱別名，以便識別
群組分析 ：使用者依其所選的專案和組織分組，以進行區隔分析
頁面區段 ：事件包含超級屬性，指出是應用程式的哪個部分產生這些事件：
- 行銷 - 來自行銷頁面和公開內容的活動
- 儀表板 - 主應用程式儀表板和認證區域的事件
- api-docs - 來自 API 文件頁面的事件
頁面檢視 ：使用 Phoenix LiveView 自動追蹤頁面導航
自訂事件 ：特定於應用程式的事件，用於功能使用和使用者互動

隱私權考量{#posthog-privacy}#

對於已認證的使用者，PostHog 使用使用者的唯一 ID 作為獨特的識別碼，並包含他們的電子郵件地址
對於匿名使用者，PostHog 使用僅記憶體的持久性，以避免在本機儲存資料。
所有分析都尊重使用者隱私權，並遵循資料保護最佳實務
PostHog的資料將依照PostHog的隱私權政策和您的設定來處理。

Elixir 度量{#elixir-metrics}#

預設情況下，我們會包含 Elixir runtime、BEAM、Elixir 和一些我們使用的函式庫的度量指標。以下是您可以預期看到的一些指標：

我們建議您查看這些頁面，以瞭解哪些指標可用以及如何使用。

運行指標{#runs-metrics}#

一套與 Tuist Runs 相關的指標。

`tuist_runs_total` (計數器){#tuist_runs_total-counter}#

Tuist Runs 的總數。

標籤{#tuist-runs-total-tags}#

標籤	說明
`姓名`	執行`tuist` 指令的名稱，例如`build`,`test` 等。
`is_ci`	一個布林值，表示執行者是 CI 或開發人員的機器。
`狀態`	`0` 在`成功的情況下`,`1` 在`失敗的情況下` 。

`tuist_runs_duration_milliseconds` (直方圖){#tuist_runs_duration_milliseconds-histogram}#

每個 tuist 執行的總時間，以毫秒為單位。

標籤{#tuist-runs-duration-miliseconds-tags}#

標籤	說明
`姓名`	執行`tuist` 指令的名稱，例如`build`,`test` 等。
`is_ci`	一個布林值，表示執行者是 CI 或開發人員的機器。
`狀態`	`0` 在`成功的情況下`,`1` 在`失敗的情況下` 。