Slack

Slack

Crawler Crawler

概要

Slack を Datadog に接続すると、以下のことを可能にして、チームのコラボレーションを促進できます。

  • チームのプライベートチャンネルまたは公開チャンネルで、同僚とグラフを共有できます。
  • Slack 内で Datadog からのアラートや通知を受けることができます。

セットアップ

インストール

US リージョンの Datadog アプリをご使用の場合は、Slack ワークスペースで Datadog Slack アプリをインストールします。

  1. Datadog アプリで、「Integrations」の下にある Slack インテグレーションタイルへ移動し、タイル下部の Connect Slack Account ボタンをクリックします。

  2. Slack と Datadog のアカウントが接続されたことを確認します。: この変更を Datadog ワークスペースの管理者に承認してもらう必要がある場合があります(一度のみ)。

: Slack App ディレクトリでの Slack インテグレーションは、US リージョンの Datadog アプリケーションをご使用の場合のみ可能です。他のリージョンについては、Slack Webhook ドキュメントを参照してください。

使用方法

アプリがインストールされたら、Slack アプリをチャンネルに招待できます。

/invite @Datadog

次に、Datadog アカウントを Slack アカウントに接続します。

/datadog accounts

追加機能により、Datadog の一部をコマンド 1 つで Slack で利用することができます。

/datadog dashboard
/datadog slo

あらゆるウィジェットを Datadog から Slack へコピーして貼り付けることも可能です(CMD + CCTRL + C のショートカット、またはウィジェットの拡張アイコンをクリックして “copy” を選択)。貼り付けるとリンクが表示され、チャンネルに送信されたらウィジェットとして開きます。

モニターの接続

ボタンをクリックするだけで、Slack のトリガーモニターをミュートすることができます。

Slack アプリから送信されるようモニターを更新するには、以下の 2 つの方法があります。

一括更新: すべてのモニターが Slack アプリから送信されるように一括で更新することができます。また、コンフィギュレーションの上部にある “Upgrade” ボタンをクリックことで、Datadog のインテグレーションタイルにある各 Slack アカウントにミュートボタンを含められます。

手動: すべてのチームに展開する前にこの機能をテストしたい場合は、Slack インテグレーションのコンフィギュレーションで、手動でチャンネルを新しいアプリのアカウントコンフィギュレーションに追加することができます。 : 同じチャンネルの重複参照を削除する必要がある場合があります。

Datadog インシデントの使用

以下を使用して、Slack アプリから新しいインシデントを宣言します。

/datadog incident 

: Datadog へのアクセス権の有無を問わず、Slack 組織内の誰でもインシデントを宣言できます。

新しいインシデントが作成されると、対応する Slack チャンネル #incident-(unique number ID) が作成され、新しいインシデントチャンネルの使用について伝えるメッセージがチャンネルに送信されます。チャンネルのトピックは、インシデントとともに変わります。

次を使用して、インシデントの状態(重大度)を更新します。

/datadog incident update

次を使用してオープン(アクティブで安定している)インシデントをリスト表示します。

/datadog incident lists

メッセージのアクションコマンド (#incident チャンネルで送信されたメッセージにカーソルを合わせると右の方に表示される3点リーダー) を使用して、Incident App Timeline にメッセージを送信します。

インシデントの更新チャンネル

インシデントの更新チャンネルを使用すると、チームは Slack ワークスペースから、組織全体にすべてのインシデントのステータスを直接公開することができます。ワークスペースで、更新を投稿するチャンネルを選択すると、チャンネルでは以下の投稿を受信します。

  1. 新しく宣言されたインシデント。
  2. 重要度、ステータスの移行、インシデントコマンダーへの変更点。
  3. アプリ内のインシデントの概要ページへのリンク。
  4. 該当するインシデントの Slack チャンネルへの参加リンク。

Slack アプリをインストールしたら、Incident Settings ページに移動します。Incident Updates Channel セクションまでスクロールして、セットアップの手順を開始します。

Slack アプリにログインしたら、インシデントの更新チャンネルとして動作するチャンネルを設定できます。

このチャンネルのセットアップ方法:

  1. インシデント設定にアクセスします。
  2. Incident Updates Channel セクションに移動します。
  3. Slack ワークスペースと、インシデントの更新チャンネルとして使用する特定の Slack チャンネルを定義します。

インシデントタスクの管理

Slack アクションおよび /datadog Slack コマンドを使用することで、Slack から直接インシデントタスクを作成・管理できます。インシデントタスクのコマンドはインシデントチャンネルで使用する必要があります。

Slack アクション: Slack アクションを使用して、インシデントチャンネルで送信されたメッセージにマウスオーバーすることでタスクを作成できます。メッセージの右側に 3 点ドットが表示され、そこから「タスクをインシデントに追加」することができます。

利用可能なコマンド:

  • /datadog task はインシデントのタスクを作成します。表示されるモーダル画面でタスクの説明の入力、チームメイトの割り当て、期限の設定を行うことができます。
  • /datadog task list はあるインシデントについて作成されたすべてのタスクのリストを表示します。このリストを利用してタスクを完了としてマークしたり、再開したりすることができます。

作成されたすべてのタスクは Incidents UI の「Incident Tasks」 下の「Remediation」タブに表示され、管理することができます。詳しくはドキュメントを参照してください。

US リージョン以外の Datadog アプリケーションをご使用の場合は、Slack Webhook をご利用ください。

インストール

Slack インテグレーションは、Datadog アプリケーション内のインテグレーションタイルを使用してインストールします。

コンフィギュレーション

  1. Slack アカウントで、アプリケーションページに移動し、Datadog(レガシー)を検索します。
  2. Install –> Add Integration の順に選択し、次に Slack の Webhook URL をコピーします。
  3. Datadog-Slack インテグレーションタイルの Configuration タブに移動します。
  4. Add Account をクリックします。
  5. 選択した Slack アカウント名を追加します。
  6. Slack Account Hook フィールドに Webhook URL を貼り付けます。
  7. Save をクリックします。
  8. Slack のポスト先のチャンネルを追加します。
  1. グラフへのコメントごとに通知を受けるには、各チャンネルの Transfer all user comments チェックボックスをオンにします。このチェックボックスをオフのままにする場合、コメントが Slack にポストされるようにするには、@slack-<ACCOUNT_NAME>-<CHANNEL_NAME> 構文を使用する必要があります。アカウントを 1 つだけ使用する場合、または最初のアカウントのみを参照する場合は、@slack-<CHANNEL_NAME> も使用できます。

モニターイベントストリームから Slack にアラートを送信するように構成することもできます。

: US 以外の Datadog アプリをご使用で、Slack App ディレクトリ インテグレーションへのアクセスの追加をご希望の場合は、サポートチームまでご連絡ください

モニターアラートからの Slack @-mentions

Slack インテグレーションをセットアップした後、通知メッセージに @slack を入力すると、通知の送信先として使用可能なチャンネルがリスト表示されます。

モニターメッセージテンプレートで @username< > で囲み(例: `@slack-SLACK_CHANNEL <@USERNAME>)、Slack 通知内で定義されているユーザーに @ 通知します。

: 通知の際に問題が発生した場合、Slackの表示名の代わりに username をお使いください。 usernameユーザー名 以下の Slack account settings にあります。

<!here> または <!channel> を使用して、それぞれ @here または @channel をメンションできます。

ユーザーグループには、<!subteam^GROUP_ID> を使用します。GROUP_ID は、Slack の usergroups.list API エンドポイントを検索して見つけられます。たとえば、12345 という ID を持つユーザーグループでは、次の構文を使用します。

<!subteam^12345>

注: Slack @ 通知の場合、チャンネル名の後に特殊文字を付けることはサポートされていません。 @----critical_alerts は機能しますが、@--critical_alerts-- は通知を受信しません。

メッセージテンプレート変数を使用して動的に @ メンションを作成する

モニターメッセージ内でメッセージテンプレート変数を使用して、動的に @ メンションを作成できます。

たとえば、Slack インテグレーションで、次の変数がチャンネルとしてセットアップされている場合

  • @slack-{{owner.name}} は、このモニターの所有者のチャンネルにメッセージを投稿します。

  • @slack-{{host.name}} は、Slack 内の #host.name チャンネルに Slack メッセージを投稿します。

または、特定のメールに直接アクセスする @メンションを作成します。

  • @team-{{team.name}}@company.com は、チームのメーリングリストにメールを送信します。

収集データ

メトリクス

Slack インテグレーションは、メトリクスを提供しません。

イベント

Slack インテグレーションには、イベントは含まれません。

サービスのチェック

Slack インテグレーションには、サービスのチェック機能は含まれません。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。