Azure portal のログ分析ツールを使用すると、Azure Monitor Logs ストア内のデータに対するログ クエリの実行と編集を行うことができます。 基本的なユーザーと上級ユーザーの両方について、ログ データの探索と分析を簡単にする 2 つのモードが用意されています。
簡易モードでは、最もよく使われる Azure Monitor ログ機能が、スプレッドシートに似た直感的なエクスペリエンスで提供されます。 ポイントしてクリックするだけで、データをフィルター処理、並べ替え、集計して、ほとんどの場合必要な分析情報を取得できます。
KQL モード を使用すると、高度なユーザーは Kusto クエリ言語 (KQL) を最大限に活用して、Log Analytics クエリ エディターを使用してログからより深い分析情報を得ることができます。
クエリの結果は、対話形式で使用するか、ログ検索通知やブックなど他の Azure Monitor の機能とともに使用します。 Log Analytics は、それらを書き込んでテストするために使用するツールです。
この記事では、Log Analytics のユーザー インターフェイスとその機能について説明します。 チュートリアルに直接進む場合は、「Log Analytics のチュートリアル」を参照してください。
概要ビデオ
Log Analytics を開く
Azure Portal で Log Analytics を開くには、Azure Monitor、Log Analytics ワークスペース、または特定のリソースのいずれかで [ログ] を選択します。 ツールは常に同じですが、開始する場所によって使用可能なデータが決まります。
Azure Monitor または Log Analytics ワークスペースからログを開くと、ワークスペース内のすべてのレコードにアクセスできます。 別の種類のリソースから [ログ] を選択した場合、データはそのリソースのログ データに制限されます。 詳細については、「Azure Monitor Log Analytics のログ クエリのスコープと時間範囲」を参照してください。
Log Analytics を起動すると、クエリの例を含むダイアログが表示されます。 クエリはソリューション別に分類されます。 要件に一致するクエリを参照または検索します。 必要なものを正確に実行するものが見つかる場合があります。 エディターに読み込んで、必要に応じて変更することもできます。 クエリの例を参照することは、独自のクエリを記述する方法を学ぶのに最適です。
空のスクリプトからクエリを自分で作成する場合は、クエリの例を閉じてください。 サンプル クエリにもう一度アクセスする場合は、画面の上部または左側のサイドバーから [ クエリ] ハブ を選択します。
Log Analytics のインターフェイス
次の図は、単純モードの 4 つの Log Analytics コンポーネントを示しています。
上部アクション バー
単純モードでは、上部のバーには、データを操作して KQL モードに切り替えるためのコントロールがあります。
| オプション | 説明 |
|---|---|
| 時間範囲 | クエリで使用できるデータの時間範囲を選択します。 KQL モードでは、クエリ内で別の時間範囲を設定すると、時間ピッカーで設定した時間範囲が上書きされます。 |
| 表示 | Log Analytics が単純モードで取得するエントリの数を構成します。 既定の制限は 1000 です。 クエリの制限について詳しくは、「クエリ結果の制限を構成する」をご覧ください。 |
| 追加 | 単純モードでのデータの探索と分析の説明に従って、フィルターを追加 し、単純モード演算子を適用します。 |
| 簡易モードと KQL モード | 簡易モードと KQL モードを切り替えます。 |
注
単純モードでは、上部のアクション バーに [実行 ] ボタンは含まれません。 ユーザーがクエリを絞り込むにつれて、結果が自動的に更新されます。
左側サイドバー
折りたたみ可能な左側ペインでは、テーブル、クエリの例と保存済みクエリ、関数、クエリ履歴にアクセスできます。
左ペインをピン留めすると、作業中も開いたままになります。必要なときにクエリ ウィンドウを最大にするには、左側のペインでアイコンを選びます。
| オプション | 説明 |
|---|---|
| テーブル | 選択したスコープに含まれるテーブルが一覧表示されます。 テーブル名にポインターを合わせると、テーブルの説明とドキュメントへのリンクが表示されます。 テーブルを展開すると、その列が表示されます。 プレビューを実行するテーブルを選択します。 |
| クエリ | クエリの例と保存済みクエリが一覧表示されます。 これは、クエリ ハブにあるのと同じ一覧です。 検索バーの横にあるコンテキスト メニュー [...] を開き、[ グループ化 ] を選択してクエリのグループ化を変更します。 クエリにポインターを合わせると、クエリの説明が表示されます。 クエリを選択して実行します。 |
| 関数 | 関数が一覧表示されます。関数を使用して、事前定義されたクエリ ロジックをログ クエリで再利用できます。 |
| クエリ履歴 | クエリ履歴を一覧表示します。 クエリを選択して再実行します。 |
注
テーブル ビューには、既定では空のテーブルは表示されません。
現在のセッションのコンテキスト メニューを変更するには、検索バーの横
...コンテキスト メニューを開き、[データのないテーブルを表示] を選択します。空のテーブルを 完全に表示または非表示にするには、コンテキスト メニュー
...上部のアクション バーを開き、[ Log Analytics の設定] を選択し、[ データのないテーブルの表示] を切り替えて、変更を 保存 します。
クエリの履歴
クエリ履歴は、リソースに対して実行したクエリを記録し、後で再実行できるようにします。 次のセクションでは、クエリ履歴の格納場所、保持期間、サポートされていないシナリオについて説明します。
リージョンのストレージとリソースのスコープ
クエリ履歴はリソース中心であり、リージョンスコープです。 Log Analyticsは、クエリを実行するリソースと同じリージョンに履歴を格納します。これは、データ所在地とコンプライアンスの要件をサポートします。 その結果、表示される履歴は、リソースとそのリージョンの両方によって異なります。
- Log Analytics ワークスペース、Application Insights リソース、仮想マシンなどのリージョン リソースは、リソースの独自のリージョンに履歴を格納します。 異なるリージョンの 2 つのリソースは履歴を共有しません。
- リージョンがないグローバル リソースは、クラウドの固定の既定のリージョンにルーティングされます。 パブリック Azure クラウドでは、既定のリージョンは西ヨーロッパです。
スコープもリソースの種類によって異なります。 各Log Analyticsワークスペースは独自の独立した履歴を保持するため、ワークスペース A の履歴はワークスペース B の履歴とは異なります。その他のリソースの種類によっては、同じリージョン内の同じ種類のリソースが共通の履歴を共有します。
保持期間と制限
タブは、現在のセッションのクエリ履歴を表します。 単純モードでは、タブごとに 1 つのクエリを使用できます。
| Behavior | Detail |
|---|---|
| Retention | 履歴は 30 日間保持されます。 |
| ユーザーごとの制限 | リソースあたり、ユーザーあたり最大 300 個のクエリ。 |
| クエリ のテキスト サイズ | 格納される各クエリは、最大 40 KB です。 大規模なクエリは履歴に保存されません。 |
クエリ履歴をクリアする
クエリ履歴のクリアはスコープ全体に適用されるため、履歴をクリアすると、そのスコープのすべてのクエリが一度に削除されます。 履歴を共有するリソースの種類の場合、履歴をクリアすると、同じリージョン内のその種類のすべてのリソースに影響します。
サポートされていないシナリオ
クエリ履歴は、次の場合には使用できません。
- カスタマー マネージド ストレージ: ワークスペースで カスタマー マネージド ストレージ アカウントが使用されている場合、クエリ履歴はサポートされません。
- リソースの移動操作: クエリ履歴は元のリソース ID にキーが設定され、ワークスペースを別のリソース グループまたはサブスクリプションに移動しても引き継がれない。 移動前に格納された履歴には、移動されたリソースからアクセスできません。
クエリ履歴には、各クエリのフルテキストが格納されます。 このテキストはテレメトリには書き込まれず、Microsoft演算子からはアクセスできません。
クエリ ウィンドウ
注
クエリ ウィンドウは KQL モードでのみ使用できます。
クエリ ウィンドウは、クエリを編集する場所です。 IntelliSense は KQL コマンドに使用され、色分けによって読みやすさが向上します。 ウィンドウの上部にある + を選択すると、別のタブが開きます。
1 つのウィンドウに複数のクエリを含めることができます。 クエリに空白行を含めることはできません。そのため、ウィンドウで 1 つ以上の空白行を使用して複数のクエリを区切ることができます。 カーソルが置かれているのが現在のクエリです。
現在のクエリを実行するには、[実行] ボタンを選択するか、Shift + Enter キーを押します。
[結果] ウィンドウ
クエリの結果が [結果] ウィンドウに表示されます。 既定では、結果はテーブルとして表示されます。 結果をグラフとして表示するには、[結果] ウィンドウで [グラフ] を選択します。 クエリに render コマンドを追加することもできます。
結果ビュー
[結果] ビューには、行と列で編成された表形式でクエリの結果が表示されます。
- 行の左側をクリックすると、その値が展開されます。
- [列] ドロップダウンを選択すると、列の一覧が変更されます。
- 列名を選択すると、結果が並べ替えられます。
- 列名の横にあるじょうごを選択すると、結果がフィルターされます。
- クエリを再実行すると、フィルターがクリアされ、並べ替えがリセットされます。
- [列のグループ化] を選択すると、クエリ結果の上にグループ化バーが表示されます。
- 列をこのバーにドラッグすることで、結果を列でグループ化します。
- 結果で入れ子になったグループを作成するには、列をさらに追加します。
グラフ ビュー
[グラフ] ビューには、使用可能な複数のグラフの種類のいずれかで結果が表示されます。 クエリ (KQL モード) では、 レンダー コマンドでグラフの種類を指定できます。 折りたたみ可能な グラフの書式設定 セクションから右に選択することもできます。
| オプション | 説明 |
|---|---|
| グラフの種類 | 表示するグラフの種類。 |
| X 軸 | X 軸に使用する結果の列。 |
| Y 軸 | Y 軸に使用する結果の列。 通常、これは数値列です。 |
| 次で分割 | グラフ内の系列を定義する結果の列。 列の値ごとに系列が作成されます。 |
| 集計 | Y 軸の数値に対して実行する集計の種類。 |
その他のツール
このセクションでは、次のスクリーンショットに示すように、画面のクエリ結果領域の上で使用できるその他のツールについて説明します。 スクリーンショットの番号は 1 から 8 です。
| # | オプション | 説明 |
|---|---|---|
| 1 | [タブ コンテキスト] メニュー | クエリ タブの省略記号から、 クエリのスコープを変更 するか、タブの名前の変更、重複、または閉じます。 |
| 2 | 可観測性エージェント | 自然言語を使用してデータとチャットし、KQL を記述せずにログの探索、一般的なエラーの検出、異常の分析、分析情報の表示を行います。 |
| 3 | 保存 | クエリのクエリ パックへの保存、関数としての保存、クエリのワークブック、Azure ダッシュボード、または Grafana ダッシュボードへのピン留め。 |
| 4 | 共有 | クエリへのリンク、クエリ テキスト、またはクエリ結果のコピー、あるいはデータの Excel、CSV、Power BI へのエクスポート。 |
| 5 | ツールのコンテキスト メニュー | クエリ領域の省略記号から: 新しいアラート ルール - 現在のクエリから新しいアラート ルールを作成します。 検索ジョブ - 現在のクエリを使用して検索ジョブを実行します。 Log Analytics設定 - タイム ゾーン、Log Analyticsが Simple モードまたは KQL モードで開かれるかどうか、データのないテーブルを表示するかどうかを含む、既定のLog Analytics設定を定義します。 |
| 6 | クエリ ハブ | 最初に Log Analytics を開いたときに表示される [クエリの例] ダイアログを開きます。 |
| 7 | 自動保存 | 自動保存Log Analytics、現在のセッション状態がブラウザーのローカル ストレージに自動的に保存されます。 ブラウザーがクラッシュした場合、ページが更新された場合、または移動して戻った場合、同じブラウザーで同じリソースのログを再度開くと、作業が復元されます。 |
| 8 | 列 | 結果テーブルの列を並べ替えたり、表示/非表示を切り替えたりできます。 ピボット モードを有効にして、テーブルを 1 つ以上の列で表示します。 |
Log Analytics の設定
このスクリーンショットは、[Log Analytics設定] ダイアログを示しています。
自動保存
Log Analyticsは、現在のセッション状態をブラウザーのローカル ストレージに自動的に保存します。 ブラウザーがクラッシュした場合、ページが更新された場合、または移動して戻った場合、同じブラウザーで同じリソースのログを再度開くと、作業が復元されます。
自動保存では、次の状態が保持されます。
- タブ名とすべてのクエリ タブ (KQL と単純)
- 作業モード (単純または KQL)
- クエリの範囲
- 時間範囲
- ピルの設定を表示する
自動保存のスコープと保持期間
スコープ - 状態は、ブラウザーとデバイスごと、および特定のリソースごとに保存されます。 保持 - 保存された状態は 30 日間保持されます。 リソースの非アクティブ状態が 30 日後に、保存された状態は自動的に削除されます。
Azure Data Explorer とのリレーションシップ
Azure Data Explorer Web UI を操作したことがある場合は、Log Analytics の外観に見覚えがあるでしょう。 これは Azure Data Explorer 上に構築され、同じ Kusto クエリ言語を使用します。
Log Analytics には、時間範囲によるフィルターや、クエリからの警告ルールの作成機能など、Azure Monitor 固有の機能が追加されています。 どちらのツールも、使用可能なテーブルの構造をスキャンできるエクスプローラーを備えています。 Azure Data Explorer Web UI は、主に Azure Data Explorer データベースのテーブルで機能します。 Log Analytics は、Log Analytics ワークスペースのテーブルと連携します。
関連するコンテンツ
- Azure portal 内での Log Analytics の使用に関するチュートリアルを進めます。
- クエリの作成に関するチュートリアルを進めます。
- イントロビデオに置き換えられた長いチュートリアルビデオをご覧ください。