概要

Slack を Datadog に接続し、次の方法でチームのコラボレーションを支援します。

• Slack のプライベートチャンネルまたはパブリックチャンネルでグラフを共有できます。
• Slack 内で Datadog からのアラートや通知を受けることができます。
• トリガーとなるモニターをミュートし、Slack からインシデントを宣言できます。
• ログイベント、トレース、ダッシュボードウィジェットのプレビューを表示するリンクを自動的に展開します。

計画と使用

Datadog for Slack は サイトでは利用できません。US1-FED サイトの Slack に通知を送信するには、Slack webhook (レガシー) を使用してください。

Slack と Datadog の接続

Slack のワークスペースに Datadog for Slack をインストールします。

1. Slack のインテグレーションタイルで、Configuration をクリックし、Connect Slack Account をクリックします。
2. Datadog に Slack ワークスペースへのアクセス権限を付与するには、Allow をクリックします。この変更を承認するには、Slack ワークスペースの管理者が必要な場合があります。
3. モニターアラートを受信するチャンネルを指定します。
4. プライベートチャンネルのみ: Slack で、モニターアラートを受信したいチャンネルに移動し、/invite @Datadog を送信します。

インフラストラクチャーリスト

Datadog サイトの Slack インテグレーションタイルを使用してインテグレーションをインストールします。

ブラウザトラブルシューティング

1. Slack アカウントで、Datadog (レガシー) アプリにアクセスします。
2. Install > Add Integration をクリックし、次に Slack の Webhook URL をコピーします。
3. Datadog-Slack インテグレーションタイルで、Configuration をクリックし、Add Account をクリックします。
4. 選択した Slack アカウント名を入力します。
5. Slack Account Hook フィールドに webhook URL を貼り付けます。
6. Save をクリックします。
7. Slack のポスト先のチャンネルを追加します。

8. グラフのコメントごとに通知を受けるには、Transfer user comments チェックボックスを選択します。このチェックボックスをオフにした場合、Slack にコメントを投稿するには、@slack-<ACCOUNT_NAME>-<CHANNEL_NAME> 構文を使用する必要があります。1 つのアカウントのみを使用する場合や、最初のアカウントを参照する場合は、@slack-<CHANNEL_NAME> を使用できます。

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

API

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

/invite @Datadog

Slack チャンネルで可能なアクションを見るには、/datadog コマンドを使います。利用できるアクションはチャンネルによって変わります。また、/dd エイリアスを使って /datadog コマンドを実行することもできます。

Slack で使用可能なすべてのコマンドを表示するには

/datadog help

Home タブ

Slack の Datadog アプリの Home タブを使用して、スターを付けたダッシュボード、ノートブック、サービスを表示します。また、過去 24 時間以内にトリガーされたモニターのリストと、関連する Slack チャンネルを表示することもできます。複数の Datadog アカウントに所属している場合は、アカウントを切り替えてタブをフィルタリングしてください。

ログ管理

Slack インテグレーションを使用すると、Slack から直接モニターアラートを受信したり、モニターをミュートしたりすることができます。モニターの作成方法の詳細については、モニターの構成を参照してください。モニターアラートを Slack チャンネルに送信するには、まず /invite @Datadog コマンドを使用して Datadog をチャンネルに招待します。

通知メッセージ

標準の Datadog 通知と同じルール、変数、タグを使用することができます。例えば、この通知はモニターが再通知するときに infrastructure という Slack チャンネルのチームに通知します。

CPU usage has exceeded {{warn_threshold}} on {{ @machine_id.name }}.
{{#is_renotify}}
Notifying @slack-infrastructure <!subteam^12345>
{{/is_renotify}}

チャンネル

通知メッセージの構成時に Slack チャンネルを指定するには、モニターメッセージボックスに @slack と入力すると、通知を送信できるチャンネルのリストが表示されます。

注: チャンネル名の末尾の特殊文字は、Slack の @-通知ではサポートされていません。例えば、@----critical_alerts は機能しますが、@--critical_alerts-- は機能しません。

@-メンション

通知メッセージに @-メンションを作成するには、以下のコマンドを使用します。

メッセージテンプレート変数を使用して、@-メンションを動的に構築することもできます。例えば、レンダリングされた変数が Slack の特定のチャンネルに対応している場合

• @slack-{{owner.name}} は #owner.name のチャンネルに通知を送ります。
• @slack-{{host.name}} は #host.name チャンネルに通知を送ります。

特定のメールアドレスへの @-メンションを作成するには

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

Slack のモニターアラート

モニターアラートが Slack チャンネルに送信されると、いくつかのフィールドが含まれます。

• 通知メッセージ
• モニターのトリガーとなったクエリのスナップショット (グラフ)
• 関連タグ
• 通知を受けたユーザー名またはグループ名

Slack のモニターアラートメッセージに含まれるコンテンツをカスタマイズするには、Slack インテグレーションタイルに移動します。チャンネルごとに、各モニターアラートオプションのチェックボックスを選択またはクリアします。

Slack Webhook (レガシー) から Datadog for Slack へのモニターの移行

モニターがレガシーの Slack webhook を使用している場合、Slack アプリから送信されるようにモニターを更新するには 2 つの方法があります。

• 一括アップグレード: Datadog のインテグレーションタイルの各 Slack アカウントの構成の上部にある Upgrade ボタンをクリックして、すべてのモニターを一括アップグレードします。
• 個別のアップグレード: Slack インテグレーションタイルの新しい構成にチャンネルを手動で追加します。同じチャンネルへの重複参照を削除する必要があるかもしれません。

ライブラリ

ダッシュボードウィジェットのスナップショットを任意の Slack チャンネルに投稿できます。サポートされているウィジェットのリストについては、スケジュールレポートを参照してください。

Slack でダッシュボードウィジェットを共有するには

• Datadog でダッシュボードウィジェットにカーソルを合わせ、CMD + C または CTRL + C を押すか、共有メニューから Copy ボタンをクリックし、リンクを Slack に貼り付けます。
• Slack チャンネルで、/datadog dashboard または /datadog コマンドを送信し、Share Dashboard Widget ボタンをクリックします。
• Datadog for Slack が提供する Workflow Builder を使用して、Slack 自動化ワークフローの一部としてウィジェットスナップショットを投稿します。

注: Slack は最近、Datadog を含むサードパーティアプリのインテグレーションをまだサポートしていない Workflow Builder の新バージョンを導入しました。

ログメトリクス

Datadog へのアクセス権の有無に関わらず、Slack 組織内の誰でもインシデントを宣言することができます。新しいインシデントが作成されると、対応する Slack チャンネル #incident-(unique number ID) が作成され、新しいインシデントチャンネルの使用について伝えるメッセージがチャンネルに送信されます。チャンネルのトピックは、インシデントとともに変わります。

インシデントコマンド

Slack から新しいインシデントを宣言するには

/datadog incident 

インシデントの状態 (重大度など) を更新するには

/datadog incident update

すべてのオープン (アクティブで安定している) インシデントをリスト表示するには

/datadog incident list

メッセージをインシデントタイムラインに送信するには、メッセージアクションコマンドを使用します (#incident チャンネルで送信されたメッセージにカーソルを合わせると表示される 3 つの縦長の点)。

グローバルインシデント更新チャンネル

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

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

グローバルインシデント更新チャンネルをセットアップするには

1. Datadog で、Incidents > Settings > Integrations ページに移動します。
2. Slack タイルで、Send all incident updates to a global channel (すべてのインシデント更新をグローバルチャンネルに送信する) トグルをクリックします。
3. インシデント更新を投稿する Slack ワークスペースと Slack チャンネルを選択します。

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

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

Slack アクション

Slack アクションを使用してタスクを作成するには、インシデントチャンネルで送信されたメッセージにカーソルを合わせます。カーソルを合わせると、メッセージの右側に 3 つの点が表示され、Add Task to Incident でタスクをインシデントに追加することができます。

Slack コマンド

インシデントのタスクを作成するには、/datadog task コマンドを使用します。モーダルが表示され、タスクの説明を含めたり、チームメイトを割り当てたり、期限を設定したりできます。

インシデントに対して作成されたすべてのタスクのリストを表示するには、/datadog task list コマンドを使用します。このリストを使用して、タスクを完了としてマークしたり、再開したりします。

作成されたすべてのタスクは、インシデントの Remediation タブで管理できます。詳細については、インシデント管理ドキュメントを参照してください。

ヘルプ

Datadog for Slack は、以下の OAuth Scope を必要とします。詳しくは、Slack の権限スコープに関するドキュメントを参照してください。

Enterprise Grid の監査ログ

Slack Enterprise Grid 内で発生したイベントやアクションを取り込みます。これには、以下が含まれます。

• ユーザーの作成、削除、更新などのユーザー管理イベント。これには、ユーザーロール、権限、プロファイルの変更も含まれます。
• チャネルとワークスペースの作成、変更、削除に関連するアクションを含む、ワークスペースとチャンネルの管理イベント。また、ワークスペースの設定や権限の変更も追跡します。
• ファイルのアップロード、ダウンロード、削除の追跡、Slack アプリやインテグレーションのインストール、更新、削除の監視など、ファイルとアプリの管理イベント。
• ログイン試行、パスワード変更、2 要素認証イベント、データエクスポートや機密情報へのアクセスなどのコンプライアンス関連アクションを含む、セキュリティおよびコンプライアンスイベント。
• ポリシーの更新、セキュリティ設定の変更、その他の管理上の変更など、Slack 管理者やワークスペース所有者による変更を含む管理者アクションの監査証跡。
• 共有チャンネルの作成、外部招待、ゲストアカウントのアクティビティなど、外部共有とコラボレーションイベント。

詳しくは Slack 公式ドキュメントをご覧ください。

キャプチャされた各イベントは、以下のような詳細な洞察を提供します。

• Action: 実行されたアクティビティ。サポートされているアクションの完全なリストについては、Slack 公式ドキュメントを参照してください。
• Actor: イベントを生成したワークスペースのユーザー。
• Entity: アクターがアクションを起こした対象。
• Context: アクターがエンティティにアクションを起こした場所 (ワークスペースまたはエンタープライズ)。

インフラストラクチャーリスト

Enterprise Grid 組織の所有者のみが、Slack 監査ログの収集を Datadog に認可することができます。

1. Slack インテグレーションタイルで、Audit Logs タブをクリックします。
2. Connect Enterprise Grid ボタンをクリックすると、認可のために Slack にリダイレクトされます。

リクエストされた権限スコープ

ボットトークンのスコープ

オプションの Optional Bot Token Scopes

Datadog for Slack では、オプションの Bot Token Scopes を追加で有効にする必要がある機能があります。これらのスコープは、機能の有効化に基づいて動的に追加され、最初のインストール時には追加されません。

ユーザトークンのスコープ

オプションのユーザートークンスコープ

Datadog for Slack では、オプションのユーザートークンスコープを追加で有効にする必要がある機能があります。これらのスコープは、機能の有効化に基づいて動的に追加され、最初のインストール時には追加されません。

リアルユーザーモニタリング

データセキュリティ

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

ヘルプ

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

ヘルプ

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

ヘルプ

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