跳至主要內容
Telemetry
Telemetry SQL 手冊

SQL日誌分析和可觀測性秘訣

將日誌分析為型別化、結構化的事件資料表。從問題開始,然後提出查詢和圖表。每個查詢範例都將現真實模式與可複製的 DataFusion SQL、合成結果資料、有用的視覺化、公共 JSON 和 CSV 裝置、解釋註釋、邊緣案例以及儀表板或警示建議配對。

對這種方法不熟悉嗎?閱讀 SQL 可觀測性和事件分析指南 瞭解查詢範例背後的事件模型、架構、查詢模式和遷移權衡。

Planned and executed with Apache DataFusion 45.2.0
具有視覺預覽的可抓取結果資料表
可下載的 JSON、CSV 和靜態 SVG 資源
用於多資料表學習的連線 SaaS 資料集
用於可複製裝置的只讀瀏覽器遊樂場
操作邊緣情況和警示指導
綜合範例——無客戶資料

81

完整的 SQL 查詢範例

12

運營和產品類別

1:1

query-to-result visualizations

互動式 SQL 實驗室

跨產品、API、AI、職位、計費和資料庫關注一個帳戶

查詢範例頁面一次解釋一種分析模式。 SQL 實驗室新增了版本化的 15 個資料表資料集和針對實際連線、啟用漏斗、LLM 單元經濟學、事件影響、重試恢復和資料庫可靠性的指導課程。

啟動 SQL 實驗室

可重現的 SQL

語法檢查是自動化的;解釋保持明確

每個發布的查詢必須是隻讀的,包括型別化的事件契約,併成功地計劃和執行 阿帕奇 DataFusion 45.2.0。綜合結果、業務定義和邊緣情況要單獨審查,因為有效的 SQL 仍然可能回答錯誤的問題。

菜譜合集

API 可靠性

12 recipes
入門api_requests

按路由計算API錯誤率

使用 SQL 按 5xx 錯誤率對 API 路由進行排名,同時保護結果免受低音量噪音的影響。

檢視 SQL 和結果
中級api_requests

計算 p50、p95 和 p99 API 延遲

使用 DataFusion 相容的百分位數 SQL 按端點比較中值和尾部延遲。

檢視 SQL 和結果
中級api_requests

計算 API 錯誤預算消耗率

將每小時的請求失敗轉化為 SLO 消耗率系列,顯示允許的錯誤預算消耗的速度。

檢視 SQL 和結果
中級api_requests

按版本比較 API 可靠性

比較跨應用程式版本的流量、5xx 速率和 p95 延遲,無需將每個部署後更改都歸因於部署。

檢視 SQL 和結果
入門api_requests

按客戶影響對錯誤指紋進行排名

按發生次數和受影響的帳戶對標準化應用程式錯誤進行排名,而不是讓一個重試迴圈主導事件檢視。

檢視 SQL 和結果
入門api_requests

按路由計算API超時率

按超時率對路由進行排名,同時保留請求量和設定的超時邊界。

檢視 SQL 和結果
中級dependency_calls

比較依賴性 p95 延遲

查詢對請求造成最大尾部延遲的資料庫、API、快取和佇列。

檢視 SQL 和結果
中級api_requests

根據 SLO 衡量 API 可用性

計算每日可用性並顯示服務是否達到其明確的目標。

檢視 SQL 和結果
入門api_throughput_events

按路由計算 API 請求吞吐量

透過穩定的 API 路由計算觀察到的每分鐘請求數,並在吞吐量旁邊保留錯誤量。

檢視 SQL 和結果
中級api_attempt_events

測量 API 429 速率限制恢復

測量速率限制請求在稍後嘗試中恢復的頻率,而不將每次重試都視為新請求。

檢視 SQL 和結果
入門feature_rollout_events

比較功能推出錯誤率

比較一個版本的功能標記部署和控制組之間的請求錯誤和平均延遲。

檢視 SQL 和結果
中級incident_account_impact_events

按計劃衡量事件對客戶的影響

按計劃計算受影響的帳戶和平均影響持續時間,而無需暴露客戶名稱或原始請求資料。

檢視 SQL 和結果

菜譜合集

背景工作

6 recipes

菜譜合集

網路鉤子

3 recipes

菜譜合集

人工智慧和法學碩士

8 recipes

菜譜合集

產品分析

9 recipes
中級product_events

使用 SQL 建置註冊到啟用渠道

透過註冊、入職、整合和第一價值里程碑計算唯一使用者轉化。

檢視 SQL 和結果
高階product_events

計算每週群組保留率

按第一個活動周對使用者進行分組,並衡量隨後幾周的返回百分比。

檢視 SQL 和結果
高階product_events

查詢升級前使用的功能

加入功能事件以升級事件並對付費轉化之前發生的行為進行排名。

檢視 SQL 和結果
高階product_events

計算 DAU、WAU 和產品粘性

一起衡量每日和每週的活躍使用者,並根據一致的活動定義計算 DAU 到 WAU 的粘性。

檢視 SQL 和結果
中級product_events

按獲取來源比較渠道轉化

按獲取來源衡量註冊到啟用的轉化,同時消除重複的里程碑事件。

檢視 SQL 和結果
高階product_events

測量啟用時間

計算使用者註冊和執行第一個有意義的產品操作之間經過的時間分佈。

檢視 SQL 和結果
高階product_events

按群組衡量流失和重新啟用

將帳戶分類為保留帳戶、流失帳戶或因重複的有意義的產品活動而重新啟用的帳戶。

檢視 SQL 和結果
高階experiment_events

比較實驗轉化和收入提升

透過實驗變數衡量轉化率、每個參與者的收入以及相對提升,而無需重複計算重複事件。

檢視 SQL 和結果
中級product_journey_events

按會話衡量產品旅程下降情況

衡量有多少會話達到每個訂購產品的里程碑,並計算旅程完成度和逐步轉化率。

檢視 SQL 和結果

菜譜合集

結構化事件

4 recipes

菜譜合集

資料品質

6 recipes

菜譜合集

收入和賬單

5 recipes

菜譜合集

基礎設施

4 recipes

菜譜合集

安全和稽核

7 recipes

菜譜合集

資料庫可靠性

12 recipes
入門database_query_events

透過指紋查詢緩慢的資料庫查詢

按慢查詢率、平均持續時間和最差觀察持續時間對規範化資料庫操作進行排名,無需儲存原始 SQL 或參數。

檢視 SQL 和結果
入門database_pool_samples

測量資料庫連線池飽和度

按應用程式服務測量平均池利用率、排隊獲取等待、超時和空閒容量。

檢視 SQL 和結果
中級database_transaction_events

計算資料庫事務回滾率

按服務比較已提交和回滾的事務,同時保留錯誤類別、持續時間和受影響的帳戶。

檢視 SQL 和結果
中級database_lock_wait_events

查詢資料庫鎖等待和死鎖

按事件計數、等待持續時間、未解決的鎖定和檢測到的死鎖對阻塞的資料庫操作指紋進行排名。

檢視 SQL 和結果
入門database_replication_samples

測量資料庫複製和 CDC 延遲

透過平均延遲、最差延遲、落後位元組數和過時取樣率來比較副本和更改資料捕獲消費者。

檢視 SQL 和結果
入門database_migration_events

按版本追蹤資料庫遷移失敗

在完成部署之前,按應用程式版本比較資料庫遷移的成功、失敗、回滾和持續時間。

檢視 SQL 和結果
中級database_request_query_events

檢測 N+1 資料庫查詢模式

檢測在一個應用程式請求內多次重複的資料庫指紋。

檢視 SQL 和結果
入門database_query_events

按總時間影響對資料庫查詢進行排名

結合呼叫量和延遲來查詢消耗最多應用程式時間的資料庫指紋。

檢視 SQL 和結果
中級database_transaction_events

測量長時間執行的資料庫事務

查詢具有長尾、回滾和開放持續時間過長的應用程式事務類。

檢視 SQL 和結果
入門database_error_events

透過 SQLSTATE 和版本分析資料庫錯誤

按可移植 SQLSTATE 類、應用程式操作和發布對資料庫故障進行分組。

檢視 SQL 和結果
中級database_connection_events

測量資料庫連線超時和改動

按服務和區域比較連線開啟、關閉、獲取超時以及受影響的請求。

檢視 SQL 和結果
高階database_replica_read_events

按區域測量資料庫副本的陳舊程度

按區域比較應用程式觀察到的副本重播延遲、陳舊讀取和故障轉移結果。

檢視 SQL 和結果

菜譜合集

前端可靠性

5 recipes

使用您自己的事件

更換樣品臺並保留分析模式

Telemetry 從結構化事件建立資料表。一旦欄位流動,調整查詢範例,儲存結果,並將其轉變為共享儀表板或警示。

獲取 API 金鑰