Log Analytics クエリ API は、Azure Monitor ログによって収集されたデータの完全なセットに対してクエリを実行するために使用できる REST API です。 サービス全体で使用されているのと同じクエリ言語を使用できます。 この API を使用して、データを取得し、データの新しい視覚化を作成し、Log Analytics の機能を拡張します。
Log Analytics API 認証
Log Analytics API にアクセスするには、認証を行う必要があります。
- お使いのワークスペースに対してクエリを実行するには、Microsoft Entra 認証を使用する必要があります。
- Microsoft Entra 認証を使用せずに API をすばやく確認するには、API キーを使用して、非運用環境内でサンプル データにクエリを実行してください。
ワークスペース データの Microsoft Entra 認証
Log Analytics API では、3 つの異なる Microsoft Entra ID OAuth2 フローを使用した Microsoft Entra 認証がサポートされています。
- Authorization code (承認コード)
- 暗黙
- クライアントの資格情報
認証コード フローと暗黙のフローでは、どちらも、アプリケーションへの少なくとも 1 つのユーザー対話型サインインが必要となります。 非対話型フローが必要な場合は、クライアント資格情報フローを使用します。
トークンを受け取ると、Log Analytics API を呼び出すためのプロセスはすべてのフローで同じになります。 要求には、OAuth2 フローから受信したトークンが設定された Authorization: Bearer ヘッダーが必要です。
サンプル データの API キー認証
Microsoft Entra 認証を使用せずに API をすばやく確認するために、サンプル データを含むデモ ワークスペースが用意されています。 API キーを使用して認証できます。
注
Microsoft Entra 認証を使用する際、Application Insights REST API がロールベースのアクセス制御の新しいアクセス許可を認識するまでに、最大で 60 分かかる場合があります。 アクセス許可が反映されている間、REST API の呼び出しがエラーコード 403 で失敗することがあります。
Log Analytics API クエリの制限
クエリの制限の詳細については、この Web ページの「クエリ API」セクションを参照してください。
Log Analytics API の試行
コードを記述せずに API を試すには、次のようにします。
- Bruno や Insomnia などのお気に入りのクライアントを使用して、ユーザー インターフェイスを使用して手動でクエリを生成できます。
- コマンド ラインから cURL を使用します。 次に、出力を jsonlint にパイプして、読み取り可能な JSON を取得します。
REST API を直接呼び出す代わりに、慣用的な Azure Monitor Query クライアント ライブラリを使用できます。
各クライアント ライブラリは、ワークスペースからログ データを取得できるようにする REST API のラッパーです。