Skip to main content
Devin Oncall は、アラート、バグ、インシデントの調査・修正・緩和を行い、オンコールから得られる実用的なインサイトを提供します。Devin はアラート、バグレポート、インシデントが発生した時点ですぐに作業を開始し、テレメトリー、コード、デプロイメント、ランブック、過去のインシデントを活用して根本原因を特定し、問題を修復して修正 PR を作成します。 Oncall は次の 3 つのプロダクトで構成されています。
  • レスポンダー: アラート、バグレポート、サポートへの問い合わせを受信した時点で調査し、修正します。
  • Incidents: 根本原因を特定して影響を緩和し、各インシデントを解決まで導きます。
  • レポート: アラート、バグ、インシデントの発生要因に関するインサイト (調整すべきアラートのしきい値や、修正すべき繰り返し発生する課題の種類など) をもとに対策を講じます。

セットアップ

Oncall を利用するには、組織ごとに1回限りのセットアップが必要です。セットアップでは、Devin がテレメトリーツールとコードからシステムを学習し、すべての Oncall セッションで利用されるスキルを作成します。
  1. サイドバーで Oncall を開き、Begin setup をクリックします。
  2. テレメトリーツールを1つ以上接続します。Devin の環境でテレメトリーツールがすでに利用可能な場合、このステップはスキップできます。
  3. Finish をクリックします。Devin がシステムの学習を開始します (通常1〜2時間かかります) 。Oncall の準備が整うと通知が届きます。
セットアップが完了すると、レスポンダー、Incidents、レポート を利用できるようになります。
セットアップには Oncall の管理権限が必要です。組織全体を対象にツールを接続できるのは組織管理者のみです。

Oncall の設定

Oncall ヘッダーにある設定 (歯車) アイコンから、すべての Oncall セッションに共通する項目を開けます。
  • 指示: すべての Oncall セッションが従うガイダンスで、Markdown で記述します。Oncall 専用の AGENTS.md のようなものです。
  • スキル: セットアップ時に Devin があなたのシステムについて生成したスキルです。スキルを最新の状態に保つには、Skill update frequency を Weekly または Monthly に設定するか、Update skills now をクリックします。

レスポンダー

レスポンダーはアラートやレポートのソースを監視し、新しいイベントが発生するたびに Devin に調査させます。Devin は繰り返し発生するイベントを 1 つの 課題 にまとめるため、頻発するアラートでも調査は 1 回で済みます。 レスポンダーは次のような用途に利用できます:
  • 監視ツールが Slack または Microsoft Teams のチャンネルに投稿する本番環境のアラート
  • PagerDuty のインシデント(Devin は調査結果をインシデントノートとして投稿します)
  • #eng-bugs などのチャンネルに投稿されるバグレポートやサポートに関する質問

レスポンダーを作成する

  1. Oncall ページで Create responder をクリックします。
  2. Name を入力し、Responder type を選択します。タイプは作成後に変更できません。
  3. トリガー を 1 つ以上追加します。
  4. 必要に応じて、セッション設定、コネクタ、ランブックを調整します。
  5. Create responder をクリックします。
ランブックは任意です。Devin Oncall はアラートやバグの調査方法をあらかじめ把握しているため、ランブックはチーム固有の手順がある場合にのみ追加してください。

レスポンダーの種類

アラートとバグレポートでは必要な対応が異なるため、レスポンダーの種類ごとに専用のフローが実行されます。また、種類によって、そのレスポンダーの課題をボード上でどのように追跡するかも決まります。

トリガー

レスポンダーは一度に1つの統合を監視し、最大10個のトリガーを設定できます。いずれかのトリガーに一致すると、Devin が応答します。 トリガーに条件を追加すると、Devin が応答するイベントを絞り込めます。

レスポンダーの設定

Incidents

Incidents は、インシデントごとに新しいSlackチャンネルを作成するチーム向けの機能です。Devin はそのチャンネルに参加し、考えられる根本原因を特定して緩和策を提案するとともに、インシデントの進展に合わせて調査を継続します。また、状況の更新を投稿し、スレッド内の質問に回答しながら、インシデントレポートを随時更新していきます。

インシデントを有効にする

  1. Oncall ページで Incidents タブを開き、Enable incidents をクリックします。
  2. Enable incidents をオンにします。
  3. インシデント用チャンネルで使用している Slack channel prefix を設定します (例:incident-) 。
  4. Response mode を選択して保存します。
Devin は、名前がこのプレフィックスで始まる Slackチャンネルに参加すると調査を開始します。Devin をチャンネルに招待するか、インシデントチャンネルへの自動参加 をオンにしてください。
インシデント機能を利用するには、組織で Slack が接続されている必要があります。エンタープライズ内でインシデントを有効にできるのは、一度に1つの組織のみです。

レスポンスモード

インシデント設定

Incidents タブには、各インシデントがセッションへのリンク付きで一覧表示されます。インシデントへの Devin の関与を終了するには Stop を、再開するには Resume を使用します。

レポート

レポートは、オンコール対応から得られる実用的なインサイトを定期的に提供します。たとえば、調整すべきアラートのしきい値、対処すべき繰り返し発生する課題の種類、アラート・バグ・インシデントの発生要因などです。 各レポートには、特定・修正された課題、調査されたインシデント、Devin が作成・マージしたプルリクエストの概要もまとめられています。 レポートは週次のオンコール引き継ぎに利用できるほか、請求やインフラストラクチャなど、特定のチームにスコープを絞って利用することもできます。

レポートを作成する

  1. Oncall ページで レポート タブを開き、Create report をクリックします。
  2. Name を入力します。
  3. Responders match で、レポートの対象とするレスポンダーを指定します。個々のレスポンダーを選択するか、メタデータで指定できます。
  4. Incidents match で、レポートに含めるインシデントの条件を記述します。インシデントを含めない場合は空欄のままにします。
  5. Schedule を設定し、必要に応じて、レポートに含める内容を記述した 指示 を追加します。
  6. Notifications で、レポートの投稿先となる Slack または Microsoft Teams のチャンネルを選択します。
  7. Create report をクリックします。
レポートは共有リソースのため、個人ではなくサービスユーザーとして実行されます。レポートを開くと過去の実行結果を確認でき、Generate report をクリックするとその場で実行できます。