正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

アラート

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

アラートは、インシデント管理ワークフローにおける重要なエンティティです。サービス停止または中断を示す可能性のある重要なイベントを表します。GitLabは、何が起こったのかをより深く調査するためのトリアージ用のリストビューと詳細ビューを提供します。

アラートリスト

少なくともデベロッパーロールを持つユーザーは、プロジェクトのサイドバーのモニタリング > アラートでアラートリストにアクセスできます。アラートリストは、開始時刻でソートされたアラートを表示しますが、アラートリストのヘッダーを選択して、ソート順を変更できます。

アラートリストには、次の情報が表示されます:

オープンアラートの詳細を示すアラートリスト

  • 検索: アラートリストは、タイトル、説明、モニタリングツール、およびサービスフィールドでの簡単なフリーテキスト検索をサポートしています。
  • 重大度: アラートの現在の重要度と、アラートが受けるべき注意の量。すべてのステータスの一覧については、アラート管理の重大度をお読みください。
  • 開始時間: アラートがトリガーされてからの時間。このフィールドは、標準のGitLabパターンX time agoを使用しますが、ユーザーのロケールに応じて、詳細な日付/時刻ツールチップでサポートされています。
  • Alert description(アラートの説明): 最も意味のあるデータをキャプチャしようとするアラートの説明。
  • Event count(イベント数): アラートがトリガーされた回数。
  • Issue: アラートに対して作成されたインシデントイシューへのリンク。
  • ステータス: アラートの現在のステータス:
    • トリガー: まだ調査が開始されていません。
    • 確認済み: 誰かが積極的に問題を調査しています。
    • 解決済み: これ以上の作業は必要ありません。
    • 無視済み: アラートに対してアクションは実行されません。

アラートの重大度

アラートの各レベルには、特定アラートの重大度を識別するのに役立つ、独自に形作られた色分けされたアイコンが含まれています。これらの重大度アイコンは、調査を優先すべきアラートをすぐに識別するのに役立ちます:

クリティカル、高、中、低、情報、不明のレベルに対して異なる色と形を示すアラートの重大度アイコン

アラートには、次のいずれかのアイコンが含まれています:

重大度アイコン色(16進数)
クリティカルseverity-critical#8b2615
severity-high#c0341d
中程度severity-medium#fca429
severity-low#fdbc60
情報severity-info#418cd8
不明severity-unknown#bababa

アラート詳細ページ

アラートリストにアクセスし、リストからアラートを選択して、アラート詳細ビューに移動します。アラートにアクセスするには、少なくともデベロッパーロールが必要です。リスト内のアラートを選択して、アラート詳細ページを確認します。

アラートには、必要な量の情報を提供するために、概要タブとアラートの詳細タブがあります。

アラート詳細タブ

アラートの詳細タブには、2つのセクションがあります。上部のセクションには、重大度、開始時間、イベント数、および元のモニタリングツールなど、重要な詳細の短いリストが表示されます。2番目のセクションには、完全なアラートペイロードが表示されます。

メトリクスタブ

多くの場合、アラートはメトリクスに関連付けられています。メトリクスタブで、メトリクスチャートのスクリーンショットをアップロードできます。

これを行うには、次のいずれかを実行します:

  • upload(アップロード)を選択し、ファイルブラウザから画像を選択します。
  • ファイルブラウザからファイルをドラッグして、ドロップゾーンにドロップします。

画像をアップロードすると、画像にテキストを追加して、元のグラフにリンクできます。

テキストリンクを追加するオプションを備えたインシデントメトリクスタブ

リンクを追加すると、アップロードされた画像の上に表示されます。

アクティビティーフィードタブ

アクティビティーフィードタブは、アラートのアクティビティーのログです。アラートに対してアクションを実行すると、これはシステムノートとして記録されます。これにより、アラートの調査と割り当て履歴のリニアタイムラインが得られます。

次のアクションは、システムノートになります:

3つのシステムノートを示すGitLabアラートフィードアクティビティー

アラートアクション

GitLabには、トリアージを支援し、アラートに対応するためのさまざまなアクションがあります。

アラートのステータスを変更する

アラートのステータスを変更できます。

使用可能なステータスは次のとおりです:

  • トリガー(新しいアラートのデフォルト)
  • 確認済み
  • 解決済み

前提要件:

  • デベロッパーロール以上が必要です。

アラートのステータスを変更するには:

  • アラートリストから:

    1. ステータス列で、アラートの横にあるステータスドロップダウンリストを選択します。
    2. ステータスを選択します。
  • アラートの詳細ページから:

    1. 右側のサイドバーで、編集を選択します。
    2. ステータスを選択します。

メール通知が有効になっているプロジェクトで、アラートの繰り返しに関するメール通知を停止するには、アラートのステータスをトリガーから変更します。

リンクされたインシデントを閉じてアラートを解決する

前提要件:

  • レポーターロール以上が必要です。

アラートにリンクされているインシデントを閉じると、GitLabはアラートのステータスを変更して解決済みにします。その後、アラートのステータス変更が評価されます。

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

  • プラン: Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

オンコールのレスポンダーは、アラートのステータスを変更することにより、アラートページに応答できます。

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

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

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

アラートを割り当てる

大規模なチームでは、アラートの所有権が共有されている場合、誰が調査および作業しているかを追跡するのが難しい場合があります。アラートを割り当てると、どのアラートをどのユーザーが所有しているかを示すことで、コラボレーションと委任が容易になります。GitLabは、アラートごとに1人のアサインのみをサポートしています。

アラートを割り当てるには:

  1. 現在のアラートのリストを表示します:

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

    右側のサイドバーが展開され、ユーザーを割り当てるまたは割り当て解除するための担当者ドロップダウンリストが表示されたアラートの詳細ページ

  3. 右側のサイドバーが展開されていない場合は、サイドバーを展開 chevron-double-lg-right )を選択して展開します。

  4. 右側のサイドバーで、担当者を見つけて、編集を選択します。リストから、アラートに割り当てる各ユーザーを選択します。GitLabは、各ユーザーのTo-Doアイテムを作成します。

アラートの調査または修正の担当部分を完了すると、ユーザーは自分自身をアラートから割り当て解除できます。担当者を削除するには、担当者ドロップダウンリストの横にある編集を選択し、担当者のリストからユーザーをクリアするか、未アサインを選択します。

アラートからTo-Doアイテムを作成

アラートから手動で自分のTo-Doアイテムを作成し、後でTo-Doリストで表示できます。

To-Doアイテムを追加するには、右側のサイドバーでTo-Doアイテムを追加を選択します。

アラートからのトリガーアクション

  • プラン: Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

アラートがトリガーされるたびに、自動的にインシデントを作成することを有効にします。

前提要件:

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

アクションを設定するには:

  1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 設定 > モニタリングを選択します。
  3. アラートセクションを展開し、アラート設定タブを選択します。
  4. Create an incident(インシデントを作成する)チェックボックスを選択します。
  5. オプション。インシデントをカスタマイズするには、Incident template(インシデントテンプレート)から、インシデントの概要に追加されるテンプレートを選択します。ドロップダウンリストが空の場合は、最初にイシューテンプレートを作成します。
  6. オプション。メール通知を送信するには、Send a single email notification to Owners and Maintainers for new alerts(新しいアラートのオーナーとメンテナーに単一のメール通知を送信する)チェックボックスを選択します。
  7. 変更を保存を選択します。