オンコール¶
オンコール機能は、チームが 7×24 時間のインシデント対応体制を構築し、すべてのインシデントに明確な担当者が存在することを保証し、タイムアウトして未処理の場合に自動的にエスカレーションすることで、「アラートを確実に届ける」ことを実現します。
コア概念¶
オンコールルール¶
オンコールルールでは、誰が いつ どのようなインシデントを担当するかを定義します。各ルールには以下の要素が含まれます:
- オンコール担当者:メンバー、チーム、または通知先
- 勤務時間:オンコールが有効な時間帯(タイムゾーン設定に対応)
- 有効範囲:スケジュールルールの有効期間
- マッチタグ/ディメンション:どのインシデントをこのルールにルーティングするかを決定します
- エスカレーションポリシー:タイムアウトして未処理の場合の通知エスカレーションルール
エスカレーションポリシー¶
エスカレーションポリシーは、オンコールルールに付加される多段階の通知メカニズムです。インシデントが指定時間内に引き受けられない、または解決されない場合、システムは設定されたレベルに従って通知範囲を段階的に拡大し、インシデントが見落とされないようにします。
エスカレーションポリシーのLevel 0ルールでは「現在のオンコール担当者」を選択できます。これは、オンコールポリシーでローテーションが有効になっている場合に、現在時刻でリアルタイムに有効なオンコール担当者を指します。
マッチタグのロジック¶
インシデントは保持するタグに基づいて自動的にオンコールルールにマッチングされます。マッチングルールは以下に対応:
- AND:複数のタグをすべて満たす必要がある(全マッチ)
- OR:複数のタグのいずれかを満たせばよい(部分マッチ)
- ワイルドカード:
key:value*は前方一致に対応
例:
インシデントタグ:{service:payment, env:prod, team:backend}
- オンコールルールA:タグ
service:payment AND env:prod→ マッチ ✓ - オンコールルールB:タグ
team:frontend→ マッチしない ✗ - オンコールルールC:タグなし(グローバル)→ マッチ ✓(フォールバック)
注意
マッチタグを設定しない場合、このオンコールルールは「グローバルマッチ」とみなされ、他のルールにマッチしないすべてのインシデントを受信します。
オンコール概要¶
オンコールページに入ると、デフォルトでカードビューでオンコールルールが表示されます。ページ上部には現在のオンコールステータスが表示され、現在オンコール中のルール名、終了時間、残り時間が含まれます。
「すべて/マイ」で表示範囲をすばやく切り替えて、すべてのオンコールルール、または自分が参加しているオンコールのみを表示できます。フィルター結果の右側には現在のリスト件数が表示され、検索ボックスでオンコール名を検索することもできます。現在オンコール中の場合、対応するルールが先頭に固定表示され、「オンコール」ラベルで識別されます。
カードビュー¶
オンコールルールをカード形式で表示します。各カードには、オンコール名、現在のオンコール担当者、次のオンコール担当者、マッチディメンション、バインドされているエスカレーションポリシーが含まれます。任意のオンコールカードをクリックすると、そのオンコールの詳細設定ページに入ります。
カレンダービュー¶
「カレンダー」をクリックするとカレンダービューに切り替わり、現在のフィルター条件と検索条件は保持されます。
- 左側には現在のフィルター範囲内のオンコールリストが表示され、カレンダーに表示するオンコールルールをチェックできます
- 右側は月間カレンダービューで、月の切り替え、今日に戻る、タイムゾーンの切り替えに対応しています
カレンダーは日単位でオンコールスケジュールを表示し、各オンコール担当者が1行を使用し、担当者名と開始時刻が表示されます。クリックすると行全体が展開され、完全な情報が表示されます。担当者名にマウスをホバーすると、そのオンコールの詳細情報を確認できます。
システム組み込みの「デフォルトオンコール」は常にオンコールリストに表示され、削除や非表示にすることはできません。カレンダー上の担当者名をクリックすると、そのオンコールの詳細情報(関連するオンコールルール、エスカレーションポリシー、具体的なオンコール時間帯)を確認できます。左上隅ではタイムゾーンと日付を切り替えることができ、過去や将来のスケジュールを確認できます。
オンコール管理¶
「オンコール管理」ページでは、すべてのオンコールルールがリスト形式で一元的に表示されます。各ルールには、オンコールタイムゾーン、実行周期、オンコール担当者、マッチタグ、エスカレーションポリシーなどの主要情報が表示されます。リストにはシステムのデフォルトオンコールとカスタムオンコールルールが含まれ、任意の項目をクリックすると詳細ページに入り、詳細な設定を行うことができます。
インシデント通知を確実に届け、責任のクローズループを実現するために、オンコールポリシーの設定における核心は、以下の2層の保障メカニズムを確立することです:
-
「誰がいつ担当するか」を明確にする:オンコール担当者、有効時間帯を設定し、通知ローテーション(日、週などの周期で自動引き継ぎに対応)を有効にすることで、システムは責任の明確なスケジューリングと自動的な引き継ぎを実現し、常に明確な「ファーストレスポンダー」が存在することを保証します
-
エスカレーションパスを事前設定する(「応答がない場合のエスカレーション先」):エスカレーションポリシーを設定することで、「T+N分」の段階的な通知タイムラインを構築します。インシデントが設定時間内に誰にも処理されない場合、システムはこのルールに従って、自動的に他のレベルのメンバーやより広いチームにアラートを通知し、重要なインシデントを確実に届けます。
オンコールルールを作成¶
オンコールルールを作成するには、以下の設定手順を完了する必要があります。
基本情報¶
- オンコール名を入力します
- オンコールの基準となるタイムゾーンを選択します
-
勤務時間を設定します:オンコールが有効な時間帯を定義します
- 終日:終日カバー
- 指定時間:曜日と開始・終了時刻で複数の時間帯を設定し、最終的な有効時間は和集合となります
-
有効範囲を設定します:スケジュールルールの有効期間を定義します
- 長期有効:終了時間の制限なし
- 指定日付:開始日と終了日を設定します。開始日は今日より前にすることはできません
マッチタグ/ディメンション(オプション)¶
この部分は、どのインシデントをこのルールで処理するかを決定します。タグ/ディメンションを追加しない場合、このルールはグローバルマッチとなります。
-
マッチタグ:
- ドロップダウンリストから既存のタグを選択します
- 新しいタグを直接入力してすばやく作成するか、「グローバルタグ」に移動して管理することもできます
-
マッチディメンション:
- 検出ディメンション(
service、hostなど)を選択し、具体的なマッチ値を設定できます - 論理関係に対応:AND(全マッチ、すべての条件を満たす必要がある)または OR(部分マッチ、いずれかの条件を満たせばよい)。デフォルトは AND です
- 値はワイルドカードに対応し、形式は
key:value*です。例:service:auth*はauth-api、auth-serviceなどをマッチできます
- 検出ディメンション(
オンコール担当者の設定¶
- オンコール担当者を選択します:1人または複数のメンバー、またはチーム全体を選択できます
-
ローテーションを有効にする:交代でオンコールを行う必要がある場合は、ローテーション機能を有効にできます。ローテーション周期(毎日、毎週、毎月など)を設定すると、システムはメンバーリストの順序に従って自動的に循環スケジュールを作成し、右側のカレンダーでスケジュールの効果を視覚的に表示します
- カスタムローテーション周期:1〜31日または1〜4週を入力できます。システムは勤務時間に基づいて実際のローテーション効果を自動計算します。例:勤務時間が月曜日から金曜日に設定されている場合、4日ごとのローテーションの実際の効果は、月曜日から木曜日はAがオンコール、金曜日および翌週の月曜日から水曜日はBがオンコールとなります
-
自動引き受け:有効にすると、インシデントが1人のオンコール担当者のみにマッチした場合、そのメンバーが自動的にインシデント対応者として指定され、インシデントステータスは「処理中」に更新されます。エスカレーションポリシーのLevel 0の通知は通常どおり送信されます。
ローテーションの例:
- ローテーション有効前:
- ローテーション有効後:
注意
現在のルールでオンコール担当者が設定されていない場合、エスカレーションポリシーを追加できません。
一時代行¶
特定の時間帯でオンコール担当者を一時的に調整するために使用します。
- 代行担当者と代行対象者(いずれも単一選択)を選択し、代行の開始時刻と終了時刻を指定します
- 右側のカレンダーで代行の効果をリアルタイムにプレビューします。上部には代行担当者、代行対象者、代行の開始・終了時刻と継続時間が表示されます
- 代行を作成すると、代行対象者はその時間帯にインシデントのアラート通知を受信しなくなり、代行担当者が代わりに受信します
- カレンダーで有効になった代行は対応する日付に直接表示され、元のオンコール担当者には取り消し線が表示されます。代行モジュールをクリックすると詳細フロートが表示され、代行の双方、開始・終了時刻が含まれ、「代行の調整」または削除に対応します
- 代行が有効になると、システムは代行担当者にメール通知を送信します。代行の削除が有効になると、システムは代行対象者にメール通知を送信します
エスカレーションポリシーの設定¶
エスカレーションポリシーは、インシデントがタイムアウトして誰も処理しない場合に、通知範囲をより多くの人やより上位のレベルに自動的に拡大することを保証します(❗️エスカレーションポリシーはオンコールルールの核心であり、設定を強く推奨します)。
タイムラインの仕組み(T+N)¶
すべての時点の計算はインシデントの発生時刻を基準(T=0)とします。システムは設定された時間間隔に従って各レベルの通知を順次トリガーします:
| トリガー時刻 | レベル | 説明 |
|---|---|---|
| T+0 | Level 0 | インシデント発生時に即時通知(初期) |
| T+5分 | Level 1 | 第一段階のエスカレーション |
| T+15分 | Level 2 | 第二段階のエスカレーション |
| T+30分 | Level 3 | 第三段階のエスカレーション |
レベルの設定説明¶
1. Level 0(初期通知)(必須)
- トリガータイミング:インシデント発生時に即時通知(T=0)
- 通知先:デフォルトで現在のオンコール担当者(オンコールルールで現在有効な担当者)が入力され、他のメンバーやチームを追加で設定することもできます
- 通知方法:通知先ごとに個別にチェックします(メール、SMS、電話、複数選択可)
2. Level 1〜10(エスカレベル)(オプション)
-
トリガー条件:以下の条件をすべて満たした場合にのみ、そのレベルがトリガーされます:
- インシデントの継続時間が設定された待機時間に達している(例:T+20分)
- インシデントレベルが指定された範囲内である(例:P0、P1のみに有効)
- インシデントステータスが指定された値である(例:Open または Working)
-
通知先:そのレベルで設定されたメンバーまたはチームのみに通知し、Level 0で設定されたメンバーには通知しません
- 通知方法:新しく追加されたメンバーに個別に通知方法を設定します
注意
上位レベルのインシデントレベルとステータス範囲は、下位レベルで選択済みの範囲を超えることはできません。例:Level 0 が P0/P1 に適用される場合、Level 1 でも P0 または P1 のサブセットのみを選択できます(P2 には拡張できません)。
繰り返し通知の仕組み¶
各レベル内で、繰り返し通知を有効にするかどうかを選択できます:
- 繰り返し通知を無効:そのレベルでは通知が1回だけ送信され、その後次のレベルへの移行を待ちます
- 繰り返し通知を有効:設定された頻度(例:5分ごと)で通知を定期的に送信し、インシデントステータスが変更されるか、次のレベルに移行するまで続けます
注意
繰り返し間隔は、次のレベルへの移行の待機時間より短くなければならず、そうでない場合は設定できません。
例:
- Level 1 の待機時間:30分
- 繰り返し間隔:5分
- 最終的な効果:T+5、T+10、T+15、T+20、T+25、T+30分にそれぞれ通知が1回送信されます
注意
最後のレベル(例:Level 10)で繰り返し通知が有効になっており、インシデントが最後まで処理されない場合、システムは誰かが引き受けるか解決するまで通知を無限に繰り返し送信します。
オンコールの引き継ぎをまたぐ場合の処理¶
インシデントの継続時間がオンコールの引き継ぎ時刻をまたぐ場合、その後のエスカレーション通知は新しいオンコール担当者に引き継がれ、新しいオンコール担当者のエスカレーションポリシーに従って実行されます。
例:
- インシデントが23:55に発生し、この時点のオンコール担当者はAです
- エスカレーションポリシーのLevel 1の待機時間は15分で、5分ごとの繰り返しが設定されています
- 最初の繰り返し通知はインシデント発生から5分後(0:00)にトリガーされます。この時点でオンコール担当者はBに切り替わっているため、この通知はBに送信され、その後のエスカレーション通知(残りの繰り返しと次のレベルを含む)もすべてBのエスカレーションポリシーに従って実行されます
日付が変わった後、システムは新しいオンコール担当者Bのエスカレーションルールに基づいて、このインシデントの処理を継続します。
注意
エスカレーションポリシーを設定する際は、日付をまたぐシナリオを考慮し、インシデントがあらゆる時間帯で効果的に対応されるようにすることをお勧めします。
複数エスカレーションポリシーの重複排除¶
同じインシデントが複数のオンコールルール(つまり複数のエスカレーションポリシー)に同時にマッチする場合、システムは通知の重複排除を自動的に行い、同じユーザーが重複した通知を受信しないようにします。重複排除のロジックは、ユーザー、インシデント、通知内容に基づきます。
エスカレーションポリシー設定の例¶
シナリオ:コアサービスP0インシデントのエスカレーションポリシー
| レベル | 待機時間 | 適用条件 | 通知先 | 通知方法 |
|---|---|---|---|---|
| Level 0 | T+0 | レベル = P0 | 現在のオンコール担当者 A | SMS + メール |
| Level 1 | T+5分 | レベル = P0, ステータス = Open/Working | + オンコールリーダー B | B:電話 |
| Level 2 | T+15分 | レベル = P0, ステータス = Open/Working | + 部門マネージャー C | C:電話 |
| Level 3 | T+30分 | レベル = P0, ステータス = Open/Working | + CTO D | D:電話 + SMS |
この例では:
- インシデント発生時に、現在のオンコール担当者Aに即時通知されます
- 5分後もインシデントが処理されない場合、オンコールリーダーBに追加通知されます(この時点の通知先は A + B)
- 15分後も処理されない場合、部門マネージャーCに追加通知されます(通知先は A + B + C)
- 30分後も処理されない場合、CTO Dに追加通知されます。Level 3では繰り返し通知が有効になっており(例:10分ごと)、誰かが応答するまで続きます
通知方法の説明¶
前提条件
-
通知を受けるメンバーは、環境設定で対応する連絡先(メール、携帯電話番号)を設定している必要があります。設定されていない場合、該当チャネルの通知を受信できません
-
「環境設定」で「オンコール電話」または「オンコールメール」を追加で設定している場合、システムはこれらの専用連絡先を優先して通知に使用し、信頼性と識別性を高めます
システムは3つの通知チャネルに対応しており、通知先ごとに個別にチェックできます:
| 方法 | 説明 | 適用シナリオ |
|---|---|---|
| メール | メール通知を送信します。内容にはインシデントの詳細とリンクが含まれます | 緊急でないインシデント、詳細情報が必要なシナリオ |
| SMS | SMS通知を送信します。内容は簡潔で、重要な情報とリンクのみが含まれます | すぐに把握する必要があるが、直ちに電話応答が必要ないシナリオ |
| 電話 | IVR音声電話で、通話後にアラート内容が再生され、キー操作での確認が必要です ❗️異なるタイムゾーン/地域の連絡先にオンコール電話を設定する場合は、必ず +国番号の形式を使用してください |
緊急のインシデントで、確実に通知する必要がある場合。夜間や高優先度に適しています |
電話読み上げは現在のワークスペースの言語に対応する上限を使用します。文字数のカウントと上限超過時の切り捨てルールは電話読み上げ文字数上限を参照してください。
デフォルトオンコール¶
システムには「デフォルトオンコール」が組み込まれています。これは簡易版のオンコールルールで、シンプルなシナリオに適しています。特徴は以下のとおりです:
- 設定できるのは、オンコール担当者、オンコール担当者のローテーション、エスカレーションポリシーのみ
- 設定不可の項目:タイムゾーン(固定で空、システムタイムゾーンに従う)、マッチタグ/ディメンション(設定不可、デフォルトでグローバルマッチ)
- デフォルトオンコールは常にオンコールリストに表示され、削除できません
ルールの制限¶
-
1つのオンコールルールには最大10個のエスカレベルを設定できます(Level 0 + Level 1〜10)
-
1回の待機時間は最大360分(6時間)で、超過した場合は保存できません
-
上位レベルのインシデントレベルとステータス範囲は、下位レベルで選択済みの範囲のサブセットである必要があります
設定確認チェックリスト
オンコールルールを保存する前に、以下の項目を1つずつ確認することをお勧めします:
- Level 0 に現在のオンコール担当者が含まれていますか?(デフォルトで含まれています)
- 各レベルの待機時間は適切ですか?(夜間の対応にはより長い時間が必要な場合があります)
- 最終レベルに「何としても連絡を取る」連絡先が含まれていますか?
- 繰り返し通知を有効にしている場合、繰り返し間隔は次のレベルの待機時間より短いですか?
- すべての通知先に該当する連絡先(特に電話)が設定されていますか?
- 日付をまたぐシナリオで、エスカレーションポリシーの継続性は要件を満たしていますか?
次のステップ¶
オンコールルールを設定すると、インシデント一覧でインシデントに自動的に関連付けられたオンコール情報を確認できます。インシデントが発生すると、システムは設定したルールに従って該当するメンバーに自動的に通知し、タイムアウト後にはエスカレーションポリシーを実行して、すべてのインシデントが迅速に対応されることを保証します。



