インシデントを管理する

このページには、インシデント、またはそれに関連して実行できるすべての操作の手順がまとめられています。

インシデントを作成する

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

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

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

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. PagerDuty WebhookインテグレーションにWebhook URLを追加するには、PagerDutyのドキュメントに記載されている手順に従ってください。

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

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

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

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

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

インシデントを表示できるユーザー

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

• 公開プロジェクトおよび非機密のインシデント: 誰でもそのインシデントを表示できます。
• プライベートプロジェクトおよび非機密のインシデント: プロジェクトに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールを持っている必要があります。
• 機密インシデント（プロジェクトの表示レベルに関係なく）: プロジェクトに対して、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールを持っている必要があります。

ユーザーに割り当てる

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

前提条件:

• プロジェクトに対して、レポーター、デベロッパー、メンテナー、またはオーナーのロールを持っている必要があります。

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

1. インシデントの右サイドバーで、担当者の横にある編集を選択します。
2. ドロップダウンリストから、1人または複数のユーザーをassigneesとして追加するために選択します。
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またはPrometheusWebhookからリカバリーアラートを受信したときに、インシデントを自動的にクローズするように設定します。

前提条件:

• プロジェクトに対して、メンテナーまたはオーナーのロールを持っている必要があります。

設定を構成するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > モニタリングを選択します。
3. インシデントセクションを展開する。
4. Automatically close associated incidentチェックボックスを選択します。
5. 変更を保存を選択します。

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

インシデントを削除する

前提条件:

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

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

1. インシデントで、Incident actions ( ) を選択します。
2. Delete incidentを選択します。

または:

1. インシデントで、編集を選択します。
2. Delete incidentを選択します。

その他のアクション

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

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