Slackのインシデント管理(無料SAAS BETA)
- GitLab 15.7 で
incident_declare_slash_command
というフラグで導入されました。デフォルトでは無効になっています。- ベータ版のGitLab 15.10でGitLab.comで有効に。
フラグ:セルフマネジメントのGitLabでは、この機能は利用できません。GitLab.comでは、この機能は利用可能です。この機能は本番環境では使用できません。
多くのチームがインシデント中に Slack でアラートを受け取り、リアルタイムでコラボレーションしています。GitLab for Slackアプリを使用してください:
- SlackからGitLabインシデントを作成。
- インシデント通知を受け取ります。
Slackのインシデント管理はGitLab.comでのみ利用可能です。説明されている機能の一部は、自分で管理するSlackアプリでも利用できる場合があります。
最新情報を得るには、エピック1211をフォローしてください。
Slackからインシデントを管理
前提条件:
- GitLab for Slackアプリをインストールしてください。こうすることで、Slackでスラッシュコマンドを使ってGitLabインシデントを作成・更新できるようになります。
-
Slack 通知を有効にします。
Incident
イベントの通知を有効にし、関連する通知を受け取る Slack チャンネルを定義してください。 -
GitLabがSlackユーザーの代わりにアクションを行うことを作成者に許可します。各ユーザーは、インシデント・スラッシュ・コマンドを使う前にこれを行う必要があります。
認可フローを開始するには、
/gitlab <project-alias> issue show <id>
のような、インシデントではないSlack のスラッシュコマンドを実行してみてください。選択する<project-alias>
は、GitLab for Slack アプリが設定されているプロジェクトでなければなりません。詳細については、イシュー 377548を参照してください。
GitLab for Slackアプリを設定した後は、既存のSlackスラッシュコマンドを使うこともできます。
インシデントの宣言
SlackからGitLabのインシデントを宣言します:
- Slackの任意のチャンネルまたはDMで、
/gitlab incident declare
スラッシュコマンドを入力してください。 -
モーダルから、以下を含む関連するインシデントの詳細を選択します:
- インシデントのタイトルと説明。
- インシデントを作成するプロジェクト。
- インシデントの重大度。
プロジェクトに既存のインシデント テンプレートがある場合、そのテンプレートが説明テキスト ボックスに自動的に適用されます。説明テキストボックスが空の場合のみ、テンプレートが適用されます。
GitLabクイックアクションを説明テキストボックスに含めることもできます。例えば、
/link https://example.slack.com/archives/123456789 Dedicated Slack channel
と入力すると、作成したインシデントに専用の Slack チャンネルが追加されます。インシデントに対するクイックアクションの完全なリストについては、GitLabクイックアクションを使用するを参照してください。 - オプション。既存のZoomミーティングへのリンクを追加します。
- 作成を選択します。
インシデントが正常に作成されると、Slackに確認通知が表示されます。
GitLabクイックアクションを使う
SlackからGitLabインシデントを作成するときは、説明テキストボックスでクイックアクションを使います。以下のクイックアクションが最も適切かもしれません:
コマンド | 説明 |
---|---|
/assign @user1 @user2 | GitLabインシデントに担当者を追加します。 |
/label ~label1 ~label2 | GitLab インシデントにラベルを追加します。 |
/link <URL> <text> | インシデントのRelated resources セクションに、専用の Slack チャンネル、ランブック、または関連リソースへのリンクを追加します。 |
/zoom <URL> | インシデントに Zoom ミーティングのリンクを追加します。 |
GitLabのインシデント通知をSlackに送信します。
インシデントの通知を有効にしている場合、インシデントがオープン、クローズ、更新されるたびに、選択した Slack チャンネルに通知が届くはずです。