概要

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

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

セットアップ

モニター

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-- は機能しません。

@-メンション

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

@users*

コマンド: <@username>

Slack のユーザー名を使って Slack ユーザーに通知します。ユーザー名は Slack アカウント設定の Username にあります。例: @slack-SLACK_CHANNEL <@USERNAME>、または @slack-SLACK_ACCOUNT-SLACK_CHANNEL <@USERNAME>

@here

コマンド: <!here>

アラートが送信されているチャンネルに参加しているすべてのオンラインメンバーに通知します。

@channel

コマンド: <!channel>

アラートが送信されているチャンネルに参加しているすべてのメンバーに通知します。

@usergroups

コマンド: <!subteam^GROUP_ID>

Slack のユーザーグループに属するメンバー全員に通知します。例えば、ID が 12345 のユーザーグループには <!subteam^12345> を使います。GROUP_ID を見つけるには、More > Your organization > People > User groups に移動します。ユーザーグループを選択し、省略記号をクリックして、Copy group ID を選択します。また、usergroups.list API エンドポイントをクエリすることもできます。

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

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

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

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

Slack のモニターアラート

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

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

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

Migrate monitors from Slack Webhook (Legacy) to Datadog for Slack

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

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

ダッシュボード

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

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

• Datadog でダッシュボードウィジェットにカーソルを合わせ、CMD + C または CTRL + C を押すか、共有メニューから Copy ボタンをクリックし、リンクを Slack に貼り付けます。
• Slack チャンネルで、/datadog dashboard または /datadog コマンドを送信し、Share Dashboard Widget ボタンをクリックします。

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

Home タブ

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

インシデント

Anyone in your Slack org can declare an incident, regardless of whether they have access to Datadog. When a new incident is created, a corresponding Slack channel #incident-(unique number ID) is created, and a message is sent to the channel telling you the new incident channel to use. The channel topic changes with the incident.

インシデントコマンド

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 タブで管理できます。詳細については、Incident Management を参照してください。

権限

Datadog for Slack requires the following OAuth Scopes. See the Slack permission scopes documentation for more information.

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

オプションの Optional Bot Token Scopes

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

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

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

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

Enterprise Grid の監査ログ

Slack Enterprise Grid 内で発生したイベントやアクションを取り込みます。

Slack 監査ログの収集を開始する

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

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

収集したイベントとアクション

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

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

• アクション: 実行されたアクティビティ。
• Actor: イベントを生成したワークスペースのユーザー。
• Entity: アクターがアクションを起こした対象。
• Context: アクターがエンティティにアクションを起こした場所 (ワークスペースまたはエンタープライズ)。

For more information, see the official Slack documentation.

収集データ

メトリクス

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

イベント

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

サービスチェック

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

トラブルシューティング

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