インシデントの管理

このページでは、インシデントでできること、またはインシデントに関連するすべてのことを説明します。

インシデントの作成

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

インシデントリストから

  • 13.3でGitLab Freeに移行。
  • GitLab 14.5で権限がゲストからレポーターに変更。
  • GitLab 14.8で、incident ラベルの自動適用が削除されました。

前提条件：

  • 少なくともプロジェクトのレポーターロールを持っている必要があります。

インシデントリストからインシデントを作成するには

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. モニター > インシデントを選択します。
  3. インシデントの作成］を選択します。

イシューリストから

GitLab 13.4 で導入されました。

前提条件：

  • 少なくともプロジェクトのレポーターロールを持っている必要があります。

イシューリストからインシデントを作成するには、以下の手順に従います：

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. プラン > イシュー]を選択し、[新しいイシュー]を選択します。
  3. タイプ]ドロップダウン・リストから[インシデント]を選択します。ページではインシデントに関連するフィールドのみを使用できます。
  4. イシューの作成]を選択します。

アラートから

GitLab 13.1で導入されました。

アラート表示時にインシデント・イシューを作成します。インシデントの説明はアラートから入力されます。

前提条件：

  • 少なくともプロジェクトの開発者ロールを持っている必要があります。

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

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. Monitor > Alertsを選択します。
  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人または複数選択します。
  3. ドロップダウン・リスト以外の領域を選択します。

重要度の変更

GitLab 13.4 で、インシデントの詳細ページでの深刻度の編集が導入されました。

利用可能な重大度レベルの詳細については、インシデントリストを参照してください。

前提条件：

  • 少なくともプロジェクトのレポーターロールを持っている必要があります。

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

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

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

ステータスの変更

前提条件：

  • 少なくともプロジェクトの開発者ロールを持っている必要があります。

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

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

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

オンコールレスポンダーとして

オンコール レスポンダーは、ステータスを変更することで、インシデント ページに応答できます。

ステータスを変更すると、次のような効果があります：

  • 確認済みプロジェクトのエスカレーションポリシーに基づき、オンコールページを制限します。
  • 解決済み］：インシデントのすべてのオンコールページを無効にします。
  • 解決済みからトリガーへ］：インシデントのエスカレーションを再開します。

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

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

前提条件：

  • 少なくともプロジェクトの開発者ロールを持っている必要があります。

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

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

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

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

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

メトリクスの埋め込み (削除)

この機能はGitLab 14.7で非推奨となり、16.0で削除されました。

インシデントを閉じる

前提条件：

  • 少なくともプロジェクトのレポーターロールを持っている必要があります。

インシデントを閉じるには、右上隅で［インシデントを閉じる］を選択します。

アラートにリンクされているインシデントを閉じると、リンクされているアラートのステータスが［解決済み］に変わります。その後、アラートのステータスが変更されたことが通知されます。

インシデントの最上部にこのアクションが表示されない場合、プロジェクトまたはインスタンスで機能フラグが有効になっていて、アクションメニューに移動している可能性があります。

回復アラートでインシデントを自動的にクローズ

GitLab 13.4でHTTPインテグレーションに導入されました。

GitLabがHTTPやPrometheusのWebhookから復旧アラートを受け取ったときに、自動的にインシデントをクローズするようにしました。

前提条件：

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

設定を行うには

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 設定 > モニターを選択します。
  3. インシデントセクションを展開します。
  4. 関連するインシデントを自動的に閉じる］チェックボックスを選択します。
  5. 変更を保存を選択します。

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

インシデントを削除

前提条件：

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

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

  1. インシデントで［インシデントアクション］（{ellipsis_v}）を選択します。
  2. インシデントの削除］を選択します。

または

  1. インシデントで、タイトルと説明の編集（{鉛筆}）を選択します。
  2. インシデントの削除］を選択します。

その他のアクション

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