azure-monitor-query-py

azure-monitor-query-py 技能總覽

azure-monitor-query-py 的用途

azure-monitor-query-py 技能可讓你用 Python 搭配 azure-monitor-query 查詢 Azure Monitor 的日誌與度量。它特別適合需要檢視營運資料、建立診斷工具，或針對 Log Analytics 工作區與 Azure 資源自動化可觀測性流程的後端工程師。

這個技能最適合的情境

當你的工作是擷取 Kusto 風格的日誌結果、讀取度量，或把 Azure 監控資料串接到 Python 服務、腳本或後端工具時，就該使用 azure-monitor-query-py skill。它很適合事故處理工具、定期報表、服務健康檢查，以及資料蒐集作業。

安裝前先確認的重點

azure-monitor-query-py install 的主要判斷點，在於你是否已經有 Azure 身分驗證策略，以及正確的資源識別碼。日誌查詢需要 Log Analytics 工作區 ID；度量查詢需要資源 URI。如果你還沒有這些輸入，這個技能暫時派不上用場。

如何使用 azure-monitor-query-py 技能

安裝並確認套件可用

先使用技能提供的套件名稱，然後確認你的 Python 環境可以匯入需要的 client 類別。核心安裝指令如下：

pip install azure-monitor-query

如果你是在 repo 裡評估 azure-monitor-query-py usage，在手動加入之前，先確認專案是否已經透過 requirements.txt、pyproject.toml 或 lockfile 管理相依套件。

先備齊這個技能需要的輸入

如果是查日誌，請先準備：

• AZURE_LOG_ANALYTICS_WORKSPACE_ID
• 可讀取該工作區的 Azure credential
• 你要執行的 Kusto query
• 時間範圍或持續時間

如果是查度量，請先準備：

• AZURE_METRICS_RESOURCE_URI
• 你要查的 metric 名稱與 aggregation
• time grain 或 interval
• Azure credential

這些資訊，決定了你的 azure-monitor-query-py guide 是模糊請求，還是能直接產出實用結果的需求。

用真實工作內容來下提示

好的提示會直接說明目標資源、查詢目的與輸出格式。例如：

“使用 azure-monitor-query-py 查詢我 Log Analytics 工作區中過去 24 小時的失敗請求，依 cloud_RoleName 分組，並回傳一個會列出前 10 筆結果的 Python 範例。”

這比單純說 “show me how to use LogsQueryClient” 更有效，因為它提供了查詢意圖、時間範圍和結果格式。

先讀對的檔案

先從 SKILL.md 開始，再查看附近能確認支援用法的套件或 repo 中繼資料。對這個技能來說，最重要的實用內容通常是安裝、環境變數、驗證，以及日誌與度量的 client 範例。如果你的後端工作牽涉正式環境身分，動手寫程式前請先仔細看憑證指引。

azure-monitor-query-py 技能 FAQ

這只適用於 Azure 後端開發嗎？

不是。azure-monitor-query-py 技能也適用於任何需要 Azure Monitor 資料的 Python 工作，只是它特別適合 azure-monitor-query-py for Backend Development 這類情境，因為它很符合服務監控、警示支援與營運自動化需求。

什麼情況下不該用它？

如果你只需要儀表板、沒有 Azure 權限，或你的任務不需要直接擷取日誌或度量，就不該使用它。對於一次性的概念性問題，通常一般提示就夠了；這個技能是給真正要整合到 Python 的情境用的。

跟一般提示相比，主要差別是什麼？

一般提示可能只會理論性地解釋 Azure Monitor。azure-monitor-query-py skill 的目標，是產出可直接使用的實作步驟、client 設定，以及符合套件預期輸入與驗證模型的查詢模式。

對初學者友善嗎？

如果你已經知道要查哪個工作區或資源，那它是友善的。若你還在摸索 Azure 驗證、資源 ID 或 Kusto 語法，使用門檻就會高一些，因為這些都是取得有用結果的必要條件。

如何改進 azure-monitor-query-py 技能

直接給出精確的監控目標

最好的結果來自具體問題：像是「找出過去 30 分鐘的 5xx 回應」、「抓這台 VM 的 CPU 度量」，或「依服務名稱彙總錯誤」。明確目標能幫 azure-monitor-query-py 選對 client、查詢形式與時間範圍。

事先提供 Azure 背景資訊

請一併提供工作區 ID 或資源 URI，以及你是使用本機開發憑證還是 managed identity。如果提示裡漏了身分資訊，輸出的內容理論上可能正確，但不一定適合正式環境直接使用。

要可直接執行的程式，不要只拿到還得修的片段

請一次要求 imports、client 建立、查詢執行與結果處理。例如，你可以說希望得到一支會處理空結果、必要時分頁，並輸出結構化內容供記錄的腳本。這能減少常見的失敗模式：第一版答案技術上正確，但還不能部署。

反覆調整查詢形式與輸出格式

第一輪之後，請依後端實際需求進一步收斂：更窄的時間窗、更精準的篩選、更安全的憑證處理，或給其他服務使用的 JSON 輸出。如果你是在正式工具中使用 azure-monitor-query-py usage，通常調整查詢與輸出格式，比改變函式呼叫本身更重要。