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

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

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

本頁內容
  1. 保持報告合約的約束
  2. 審查失敗和審查佇列
  3. 使查詢可操作

使用 SQL 進行安全稽核分析

當每個特權操作都有受控操作名稱、資源類、參與者角色、策略結果和審查狀態時,安全報告就會變得有用。自由格式的訊息使這些維度難以比較,並且可能意外地包含憑據或私人資源內容。

保持報告合約的約束

當特權操作達到最終結果時發出事件。建議欄位包括 actionresource_typeactor_roleoutcomerequires_reviewpolicy_versionenvironmenttimestamp_utc。通用儀表板通常需要角色類,而不是電子郵件地址。將批准的參與者和資源識別符號置於具有存取記錄的受限調查路徑中。

切勿收集密碼、API-金鑰值、會話權杖、授權標頭、原始匯出、不受限制的請求正文或完整策略輸入。安全遙測不會自動成為不可變的合規性存檔;與安全所有者一起定義證據儲存、保留和存取要求。

審查失敗和審查佇列

特權操作審查 SQL 配方 按失敗或被拒絕的份額對操作類別進行排名,並將絕對審查量保持在相同的輸出中。其確定性夾具可以在 SQL遊樂場 中本地執行。

報警前,對結果進行分類:

  1. 預期的政策拒絕可以表明控制措施正在發揮作用。
  2. 同一批准的參與者類別重複否認可能需要調查。
  3. 新的特權操作可以指示檢測或部署更改。
  4. 即使每個操作都成功,不斷成長的 requires_review 佇列也會帶來操作所有權問題。

使用 身分驗證失敗的秘訣 實現登入結果,而不是將身分驗證嘗試與管理操作混合在一起。

使查詢可操作

儀表板應顯示總操作、被拒絕或失敗的操作、失敗率、需要審查的計數和策略版本。警示應要求審查條件,例如重複拒絕的嘗試、新穎的操作類別或逾期的審查佇列。

安全稽核分析用例 提供儀器提示。還要在生產者邊界應用 敏感資料脫敏指南,以便不安全的值永遠不會進入資料表中。

相關產品功能

對結構化事件資料表執行只讀 DataFusion SQL 並重用結果。

內容責任與技術參考

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

檢視編輯規範