儲存的查詢、歷史記錄、收藏夾和協作
儲存的查詢將調查轉變為可重用的團隊工件。 Telemetry 在團隊工作區內組織查詢，保留查詢歷史記錄，並讓每個人收藏他們最常返回的查詢。
儲存 SQL 不會使度量正確。在其他人或自動化工作流程依賴事件粒度、過濾器、分母、單位和時間邊界之前對其進行檢查。
選擇一個工作區
使用工作區按服務、產品領域、操作工作流程或團隊對相關分析進行分組。工作區可以巢狀，這樣可以讓一個廣闊的區域包含更集中的集合，而無需將每個查詢強制放入一個平面列表中。
保持結構足夠淺以便掃描。一個實際的安排可能是：
reliability
api
background-jobs
product
activation
retention
ai
model-cost
agent-quality
團隊成員資格控制誰可以看到工作區和儲存的查詢。工作區名稱（例如“個人”）描述了組織或所有權；它不會使該工作區成為私有的。每個團隊成員都可以存取團隊的工作區分析，因此當查詢包含針對較小受眾的識別符號或操作詳細資訊時，請使用單獨的團隊。
儲存並命名查詢
從草稿開始，針對代表性時間範圍執行查詢，然後檢查結果。當準備好保留時：
- 將其儲存在擁有該決策的工作區中。
- 如果有用的話，用結果、範圍和單位重新命名它。
- 除了比率和百分位數之外，還應保留數量。
- 僅在審查儲存的版本後才將結果新增到儀表板。
優先選擇 API error rate by route — production 而不是 query 14 或 incident query。名稱應該幫助人們找到並解釋查詢，而無需開啟每個結果。
瞭解查詢歷史記錄
儲存更改會建立查詢歷史記錄。使用歷史記錄條目可以回顧 SQL 的演變過程，並在編輯意外更改結果時恢復之前的邏輯。
在對共享查詢進行重大更改之前：
- 注意新舊指標定義；
- 在同一固定視窗上比較兩個版本；
- 識別使用查詢的儀表板、警示或報告；
- 保留以前的版本，直到消費者審查更改；
- 當含義發生變化時更新說明性儀表板文字。
當查詢支援受監管的報告、存取決策或精確的財務對賬時，歷史記錄並不能替代更廣泛的稽核追蹤或程式碼審查流程。
使用收藏夾作為個人快捷方式
最喜歡的是個人導覽輔助工具。收藏查詢不會更改其工作區、權限、SQL 或其他團隊成員的狀態。使用收藏夾來檢視活動事件檢視、每週回顧或重複出現的產品問題，而無需重複共享查詢。
促進穩定結果
儲存的查詢可以變成：
- 儀表板圖表或結果資料表；
- 具有明確閾值和所有者的警示；
- 可重複匯出；
- 更深入調查的起點。
將儲存的查詢保留為可檢查的分析定義。將回應說明和所有權放在儀表板或警示旁邊，以便在移交過程中工件仍然易於理解。
協作清單
在廣泛共享已儲存的查詢之前，請確認：
- 每個團隊成員都是工作區和查詢的目標受眾。
- 標題描述了結果和單位。
- SQL 使用記錄欄位和計數規則。
- 已檢查代表性固定裝置或已知間隔。
- 廣泛的儀表板中省略了敏感的原始識別符號。
- 重大變化與之前的歷史條目進行比較。
- 每個警示都有一個所有者、評估視窗和回應操作。