このチュートリアルでは、エージェントを Log Analytics ワークスペースに接続して、待機時間を短縮し、トークンを減らしながらログ データに直接クエリを実行できるようにします。 Application Insights でも同じフローが機能し、違いはインラインで確認できます。
組み込みの可観測性が既に機能している中でコネクタを追加する理由については、
Note
この記事では、管理IDと自動RBACロール割り当てを備えたワークスペースピッカーを使用するレガシーLog Analyticsコネクタについて解説します。 コネクタウィザードには、独自のリソースピッカーを持つ別コネクタとしてApplication Insightsも含まれています。 現在のコネクタウィザードを通じてテレメトリソースを接続するには、「 テレメトリソースを接続」をご覧ください。
このチュートリアルでは、以下の内容を学習します。
- ビルダーで Log Analytics コネクタを追加する
- 自動検出された一覧からワークスペースを選択する
- チャットのログに対してクエリを実行して接続を確認する
Prerequisites
- 実行中の状態のエージェント。
- エージェントのサブスクリプション内の少なくとも 1 つのLog Analyticsワークスペースまたは Application Insights リソース。
サブスクリプション スコープまたはリソース グループアクセスを個別に構成する必要はありません。 エージェントは、既存のサブスクリプション スコープからワークスペースを検出し、関連するリソース グループに RBAC ロールを自動的に割り当てます。
コネクタを追加する
- Builder>Connectors に移動します。
- [ コネクタの追加] を選択します。
- Log Analytics ワークスペース(または App Insights リソースの場合は Application Insights)を選択してください。
ワークスペースを選択する
フォームは、エージェントのサブスクリプション内のワークスペースを自動検出します。 以下のフィールドに記入してください。
| フィールド | 説明 |
|---|---|
| 氏名 | このコネクタのわかりやすい名前 (たとえば、 production-logs)。 |
| Log Analytics ワークスペース | ドロップダウンからワークスペースを選択します。 各オプションには、ワークスペース名とリソース グループが表示されます。 複数のワークスペースを接続するには、それぞれに個別のコネクタを作成します。 |
| マネージド ID | エージェントが認証に使用する ID (システム割り当てまたはユーザー割り当て)。 |
ワークスペースを選択すると、RBAC ロールの割り当てを受け取るリソース グループがヒントに表示されます。
Note
ドロップダウンにワークスペースが表示されない場合、サブスクリプションにLog Analyticsワークスペースが含まれていないか、アカウントに Resource Graph の読み取りアクセス許可がない可能性があります。 ワークスペースを手動で追加するには、次のように入力します。
-
ARM リソース ID:
/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.OperationalInsights/workspaces/{name} - ワークスペース名: 表示名。
- 顧客 ID: ワークスペースの一意の識別子 (Azure portal で、ワークスペースの [プロパティ] タブに表示されています)。
Application Insights の場合、手動フォームには ARM リソース ID (Microsoft.Insights/components/{name}) とリソース名が必要です。
保存して確認する
- [] を選択し、[] を追加します。 エージェントは、必要な RBAC ロールをマネージド ID に割り当て、接続を作成します。
- コネクタが [接続>] 状態の BuilderConnectors に表示されたことを確認します。
- チャットに移動し、接続をテストします。
What tables are available in my Log Analytics workspace?
より具体的なクエリを試してみてください。
Show me the top 10 errors from SigninLogs in the last 24 hours
結果は、Azure Monitor バッジ付きの書式設定されたテーブルとして表示されます。 エージェントは、このログ データをインシデント調査に含めることができるようになりました。
Troubleshooting
| 問題点 | 解決策 |
|---|---|
| ドロップダウンにワークスペースがありません | サブスクリプションにLog Analyticsワークスペースが含まれていることと、Resource Graph の読み取りアクセス許可があることを確認します。 フォールバックとして手動の ARM リソース ID 入力を使用します。 |
| RBAC の割り当てが失敗する | ターゲット リソース グループの 所有者 または ユーザー アクセス管理者 が必要です。 管理者にアクセス権を付与するか、ロールを事前に割り当てるように依頼します。 |
| クエリから 403 が返される | マネージド ID には、ターゲット リソース グループに Log Analytics Reader または Monitoring Reader が存在しない可能性があります。 Azure ポータルでロールの割り当てを確認します。 |
| 接続タイプがピッカーにありません | ページを最新の情報に更新します。 問題が解決しない場合は、エージェントのサブスクリプション スコープを確認します。 |
関連するコンテンツ
Log Analytics&Application Insights コネクタ : 機能の概要- テレメトリソースを接続する:マネージドコネクタを通じてLog Analyticsを設定する
- スケジュールされたタスクを作成する: 定期的なログ クエリを自動化する
- Kusto ツール: ADX クラスターに対する確定的なパラメーター化されたクエリ
- Azure可観測性を備えたDiagnose: 組み込みの監視クエリ