エージェントはあなたが与えた文脈で調査します。 オンボーディング時にデータソースをスキップしたり、調査結果が予想より薄い場合は、この記事を使って次に何を接続し、それぞれが何を加えるかを判断してください。 この記事では、エージェントが利用できる情報源を一覧化し、コネクター記事ではそれぞれの手続きを扱っています。
まずは最小の有用なセットから始めましょう
コードリポジトリと1つのログソースだけで、システムについての的確な答えが得られます。 他のすべてのソースはエージェントが見せる範囲を深め、いつでも任意の順番でソースを追加できるので、一度にセットアップを終える必要はありません。
コード、ログ、Azureリソース、ナレッジファイルが蓄積されます。 必要に応じて別のリポジトリやテレメトリープロバイダー、またはスコープを追加でき、不要なものは削除できます。 インシデントは異なる動作をします。 同時に稼働できるインシデントプラットフォームは1つだけで、新しいプラットフォームを接続すると現在のプラットフォームも切断されます。
各ソースでわかること
各データソースは、捜査中にエージェントが異なる種類の質問に答えることを可能にします。
| 情報源 | それによってエージェントが回答できる内容 | 接続に必要なもの |
|---|---|---|
| コード (推奨) | なぜ失敗が起こるのか。 エージェントはソースファイルを読み込み、特定の行に誤りを追跡し、最近の変更を特定します。 | GitHub、Azure DevOps、またはGitLabリポジトリへのアクセスと、プロバイダーがサポートする認証方法へのアクセス。 |
| ログ（推奨） | 制作中に何が起きたのか。 エージェントはあなたのテレメトリを問い合わせ、エントリとコードや依存関係を関連付けます。 | テレメトリーソースの読み取りアクセスは、コネクタが使用するアイデンティティや認証情報に付与されます。 |
| Azure リソース | 今のあなたの環境がどんなものか。 エージェントはリソースの設定、健全性、指標をチェックします。 | 各管理グループ、サブスクリプション、リソースグループに追加した場合、 オーナー または ユーザーアクセス管理者 の役割割り当てを行います。 |
| インシデント | 頼まれずにいつ働き始めるか。 エージェントはインシデントプラットフォームからのアラートを受け取り、対応計画に合致するアラートを調査します。 一度に一つのプラットフォームが稼働しています。 | Azure Monitorは認証情報なしで接続し、管理されたリソースグループからのアラートはエージェントに流れます。 PagerDutyとServiceNowは、インシデントプラットフォーム管理者からAPI認証情報を必要とします。 |
| ナレッジ ファイル | チームが仕事をどう進めたいか。 エージェントはあなたのランブック、エスカレーション経路、アーキテクチャのメモを追跡します。 | 対応フォーマットのファイルです。 「 知識文書のアップロード」を参照してください。 |
ログ提供者は認証方法に違いがあります。 Azure Data Explorer、Log Analytics Workspace、Application Insightsはエージェントのマネージドアイデンティティを利用します。 Datadog、Dynatrace、Elasticsearch、New Relic、Splunk、Hawkeyeは、あなたが提供したサービス認証情報を使用しています。 見つかるプロバイダーはテナントや構成によって異なるので、希望するものが見つからなければ検索ボックスを使ってください。 各プロバイダーが求めるフィールドについては「 テレメトリソースの接続」 を参照してください。
次に何を接続するか選びます
エージェントに不足している内容に当てはまる状況を選択してください。
- 担当者はあなたのアプリについては何も知らないと言っています。 まず コードを 接続してください。 これは調査の質に最も大きな影響を与え、接続を保存するとエージェントはリポジトリの探索を開始します。
- エージェントはコードの説明をしますが、本番環境で何が起きたかは言えません。 次にLogsを接続します。 インシデント時にチームがすでに問い合わせているプロバイダーを選びましょう。
- あなたの質問はリソースの健全性、構成、またはスケールに関するものです。 最も頻繁に調査するワークロードが含まれるリソース グループを対象に、Azure リソースを追加します。
- 誰かがチャットを開く前に、エージェントが仕事をしているのが良いです。 チームがすでにページングしているインシデントプラットフォームを接続し、狭いアラートセットに合わせた対応計画を作成します。 一度に有効にできるプラットフォームは 1 つだけなので、本番環境のアラートを送信するプラットフォームを選択してください。 インシデントプラットフォームを参照してください。
- 答えは技術的には正しいですが、チームの運営方法は無視してください。 エージェントが一般的なシーケンスではなく、あなたの手順に従う ようにナレッジファイル を追加しましょう。
Azureリソースとインシデントは、誰かが関わる可能性が最も高い2つの接続です。 どちらもエージェントが到達できる範囲や行動時期を変え、また単一のエンジニアが持てないアクセスが必要です。
前提条件
| Requirement | 詳細情報 |
|---|---|
| エージェント | まずは Createで作成し、設定してください。 |
| エージェントの役割 | SREエージェント標準ユーザーは 、コードリポジトリの追加や知識文書のアップロードをカバーします。 SREエージェント管理者はコネクタの管理やAzureリソーススコープの追加・削除をカバーします。 SREエージェントオーサー は、インシデント管理の設定および対応計画の作成をカバーしています。 ユーザー の役割と権限を参照してください。 |
| リソース スコープの Azure ロール | 直接または継承を通じて追加するすべてのスコープに対して、アクティブな オーナー または ユーザーアクセス管理者 の役割割り当てがあります。 ポータルはエージェントのマネージドIDに役割を割り当てるためにこれを使います。 |
| 各ソースへのアクセス | コードのリポジトリアクセス、ログのテレメトリソースの読み取りアクセス、PagerDutyやServiceNowのプラットフォーム認証情報などです。 |
| 受信すべきアラートやインシデント | Azure Monitorは既存のアラートルールが生成するアラートのみを転送するため、インシデント活動を予想する前にルールが存在するか必ず確認してください。 PagerDutyとServiceNowは、それぞれの統合によって生じたインシデントを転送します。 |
セットアップ ページを開く
Operations HubのOverviewタブのステータスバーに、まだ設定していないソースが一覧表示されます。 セットアップを 完了 してセットアップページを開くには、2つのタブがあります。
| タブ | データ ソース |
|---|---|
| クイックスタート | コード、ログ、Azure リソース、インシデント |
| フル セットアップ | クイックスタートのすべてに加え、ナレッジファイルも含まれます |
各ソースはカードとして表示されます。 接続されたカードにはチェックマークや、リポジトリ数やログ提供者数などの要約が表示され、注意が必要な誤りも表示されます。
ページには接続進行バーも表示されます。 バーは調査にどれだけ貢献するかではなく、どれだけのソースタイプが接続されているかを追跡し、セットアップページに提供されていないタイプもカウントできます。 その結果、表示されているものをすべて接続しても、満充電にならないことがあります。 目標ではなく、ざっくりとした指標として扱いましょう。 調査の質は、あなたの仕事が依存する情報源をつなげることから生まれます。
ヒント
エージェントが、あなたのアプリについて何も知らず、それについての質問に答えられないと言う場合は、何よりも先に Code を接続してください。
情報源を接続してください
カードのボタンで希望するソースを選択し、そのプロバイダーのウィザードに従ってください。 全手順については以下をご覧ください:
接続が正常かどうか確認してください
まずカードを確認してください。 接続が成功するとチェックマークが表示され、添付されたものの数が表示されます。 アップロードされた知識ファイルは、エージェントが処理を終えると「 インデックス化 」状態を示します。 知識ソースを確認するには、「 知識を連結する」をご覧ください。
次に、その情報源だけが答えられる質問をして、エージェントがその情報源にアクセスできることを確認してください。
| 情報源 | 代理店に聞いてみてください |
|---|---|
| Code | 「このリポジトリは何をしていて、どんなサービスが含まれているの?」 |
| Logs | 「過去24時間のエラーがないか確認しろ。」 |
| Azureのリソース | 「リソースグループ <resource-group-name>の資源の健康状態を確認してください。」 |
| 知識ファイル | 「HTTP 500エラーの扱いについて、私たちのランブックには何と書いてありますか?」 |
グラウンディング回答は、エージェントが問い合わせたソースのツールカードと、返された結果を表示します。 ツールカードがない一般的な回答やアクセス不足を報告する回答は、接続をもう一度見直す必要があることを意味します。 権限エラーで失敗したログクエリについては、ターゲットリソースに対してコネクターの識別読み取り権限を付与し、再度試みます。
文脈が増えると何が変わるのか
インシデントプラットフォームを接続すると、エージェントの作業開始方法が変わります。 それまでは、エージェントは人々に応答します。 その後、プラットフォームからのインシデントも受信し、対応計画に一致するインシデントを、各対応計画で設定された自律性レベルで調査します。 その動作を設定するには、「 インシデント対応の自動化」をご覧ください。
ソースの接続自体は請求されません。 Azure SREエージェントは、エージェントが実行する処理をアクティブフロー使用量として測定し、チャット、インシデント、スケジュールされたタスク、トリガーをカバーします。 よりつながりのあるコンテキストは、特にインシデントプラットフォームがあなた抜きで調査を始めると、その処理がより多く行われることを意味します。 より豊かな文脈は捜査を短縮することもできます。なぜなら、エージェントは見えない部分を回避する手間が少なくなってしまうからです。 「価格設定と請求」および「Azure SREエージェントの評価」を参照してください。
チームオンボーディングに戻る
チームのオンボーディングスレッドはサイドバーのお気に入りリストに残ります。 チームが導入したサービスや手続きの変更など、新しい情報をエージェントに伝える際には、そのオプションを選択して会話を続けましょう。
次に何を設定すればいいか、エージェントに尋ねるのも良いでしょう。 接続したものとまだ足りないものに基づいておすすめをしてくれます。 「 チームのオンボーディング」を参照してください。