Azure SRE エージェントの Kusto ツール

Kusto ツールは、最適な KQL クエリを再利用可能なパラメーター化されたツールに変えるのに役立ちます。 エージェントは、解釈やバリエーションなしで、作成した正確なクエリを実行します。 チームの専門知識が共有機能になります。

問題: すべてのユーザーが独自のクエリを記述する

インシデントの間、チームのシニア エンジニアは、迅速に問題を見つける、戦いでテストされたクエリを使用します。 しかし、その知識は頭、Slack スレッド、個人用ノートブックに留められます。 通話中でない場合、経験の少ないレスポンダーは時間を無駄にします。

• クエリをゼロから再発明する (多くの場合、間違いあり)
• **データの量が多すぎる、またはエッジ ケースが不足している、過度に広範なクエリを記述する
• 根本原因を明らかにする重要な列がない
• 間違った時間枠を使用 するか、環境でのフィルタリングを忘れる

各エンジニアは、同じデータに対して異なるクエリを実行します。 あるエンジニアが 5 分で問題を見つけます。 別のエンジニアは、アドホック KQL を使用して30分間無駄な回り道をしています。

Kusto ツールでこの問題を解決する方法

Kusto ツールを使用すると、チームの最適なクエリをパラメーター化された決定論的ツールとして保存できます。 エージェントは、定義した正確なクエリを実行するため、チームの専門知識が共有機能になります。

オンコール エンジニアに "エラー ログのクエリ方法を確認する" ように依頼する代わりに、エージェントに次の質問を行います。

Show me errors from the last 24 hours

エージェントは、事前構築済みのツールと timeRange=24hを使用して、正確に列を返し、チームのニーズをフィルター処理します。

どのように機能するのか

Kusto ツールを作成して使用するには、次の手順に従います。

1. 接続: Azure Data Explorer クラスターをコネクタとして追加します。
2. 作成: ##parameterName## 構文を使用して、パラメーターを使用してクエリを定義します。
3. テスト: ポータルでクエリが正しく実行されていることを検証します。
4. アタッチ: カスタム エージェントにツールを追加します。
5. 使用: ユーザーの質問がツールの説明と一致すると、エージェントによってツールが呼び出されます。

データ クエリに対する 2 つの方法

Azure Data Explorer コネクタを追加するときは、決定論的または柔軟なクエリを選択します。

Kusto ツールを作成する

ツールは、[ビルダー] > [エージェント キャンバス] > [作成] > [ツール] > [Kusto ツール] で作成します。 各ツールには、名前、説明、コネクタ、データベース、および KQL クエリと、省略可能な ##paramName## パラメーター プレースホルダーが必要です。

スクリーンショットを含む完全なチュートリアルについては、「 チュートリアル: Kusto ツールを作成する」を参照してください。

カスタム エージェントにツールを追加する

ツールを作成したら、キャンバス ビューボタンを使用して+にアタッチ>既存のツールを追加します。

前提条件

Kusto ツールを作成する前に、次の要件を満たします。

Azure Data Explorer のアクセス許可

エージェントのマネージド ID には、Azure Data Explorer クラスターに対する AllDatabasesViewer ロールが必要です。

次の KQL 管理コマンドを使用します。

.add cluster AllDatabasesViewer ('aadapp=<MANAGED_IDENTITY_CLIENT_ID>;<TENANT_ID>')

または、Azure portal で Azure Data Explorer クラスターに移動します。 [セキュリティとネットワーク>Permissions>Add>AllDatabasesViewer を選択します。

Kusto コネクタ

ツールを作成する前に、 ADX コネクタを設定します。 コネクタを追加する場合:

• スキーマ学習ではなく、定義済みのクエリに対して データベース クエリ コネクタ を選択します。
• データベースを含む完全なクラスター URL を使用します: https://<CLUSTER_NAME>.<REGION>.kusto.windows.net/<DATABASE_NAME>。

パラメーター化されたクエリ

##parameterName##構文を使用して、パラメーターを使用してツールの柔軟性を高めます。

AppEvents
| where TimeGenerated > ago(##timeRange##)
| where EventLevel == "Error"
| where Message contains "##searchPattern##"
| take 100

エージェントはこのツールを使用する場合、ユーザー入力に基づいてパラメーターを置き換えます。

パラメーターを使用すると、1 つのツールで同じ質問の多くのバリエーションを処理できます。

実行モード (YAML)

YAML でツールを定義する場合は、実行モードを選択します。

# Query mode (most common)
spec:
  mode: Query
  query: |-
    AppEvents | take 10

# Function mode
spec:
  mode: Function
  function: GetRecentErrors

クエリのベスト プラクティス

Kusto ツールクエリを記述するときは、次の推奨事項に従ってください。

適切な時間範囲を使用 する - 最新のデータに対する既定値:

| where TimeGenerated > ago(1h)

結果の制限を追加する - 圧倒的な出力を防ぐ:

| take 100

役に立つプロジェクションを含める - エージェントに必要な列のみを返します。

| project TimeGenerated, Name, DurationMs, ResultCode

Kusto ツールとアドホック クエリを使用する場合

シナリオに基づいて適切なアプローチを選択します。

概要

関連するコンテンツ