Slack でオンコール スケジュールを接続して管理
チームのオンコール スケジュールをチームの Slack チャンネルに接続して、オンコール シフトの変更に関する通知を受け取れるようになりました。オンコール スケジュールを Slack に接続する際には、メッセージ内でその時点のオンコール メンバーをタグ付け、または @メンションするために利用できるエイリアスをセットアップできます。
エイリアスとは
エイリアスとは、スケジュール内のオンコール担当者にタグ付けするために指定する単語です。感嘆符 (!) で始まるため、"hello" のような一般的な単語が誤って通知をトリガーすることはありません。
エイリアスでは次のことが可能です。
アルファベット、数字、ハイフン (-)、またはアンダースコア (_) のみを使用する
文字数は 2 文字から 50 文字まで
スペースを使用しない
複数の Slack チャンネルで、異なるスケジュールに対して同じエイリアスを使用できます。
たとえば、チームのオンコール スケジュールとシャドー スケジュールにリンクした !disturbed のようなエイリアスを作成できます。チャンネルで !disturbed と入力すると、すべての対応者がメッセージ内で即座にタグ付けされます。
Slack チャンネルにスケジュールを接続する
チームの Slack チャンネルにスケジュールをリンクするには、
チャンネルでコマンド
/jsmops oncallを実行して [スケジュールを接続] をクリックします。あるいは、
/jsmops connect scheduleのコマンドを実行してスケジュールの接続を開始できます。
スケジュールを接続するには、次の手順に従います。
Jira Service Management サイトを選択します
接続するスケジュールを選択します。一度に最大 5 つのスケジュールを選択して、チャンネルに接続できます。
チーム チャンネルで受け取る通知の種類を選択します。選択に応じて、接続されたスケジュールでシフトが開始または終了するたびに、通知が直ちに送信されます。
任意で、このスケジュールのエイリアスを作成できます。[エイリアスを作成] オプションを選択すると、エイリアスに関連する追加のフィールドが表示されて、入力できます。
エイリアスを作成するには、次のフィールドに入力します。
メッセージ スタイル: ユーザーがエイリアスを使用したときのボットの返信方法を選択します。
メッセージの下のスレッドで返信するか、チャンネルに新しいメッセージを投稿できます。自動返信: 誰かがエイリアスを使用した際に、ボットが自動的に送信するメッセージを設定できます。これは、オンコール メンバーへのタグ付けに加えて行われます。
誰もオンコールではない場合の自動返信: 誰かがエイリアスを使用したものの、誰もオンコールではない場合 (スケジュールに基づく)、ボットは標準のテキストで返信します。必要に応じて、これをカスタム メッセージに変更できます。
アプリが Slack でオンコール応答をトリガーできるようにします。
既定では、Jira Service Management ChatOps は、Slack ユーザーによって送信された場合にのみ、!support などのエイリアス メッセージに応答します。アプリ、ワークフロー、または Webhook によって送信されたメッセージは、許可リストに追加されていない限り、応答をトリガーしません。
これは、自動化ツール (監視ボットやワークフローなど) にエイリアスを使用してアラートをトリガーさせたい場合に便利です。
許可リストにアプリを追加する
アプリを許可できるのは、アプリがエイリアスを使用してメッセージを送信した後のみです。
許可リストにアプリを追加するには、次の手順に従います。
エイリアス (例:
!incident) を含む、アプリによって送信されたメッセージを探します。メッセージにカーソルを合わせて、[その他の操作 (⋯)] メニューを選択します。
ショートカット リストから [許可リスト アプリ – Jira Service Management] を選択します。
アプリが許可リストに登録されると、確認メッセージが表示されます。そのアプリは、このチャンネルでエイリアスを使用して Jira Service Management ChatOps の応答をトリガーできるようになりました。
許可リストを表示または管理する
許可したアプリを確認するには、次の手順に従います。
Slack コマンド
/jsmops view allowlisted appsを使用するか、オンコールの詳細を表示する ChatOps メッセージから [許可リストを表示] を選択します。
リスト モーダルからアプリをレビューして、アクセスが不要になったものを削除できます。
スケジュール接続を編集する
スケジュール接続を編集するか、チーム チャンネルから切断するには、次の手順に従います。
コマンド
/jsmops oncallを実行します。接続されたスケジュールを管理するには、[Slack] ボタンを使用します。
任意のスケジュールの [その他のオプション (…)] メニューから、[編集] または [接続を解除] を選択します。
コマンド
/jsmops manage connected schedulesを実行します。
スケジュール エイリアスとは
スケジュール エイリアスは、スケジュールの現在のオンコール担当者にタグ付けするために使用できる単語です。誰がオンコールかを確認したり、チーム全体にメッセージを送信したりする代わりに、チャンネルでエイリアスを入力するだけです。Jira Service Management ChatOps ボットが自動的に返信し、適切なオンコール担当者にメンションします。
エイリアスのベスト プラクティス
エイリアスには、シンプルで覚えやすい単語を選択しましょう。
スケジュールの目的と一致していることを確認します。たとえば、スケジュールがサポート チーム用である場合は、!help や !support などのエイリアスを使用します。これにより、他のメンバーにとっても明確になり、使用しやすくなります。
異なるチーム チャンネルにおいて、同様の目的で同じエイリアスを使用すると、このエイリアスを誰もが覚えやすくなります。
複数のサポート チームがある場合、すべてのチームで !help を使用すると、一貫性が保たれて分かりやすくなります。
よくあるご質問
/jsmops whoisoncall コマンドが以前のように機能しないのはなぜですか?
/jsmops whoisoncall コマンドが変更されました。オンコール メンバーのリストのみが表示されるようになりました。
すべてのオンコール スケジュールを表示するには、代わりに /jsmops all schedules コマンドを使用します。
Slack の OAuth 画面に新しい権限が表示されるのはなぜですか?
スケジュールを接続する際に新しい機能を有効にするには、ボットに追加の権限が必要です。これらには、Jira Service Management ChatOps ボットが追加されている公開チャンネルと非公開チャンネルでメッセージを読み取る機能が含まれます。
インシデントの要約やタイムラインなどの AIOps 機能をすでに使用しています。権限をもう一度付与する必要がありますか?
いいえ。Jira Service Management の ChatOps ボットを通じて、インシデントの要約やタイムラインの作成などの AIOps 機能をすでに使用している場合、メッセージの読み取り権限を再度付与する必要はありません。
アトラシアンは、大規模言語モデル (LLM) をトレーニングするために、会社のワークスペースの Slack メッセージの読み取り、保存、または使用を行いますか?
いいえ、行いません。アトラシアンは、当社の LLM のトレーニングにお客様の Slack チャンネルのデータを使用しません。
Jira Service Management ChatOps ボットによるデータの処理方法は、インシデントが Slack チャンネルにリンクされているかどうかによって異なります。
インシデントが Slack チャンネルにリンクされている場合:
インシデントの要約やタイムライン作成などの AIOps 機能を使用していて、ボットが正確に 1 つのインシデントがリンクされているチャンネルにいる場合は、チャンネル メッセージが一時的に保存され、LLM サービスに送信される可能性があります。これは、リクエストされた要約とタイムラインの生成のみに使用されます。データはトレーニング目的で保持されません。
Slack チャンネルにインシデントがリンクされていない場合:
ChatOps ボットは引き続き新しいメッセージ イベントを受信する可能性があります (誰かがチャンネルに投稿した場合など) が、それらが LLM サービスに送信されることはなく、保存されたりトレーニングに使用されたりすることもありません。
ボットが追加されると、アトラシアンはチャンネル内の過去のメッセージを読み取りますか?
いいえ、Jira Service Management ChatOps ボットは、チャンネルに追加される前に送信されたメッセージへのアクセスや読み取りを行いません。ボットが追加されると、そのチャンネルに新しいメッセージが投稿されるたびに、Slack からサービスにイベントが送信されます。
誰がチャンネルへのスケジュール マッピングを接続、編集、または削除を行えますか?
Atlassian アカウントを持つ Slack ワークスペースのユーザーであれば、誰でもチャンネルへのスケジュール マッピングを接続、編集、または削除できます。
エイリアスとは何ですか? “!” をそれ以外の記号に変更できますか?
エイリアスは、複数のスケジュールをリンクするキーワードです。例えば、オンコール スケジュールやシャドー スケジュールを “!disturbed” のようなエイリアスにリンクできます。誰かが Slack チャンネルで “!disturbed” と入力すると、Jira Service Management の ChatOps ボットが両方のスケジュールから現在のオンコール対応者を取得し、チャンネル内でタグ付けします。
チャットボットに自分のメッセージを読まれたくありません。どうしたらよいでしょうか?
次のいずれかの Slack コマンドを使用して、チャンネルから Jira Service Management ChatOps ボットを削除できます。
/kick @Jira Service Management ChatOps/remove @Jira Service Management ChatOps
alias、oncall、または whoisoncall コマンドを入力したときに、Slack チャンネルでユーザーがタグ付けされないのはなぜですか?
ユーザーは Slack アカウントを Atlassian アカウントにリンクしていません。リンクするには、Slack ワークスペースで /connect コマンドを使用します。
レスポンス内のスケジュールまたはユーザー プロファイルのリンクをクリックしたときに、Web サイトが開かないのはなぜですか?
Ctrl (Mac の場合は Cmd) を押しながら URL をクリックしましょう。これでリンクが正常に開くはずです。
セットアップ時に選択しなかったにもかかわらず、オンコールの変更通知が届くのはなぜですか?
考えられる理由は次の 2 つがあります。
同じスケジュールを持つ複数のエイリアスで、通知設定が異なる場合があります。
誰かがエイリアスを編集した可能性があります。設定をご確認ください。
JSM のスケジュールを変更した場合、すぐに反映されますか?
はい、Slack チャンネルにスケジュールが接続されている場合、オンコール担当者の変更は、この機能のすべてのワークフローにおいて即座に反映されます。
まず対応者にタグ付けしてから、カスタム メッセージを表示する自動返信を設定できますか?
いいえ、この動作を変更するための設定は存在しません。
自動返信が機能しないのはなぜですか?
1 つのメッセージで複数のエイリアスを使用した場合、自動返信は送信されません。ただし、メッセージ内の各エイリアスに対して、フォールバック メッセージが送信されます。
例えば、Slack でこのようなメッセージを送信した場合:
!disturbed !scrummaster !shadow、このアラートをチェックして優先順位付けを行ってください
エイリアスが 3 つあるため、自動返信はトリガーされません。ただし、2 つのエイリアスにオンコール対応者がいない場合は、それらのエイリアスにフォールバック メッセージが送信され、残りのエイリアスについてはオンコール対応者がメンションされます。
この機能は非公開チャンネルでも使用できますか?
はい、そうなります。
この内容はお役に立ちましたか?