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

Slackでのインシデント管理

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com
  • ステータス: ベータ

この機能の利用可否は、機能フラグによって制御されます。詳細については、履歴を参照してください。この機能はテストには利用できますが、本番環境での使用には適していません。

多くのチームが、Slackでのインシデント発生時にアラートを受信し、リアルタイムで連携しています。GitLab for Slackアプリで以下が可能です:

  • SlackからGitLabインシデントを作成します。
  • インシデントの通知を受信します。

Slackのインシデント管理は、GitLab.comでのみ利用可能です。説明されている機能の一部は、GitLab Self-Managed Slackアプリで利用できる場合があります。

最新情報を得るには、epic 1211をフォローしてください。

Slackからインシデントを管理する

前提要件:

  1. GitLab for Slackアプリをインストールします。これにより、Slackでスラッシュコマンドを使用して、GitLabインシデントを作成および更新できます。

  2. Slackの通知を有効にします。Incidentイベントの通知を有効にし、関連する通知を受信するSlackチャンネルを定義してください。

  3. GitLabがユーザーのSlackユーザーの代わりにアクションを実行することを認可します。各ユーザーは、インシデントスラッシュコマンドを使用する前に、これを行う必要があります。

    認可フローを開始するには、/gitlab <project-alias> issue show <id>のような、インシデントではないSlackスラッシュコマンドを実行してみてください。選択した<project-alias>は、GitLab for Slackアプリが設定されているプロジェクトである必要があります。選択モーダルのハード制限は100プロジェクトです。詳細については、イシュー377548を参照してください。

GitLab for Slackアプリが設定されると、既存のSlackスラッシュコマンドも使用できます。

インシデントを宣言する

SlackからGitLabインシデントを宣言するには:

  1. Slackの任意のチャンネルまたはDMで、/gitlab incident declareスラッシュコマンドを入力します。

  2. モーダルから、関連するインシデントの詳細(以下を含む)を選択します:

    • インシデントのタイトルと説明。
    • インシデントを作成するプロジェクト。
    • インシデントの重大度。

    プロジェクトに既存のincident templateがある場合、そのテンプレートが説明テキストボックスに自動的に適用されます。テンプレートが適用されるのは、説明テキストボックスが空の場合のみです。

    説明テキストボックスにGitLabのクイックアクションを含めることもできます。たとえば、/link https://example.slack.com/archives/123456789 Dedicated Slack channelと入力すると、作成したインシデントに専用のSlackチャンネルが追加されます。インシデントのクイックアクションの完全なリストについては、GitLabクイックアクションの使用を参照してください。

  3. オプション。既存のZoomミーティングへのリンクを追加します。

  4. 作成を選択します。

インシデントが正常に作成されると、Slackに確認通知が表示されます。

GitLabクイックアクションを使用する

SlackからGitLabインシデントを作成するときは、説明テキストボックスでクイックアクションを使用します。次のクイックアクションは、ユーザーに最も関連性が高い可能性があります:

コマンド説明
/assign @user1 @user2GitLabインシデントに担当者を追加します。
/label ~label1 ~label2GitLabインシデントにラベルを追加します。
/link <URL> <text>専用のSlackチャンネル、手順書、または関連リソースへのリンクをインシデントのRelated resourcesセクションに追加します。
/zoom <URL>Zoomミーティングリンクをインシデントに追加します。

SlackにGitLabインシデントの通知を送信する

インシデントの通知を有効にしている場合は、インシデントが開かれたり、閉じられたり、更新されたりするたびに、選択したSlackチャンネルに通知が届くはずです。