Azure Monitor ログでのクエリパック

2024-10-15

クエリパックは、Azure Monitor のログクエリのコンテナーとして機能します。これを使用して、ログクエリを保存し、ワークスペースや Log Analytics の他のコンテキストで共有できます。

アクセス許可

Azure portal で表示しているときにクエリパックのアクセス許可を設定できます。クエリパックを使うには、次のアクセス許可が必要です。

閲覧者: ユーザーは、クエリパック内のすべてのクエリを表示して実行できます。
共同作成者: ユーザーは既存のクエリを変更し、新しいクエリをクエリパックに追加できます。

重要

ユーザーがクエリパックを作成する必要がある場合は、リソースグループレベルでユーザー Log Analytics 共同作成者を割り当てます。

クエリパックの表示

Log Analytics クエリパックメニューから、Azure portal でクエリパックを表示および管理できます。クエリパックを選択して、そのアクセス許可を表示および編集します。この記事では、API を使用してクエリパックを作成する方法について説明します。

既定のクエリパック

最初のクエリを保存すると、Azure Monitor により、DefaultQueryPack というリソースグループの各サブスクリプションに LogAnalyticsDefaultResources というクエリパックが自動的に作成されます。このクエリパックに対するクエリを保存するか、要件に応じて別のクエリパックを作成できます。

複数のクエリパックの使用

クエリを保存して再利用するには、ほとんどのユーザーにとって既定のクエリパックで十分です。たとえば、異なる Log Analytics セッションに異なるクエリのセットを読み込み、クエリのコレクションごとに異なるアクセス許可を付与する場合など、組織内のユーザー用に複数のクエリパックを作成する場合があります。

新しいクエリパックを作成するときに、ビジネスニーズに基づいてクエリを分類するタグを追加できます。たとえば、クエリパックにタグを付け、組織内の特定の部門に関連付けたり、含まれているクエリが対処する問題の重大度に関連付けたりすることができます。タグを使用することにより、さまざまなユーザーのセットやさまざまな状況に合わせて、さまざまなクエリのセットを作成できます。

Log Analytics ワークスペースにクエリパックを追加するには:

Log Analytics を開き、右上隅にある [クエリ ] を選択します。
[ クエリ ] ダイアログの左上隅にある [ クエリパック] の横にある [ クエリパックの選択 ] または [ 選択した 0] をクリックします。
ワークスペースに追加するクエリパックを選びます。

重要

Log Analytics ワークスペースには最大 5 個のクエリパックを追加できます。

クエリパックを作成する

REST API を使用するか、Azure portal の Log Analytics クエリパックペインからクエリパック を作成できます。ポータルで [Log Analytics クエリパック ] ウィンドウを開くには、[ すべてのサービス>その他] を選択します。

注

クエリパックに保存されたクエリは、カスタマーマネージドキーでは暗号化されません。代わりにクエリ を保存するときに[レガシクエリとして保存] を選択し、カスタマーマネージドキーで保護します。

トークンを作成する

API 要求の認証にはトークンが必要です。トークンを取得するには複数の方法があります。 1 つの方法は、armclient を使用することです。

まず、次のコマンドを使用して Azure にサインインします。

armclient login

次に、次のコマンドを使用してトークンを作成します。トークンはクリップボードに自動的にコピーされるので、別のツールに貼り付けることができます。

armclient token

ペイロードの作成

要求のペイロードは、1 つ以上のクエリとクエリパックの保存場所を定義する JSON です。クエリパックの名前は、次のセクションで説明する API 要求で指定します。

{
    "___location": "eastus",
    "properties":
    {
        "displayName": "Query name that will be displayed in the UI",
        "description": "Query description that will be displayed in the UI",
        "body": "<<query text, standard KQL code>>",
        "related": {
            "categories": [
                "workloads"
            ],
            "resourceTypes": [
                "microsoft.insights/components"
            ],
            "solutions": [
                "logmanagement"
            ]
        },
        "tags": {
            "Tag1": [
                "Value1",
                "Value2"
            ]
        }
    }
}

クエリパック内の各クエリには、次のプロパティがあります。

プロパティ	説明
`displayName`	Log Analytics に表示される各クエリの表示名。
`description`	Log Analytics に表示される各クエリの説明。
`body`	Kusto 照会言語で記述されているクエリ。
`related`	クエリの関連カテゴリ、リソースの種類、およびソリューション。クエリを見つけやすくするために、ユーザーが Log Analytics でグループ化とフィルター処理に使用します。各クエリには、最大 10 個の種類を使用することができます。使用可能な値は、https://api.loganalytics.io/v1/metadata?select=resourceTypes、ソリューション、カテゴリから取得します。
`tags`	ユーザーが Log Analytics での並べ替えとフィルター処理に使用する別のタグ。クエリをグループ化してフィルター処理すると、各タグがカテゴリ、リソースの種類、ソリューションに追加されます。

要求を作成する

REST API を使用して新しいクエリパックを作成するには、次の要求を使用します。この要求では、ベアラートークン承認を使用する必要があります。コンテンツタイプは application/json である必要があります。

POST https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/my-resource-group/providers/Microsoft.Insights/querypacks/my-query-pack?api-version=2019-09-01

curl、Insomnia、Bruno などの REST API 要求を送信できるツールを使用し、前のセクションで説明したペイロードを使用することで要求を送信します。クエリ ID が生成され、ペイロードに返されます。

クエリパックを更新する

クエリパックを更新するには、更新されたペイロードで次の要求を送信します。このコマンドには、クエリパック ID が必要です。

POST https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/my-resource-group/providers/Microsoft.Insights/querypacks/my-query-pack/queries/query-id/?api-version=2019-09-01

次のステップ

ユーザーが Log Analytics でクエリパックを操作する方法については、Azure Monitor Log Analytics でのクエリの使用に関するページを参照してください。

次の方法で共有

Azure Monitor ログでのクエリ パック

アクセス許可

クエリ パックの表示

既定のクエリ パック

複数のクエリ パックの使用

クエリ パックを作成する