跳至主要內容
Telemetry
瀏覽說明文件
指南更新於 2026年7月30日由 Telemetry 編輯團隊和產品團隊審查閱讀約需 2 分鐘

讓程式設計代理使用這篇文件

開啟 Claude Code、Codex、Cursor 或其他編碼代理的集中提示包,然後將其適應此處介紹的工作流程。

本頁內容
  1. 手動驗證查詢
  2. 驗證條件
  3. 檢查評估歷史記錄
  4. 檢查收件人和電子郵件傳送
  5. 安全降低噪音

警示傳送和故障排除

警示有四個獨立的部分:查詢、評估點、閾值狀態和通知傳遞。按該順序檢查它們,以便電子郵件問題不會與未返回合格資料的查詢混淆。

探索操作流程示意圖:執行、審查 SQL 和結果,然後新增到儀表板或建立警示。

流程示意圖:根據已執行並審查的結果建立警示,然後分別排查評估階段與投遞階段的問題。

手動驗證查詢

開啟儲存的 Explore 或 SQL 查詢並執行警示使用的相同時間範圍。確認當警示評估一個系列時,它返回一個數值和一個按時間順序排列的時間戳列。

使用完整的桶。最新的點可能仍在變化,因此當部分填充的儲存桶可能超過閾值時,啟用忽略最後一個資料點

驗證條件

檢查:

  • 聚合,例如平均值、最大值、總和或 p95
  • 最近點數
  • 比較運算子
  • 閾值和單位
  • 評價區間
  • 查詢中的最小流量或分母保障

錯誤率警示應在計算百分比之前返回失敗和請求。延遲警示應說明該值是毫秒還是秒。

檢查評估歷史記錄

開啟警示詳細資訊頁面並檢視最近的評估狀態和事件。區分:

  • 沒有返回資料
  • 查詢執行失敗
  • 已評估但未違反的分數
  • 檢測到違規
  • 嘗試傳送通知

如果查詢失敗,請在查詢工作區中執行它並檢查表名稱、欄位型別、SQL 相容性和設定的時間戳列。

檢查收件人和電子郵件傳送

確認收件人地址是最新的且不包含空格或複製貼上內容。檢查垃圾郵件過濾並允許來自設定的 Telemetry 發件人的郵件。在設定過程中使用受控測試閾值,然後在確認交付後恢復生產閾值。

不要僅僅為了測試而反覆降低生產警示閾值。當尋呼或收入工作流程可能受到影響時,克隆或暫時隔離測試。

安全降低噪音

在通知之前需要多個完整點、最小數量或絕對影響閾值。將資訊生命週期變更傳送至預定審查;保留針對情況的立即警示,並有明確的所有者和回應。

閱讀 警示,然後使用每個 SQL配方 附帶的警示指南。

相關產品功能

將審查的 SQL 提升到自有閾值和回應工作流程中。

內容責任與技術參考

Telemetry 編輯團隊負責維護本文;產品團隊審查功能行為、範例和適用範圍。

檢視編輯規範