インシデントを管理する

このページでは、インシデントに関して、またはインシデントに関連して実行できるすべての操作について説明します。

incidentインシデントの作成

インシデントは、手動または自動で作成できます。

イテレーションにインシデントを追加

イテレーションにincidentを追加するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 左側のサイドバーで、Planを選択してプロジェクトを見つけます。イシュー > モニタリングまたはインシデント > インシデントを選択し、インシデントを選択して表示します。
3. 右側のサイドバーのイテレーションセクションで、編集を選択します。
4. ドロップダウンリストから、このインシデントを追加するイテレーションを選択します。
5. ドロップダウンリストの外側の領域を選択します。

または、/iterationクイックアクションを使用することもできます。

インシデントページから

前提要件:

• プロジェクトのレポーターロール以上が必要です。

インシデントページからインシデントを作成するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. モニタリング > インシデントを選択します。
3. インシデントを作成を選択します。

イシューページから

前提要件:

• プロジェクトのレポーターロール以上が必要です。

イシューページからインシデントを作成するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. Plan > イシューを選択し、新規イシューを選択します。
3. 種類ドロップダウンリストから、インシデントを選択します。ページには、インシデントに関連するフィールドのみが表示されます。
4. イシューの作成を選択します。

アラートから

アラートを表示しているときにインシデントイシューを作成します。インシデントの説明は、アラートから入力されたものです。

前提要件:

• プロジェクトのデベロッパーロール以上を持っている必要があります。

アラートからインシデントを作成するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. モニタリング > アラートを選択します。
3. 目的のアラートを選択します。
4. インシデントを作成を選択します。

インシデントが作成された後、アラートから表示するには、インシデントを表示を選択します。

アラートにリンクされているインシデントを解決すると、GitLabはリンクされているアラートの解決済みを解決済みに変更します。次に、アラートのステータス変更がクレジットされます。

自動的に、アラートがトリガーされたとき

プロジェクト設定で、アラートがトリガーされるたびに、自動的にインシデントを作成する機能を有効にできます。

PagerDuty Webhookの使用

PagerDutyの場合、Webhookを設定して、各PagerDutyインシデントに対してGitLabインシデントを自動的に作成できます。この設定では、PagerDutyとGitLabの両方で変更を行う必要があります。

前提要件:

• プロジェクトのメンテナー以上のロールを持っている必要があります。

PagerDutyでWebhookを設定するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > モニタリングを選択します
3. インシデントを展開するします。
4. PagerDutyインテグレーションタブを選択します。
5. 有効切替をオンにします。
6. インテグレーションを保存を選択します。
7. 後の手順で使用するために、WebhookのURLの値をコピーします。
8. Webhook URLをPagerDuty Webhookインテグレーションに追加するには、PagerDutyドキュメントに記載されている手順に従ってください。

インテグレーションが成功したことを確認するには、PagerDutyからテストインシデントをトリガーして、インシデントからGitLabインシデントが作成されるかどうかを確認します。

インシデントのリストを表示

インシデントのリストを表示するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. モニタリング > インシデントを選択します。

インシデントの詳細ページを表示するには、リストから選択します。

誰がインシデントを表示できますか

インシデントを表示できるかどうかは、プロジェクト表示レベルとインシデントの機密ステータスによって異なります:

• 公開プロジェクトおよび非機密インシデント: 誰でもインシデントを表示できます。
• 非公開プロジェクトおよび非機密インシデント: プロジェクトのゲストロール以上が必要です。
• 機密インシデント(プロジェクト表示レベルに関係なく): プロジェクトのプランナーロール以上が必要です。

ユーザーに割り当て

積極的に対応しているユーザーにインシデントを割り当てます。

前提要件:

• プロジェクトのレポーターロール以上が必要です。

ユーザーを割り当てるには:

1. インシデントの右側のサイドバーで、担当者の横にある編集を選択します。
2. ドロップダウンリストから、assignees（担当者）として追加する複数のユーザーを1人または複数選択します。
3. ドロップダウンリストの外側の領域を選択します。

重大度を変更

利用可能な重大度レベルの完全な説明については、インシデントリストのトピックを参照してください。

前提要件:

• プロジェクトのレポーターロール以上が必要です。

インシデントの重大度を変更するには:

1. インシデントの右側のサイドバーで、重大度の横にある編集を選択します。
2. ドロップダウンリストから、新しい重大度を選択します。

/severity クイックアクションを使用して、重大度を変更することもできます。

ステータスを変更する

前提要件:

• プロジェクトのデベロッパーロール以上を持っている必要があります。

インシデントのステータスを変更するには:

1. インシデントの右側のサイドバーで、ステータスの横にある編集を選択します。
2. ドロップダウンリストから、新しい重大度を選択します。

トリガーは、新しいインシデントのデフォルトのステータスです。

オンコールの応答者として

オンコールの応答者は、インシデント呼び出しのステータスを変更することで応答できます。

ステータスを変更すると、次の効果があります:

• 確認済みへ: プロジェクトのエスカレーションポリシーに基づいて、オンコールページを制限します。
• 解決済みへ: インシデントに対するすべてのオンコール呼び出しを停止します。
• 解決済みからトリガーへ: インシデントのエスカレーションを再開します。

GitLab 15.1以前では、アラートから作成されたインシデントのステータスを変更すると、アラートのステータスも変更されます。GitLab 15.2以降では、アラートステータスは独立しており、インシデントステータスが変更されても変更されません。

エスカレーションポリシーを変更

前提要件:

• プロジェクトのデベロッパーロール以上を持っている必要があります。

インシデントのエスカレーションポリシーを変更するには:

1. インシデントの右側のサイドバーで、エスカレーションポリシーの横にある編集を選択します。
2. ドロップダウンリストから、エスカレーションポリシーを選択します。

デフォルトでは、新しいインシデントにはエスカレーションポリシーは選択されていません。

エスカレーションポリシーを選択すると、インシデントのトリガーがトリガーされ、インシデントのエスカレートがオンコールの応答者に開始されます。

GitLab 15.1以前では、アラートから作成されたインシデントのエスカレーションポリシーは、アラートのエスカレーションポリシーを反映しており、変更できません。GitLab 15.2以降では、インシデントエスカレーションポリシーは独立しており、変更できます。

インシデントをクローズ

前提要件:

• プロジェクトのレポーターロール以上が必要です。

インシデントをクローズするには、右上隅で、Incident actions（インシデント）アクション( )を選択し、Close incident（インシデント）をクローズします。

アラートにリンクされているインシデントを閉じると、リンクされているアラートのステータスが解決済みに変わります。次に、アラートのステータス変更がクレジットされます。

リカバリーアラートを介してインシデントを自動的にクローズ

GitLabがHTTPまたはPrometheus Webhookからリカバリーアラートを受信したときに、自動的にインシデントをクローズする機能をオンにします。

前提要件:

• プロジェクトのメンテナー以上のロールを持っている必要があります。

設定を構成するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > モニタリングを選択します。
3. インシデントセクションを展開するします。
4. Automatically close associated incident（関連付けられたインシデントを自動的に閉じる）チェックボックスを選択します。
5. 変更を保存を選択します。

GitLabがリカバリーアラートを受信すると、関連付けられたインシデントが閉じられます。このアクションは、GitLabアラートボットによって自動的に閉じられたことを示す、インシデントに関するシステムノートとして記録されます。

インシデントを削除

前提要件:

• プロジェクトのオーナーロールを持っている必要があります。

インシデントを削除するには:

1. インシデントで、Incident actions（インシデント）アクション( )を選択します。
2. Delete incident（インシデント）を削除を選択します。

または:

1. インシデントで、タイトルと説明を編集( )を選択します。
2. Delete incident（インシデント）を削除を選択します。

その他のアクション

GitLabのインシデントはイシューの上に構築されているため、次のアクションが共通してあります:

• To-Doアイテムを追加します。
• ラベルを追加します。
• マイルストーンを割り当て
• インシデントを機密にする
• 期限を設定する
• 通知の切替
• 費やした時間を追跡する