讓攝取金鑰遠離瀏覽器
將一個小的白名單有效負載傳送到應用程式擁有的端點，然後使用伺服器端憑據和有限超時轉發它。
選擇框架
選擇知道結果的邊界
收集結果，而不是頁面內容
使用路由範本、Web Vitals、受控錯誤類別和發布欄位。排除原始 URL、DOM 文字、表單值、cookie 和任意訊息。
將瀏覽器交付視為取樣
導覽、攔截器、連線和頁面終止可能會丟失客戶端事件。不要使用盡力而為的瀏覽器收集作為精確的計費或稽核分類帳。
共享事件合約
保持第一個模式可互操作
- metric_name、metric_value、route_template、釋放和 navigation_type
- 邊緣區域、狀態、duration_ms、快取結果和環境
- 範例策略、同意狀態、有界裝置類別和相關 ID
使這些欄位適應工作流程，但在多個服務依賴同一個資料表之前保持單位、狀態類別、識別符號和所有權明確。
驗證
在發出警示之前練習故障路徑
- 1檢查生產瀏覽器捆綁包並確認它不包含 Telemetry API 金鑰。
- 2拒絕未知來源、事件名稱、欄位、值和超大實體。
- 3行使同意、阻止傳遞、頁面終止和速率限制。
- 4在每個 Web Vital、錯誤率或版本比較旁邊查詢樣本計數。
實施指南
匹配框架、提供程式或執行時
首先驗證一個端到端工作流程
建立一個免費的 API 金鑰，選擇最接近的執行時指南，並在擴大覆蓋範圍之前傳送已知的成功和失敗資訊。