警示

Telemetry 警示可讓您監控查詢輸出，並在指標超過閾值時透過電子郵件收到通知。

使用 警示 API 以程式設計方式列出、建立、更新或刪除這些警示定義。

為什麼警示從一條時間序列線開始

Telemetry 有意使建立警示可用於狹窄的結果形狀：x 軸上帶有時間的折線圖，y 軸上有一個數字指標，並且沒有 分組依據或分割依據 維度。這是警示模型的一部分，而不僅僅是圖表限制。

單個時間序列線為警示提供了人們可以解釋和檢視的定義：

• 每個點都針對連續的時間段提出相同的問題。
• 每個值都具有相同的指標、單位、過濾器和總體。
• “最後 N 個資料點”對映到最近儲存桶的有序集合。
• 閾值產生一種狀態：訊號要麼在預期範圍內，要麼不在預期範圍內。

多系列圖表對於調查很有用，但它使重要的警示行為未定義。警示應該在任何線路超過閾值時觸發還是僅在每條線路都超過閾值時觸發？每個路線、客戶、區域或版本是否應該有單獨的狀態和通知？當一系列消失、出現新值或一個閾值不適合每個組時會發生什麼？ Telemetry不會默默地為你選擇那些語義。

儀表板可以保留多行比較和廣泛的上下文。警示應該是一個小的、確定性的斷言，有一個所有者和一個回應。該行後面的查詢仍然可以包含連線、過濾器、比率、最小量保護或其他複雜邏輯；它的最終結果應該將該邏輯簡化為一個有序訊號。

將分組圖表變成警示

如果有用的儀表板圖表有幾行：

1. 將多系列版本保留在儀表板上以進行比較和診斷。
2. 選擇具有所有者和回應的特定條件。
3. 過濾到一個總體或在 SQL 中故意聚合這些組。
4. 返回一個明確的時間段和每個時間段的一個數值。
5. 選擇 折線圖表並刪除分組依據或分割依據。
6. 當不同的組需要不同的閾值、所有者或回應程式時，建立單獨的警示。

如果建立警示不可見，請首先檢查結果形狀。在探索中，使用不帶 分割依據的折線圖。對於 SQL 結果，使用折線圖，選擇 x 軸的時間列和 y 軸的數值，並將分組依據設定為無。

警示如何工作

每個警示評估都遵循相同的流程：

1. 執行儲存的查詢（來自“探索”或 SQL 查詢）。
2. 按時間戳對行進行排序（最新的在前）。
3. 如需略過最新資料列，請啟用 Ignore the last data point。
4. 取最後一個 N 資料點。
5. 計算聚合（avg、sum、p95 等）。
6. 將該值與您的閾值進行比較。
7. 當狀態發生變化（觸發或解決）時傳送通知。

從“探索”建立警示

1. 開啟/team/{team}/table/{table}?tab=explore。
2. 選擇一個折線圖表、一個指標、一個時間範圍和任何過濾器。
3. 將 Split by 留空，這樣結果就是一行。
4. 點選執行。
5. 在圖表上方的結果工具欄中，點選“建立警示”。
6. 設定條件、間隔和收件人。
7. 點選“建立警示”進行儲存。

執行“探索”查詢後，警示按鈕將顯示在結果工具欄右側的新增到儀表板旁邊：

建立後，您將登入/team/{team}/alert/{alertSlug}，您可以在其中檢查狀態和事件歷史記錄。

根據 SQL 查詢結果建立警示

1. 開啟一個儲存的查詢，該查詢返回一個時間列和一個數字訊號。
2. 執行查詢並切換到 圖表 選項卡。
3. 選擇 折線圖表，將時間列設定為 x 軸，將數字訊號設定為 y 軸，並將分組依據保留為無。
4. 從“結果”或“圖表”選項卡中點選“建立警示”。
5. 選擇聚合和閾值邏輯。
6. 儲存並驗證警示詳細資訊頁面。

警示條件欄位

互動式內嵌範例

/team/{team}/table/{table}?tab=explore&graphType=line&agg=p95&metric=latency_ms&time=7d

SELECT
  date_trunc('minute', timestamp_utc) AS time_bucket,
  COUNT(*) AS errors
FROM
  http_logs
WHERE
  status_code >= 500
  AND timestamp_utc >= now() - INTERVAL '2 hours'
GROUP BY
  time_bucket
ORDER BY
  time_bucket DESC;

故障排除

1. 無通知：驗證收件人電子郵件是否有效並啟用警示。
2. 誤報：增加 Last N data points 或保持 Ignore last data point 啟用。
3. 警示永遠不會觸發：降低閾值或確認所選指標列是數字。