スキル Azure Monitor Query SDK for Python
📦

Azure Monitor Query SDK for Python

安全 🔑 環境変数

Python SDK を使用して Azure Monitor のログとメトリックをクエリする

開発者は適切な SDK ガイダンスがないため、Azure Monitor データを効率的にクエリするのに苦労しています。このスキルは、認証パターンを含む Log Analytics および Metrics Query クライアントのすぐに使えるコード例を提供します。

対応: Claude Codex Code(CC)
🥉 72 ブロンズ
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「Azure Monitor Query SDK for Python」を使用しています。 期間別に上位 10 件のリクエストをワークスペースにクエリする

期待される結果:

  • LogQueryClient を使用したコードでクエリを生成:AppRequests | top 10 by DurationMs
  • レスポンスはテーブルと行を反復処理してリクエストデータを出力する
  • 時間範囲設定のために timedelta を含む

「Azure Monitor Query SDK for Python」を使用しています。 5 分間隔で VM の CPU メトリックを取得する

期待される結果:

  • 環境変数からリソース URI を取得する MetricsQueryClient を使用したコード
  • Average 集計で Percentage CPU メトリックをクエリする
  • timeseries データをループしてタイムスタンプと値を出力する

セキュリティ監査

安全
v1 • 2/25/2026

This skill contains documentation and code examples for the Azure Monitor Query SDK for Python. Static analysis scanned 0 files with 0 lines of executable code, resulting in a risk score of 0/100. The skill is prompt-only with no executable code, containing reference documentation for querying Log Analytics workspaces and Azure Monitor metrics. Environment variable access is documented for Azure authentication but poses no security risk as these are standard Azure SDK configuration patterns.

0
スキャンされたファイル
0
解析された行数
1
検出結果
1
総監査数

リスク要因

🔑 環境変数 (1)
監査者: claude

品質スコア

38
アーキテクチャ
100
保守性
87
コンテンツ
50
コミュニティ
100
セキュリティ
74
仕様準拠

作れるもの

アプリケーションのヘルスを監視する DevOps エンジニア

Log Analytics からアプリケーションのリクエストレート、エラー数、応答時間をクエリして、本番環境監視のためのダッシュボードとアラートを作成する

パフォーマンスの問題を調査するデータアナリスト

Kusto クエリを実行して、Azure Monitor に保存されているアプリケーションパフォーマンスデータ内の低速なリクエスト、例外、ボトルネックを特定する

リソース使用状況を分析するクラウドアーキテクト

Azure Monitor メトリックをクエリして、Azure インフラストラクチャ全体で CPU 使用率、ネットワークトラフィック、リソース消費パターンを分析する

これらのプロンプトを試す

基本ログクエリ
Python で LogsQueryClient を使用して、過去 1 時間の AppRequests を ResultCode ごとにグループ化してカウントする Kusto クエリを記述する
時間範囲クエリ
2024 年 1 月 1 日から 2 日の特定の日付範囲で AppExceptions を Log Analytics でクエリする。Python で適切なタイムゾーン処理を行う
集計付きメトリック
MetricsQueryClient を使用して、5 分粒度で Average、Maximum、Minimum の集計を使用して CPU パーセンテージの Azure Monitor メトリックをクエリする
複数のワークスペースのバッチクエリ
複数の Log Analytics ワークスペースでバッチクエリを実行して、AppRequests と AppExceptions を同時に取得し、部分的な結果とエラーを適切に処理する

ベストプラクティス

  • 複数の認証タイプをサポートする安全な認証のために DefaultAzureCredential を使用する
  • データ量を制限してクエリパフォーマンスを向上させるために、適切な時間範囲と粒度を設定する
  • LogsQueryStatus 確認を使用して部分的な結果と失敗を適切に処理する

回避

  • ワークスペース ID やリソース URI をハードコードしない - 常に環境変数を使用する
  • 時間制限なしでクエリしない - 過度なデータが返され、高額なコストが発生する可能性がある
  • 部分的な結果を無視しない - レスポンスを処理する前に必ず LogsQueryStatus を確認する

よくある質問

Log Analytics をクエリするには、どのような Azure 権限が必要ですか?
ワークスペースに対する Log Analytics Reader ロールまたはそれ以上の権限が必要です。メトリックの場合は、リソースに対する Reader アクセスが必要です。
Azure Monitor Query SDK で認証するにはどうすればよいですか?
マネージド ID、Azure CLI、環境認証情報など、複数の認証方法を自動的に試行する DefaultAzureCredential を使用します。
Log Analytics をクエリするコストはいくらですか?
Log Analytics はスキャンされたデータ量(GB 単位)に対して課金されます。時間範囲、フィルタ、プロジェクションでクエリを最適化してコストを削減します。
1 つのリクエストで複数のワークスペースをクエリできますか?
はい、LogsBatchQuery オブジェクトを使用したバッチクエリ機能を使用して、1 つの API 呼び出しで複数のクエリを効率的に実行できます。
SDK はどの時間形式を受け付けますか?
相対時間(例:過去 1 時間)には Python timedelta を、絶対時間範囲にはタイムゾーン情報を含む datetime オブジェクトを使用します。
SDK で非同期操作を処理するにはどうすればよいですか?
aio モジュールクライアント(LogsQueryClient、MetricsQueryClient)を async/await 構文で使用し、クライアントと認証情報を閉じることを忘れないでください。

開発者の詳細

ファイル構成

📄 SKILL.md