- 重要な情報
- はじめに
- 用語集
- ガイド
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- Service Management
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
Slack を Datadog に接続し、次の方法でチームのコラボレーションを支援します。
Slack のワークスペースに Datadog for Slack をインストールします。
Datadog サイトで、Integrations の下にある Slack インテグレーションタイルへ移動し、タイル下部の Connect Slack Account ボタンをクリックします。
Slack と Datadog のアカウントが接続されたことを確認します。この変更を Slack ワークスペースの管理者に承認してもらう必要がある場合があります (一度のみ)。
Datadog for Slack は、US1-FED サイトではご利用いただけません。US1-FED サイトでの Slack への通知設定については、Slack Webhook のドキュメントをご参照ください。
次のコマンドを使用して、Slack チャンネルで実行できる Datadog のアクションを確認します。
/datadog
また、すべての /datadog
コマンドを実行するために、/dd
エイリアスを使用することができます。
アプリがインストールされたら、Slack アプリをチャンネルに招待できます。
/invite @Datadog
以下を使用して、Slack で使用可能なすべてのコマンドを表示します。
/datadog help
Slack で共有される一部の Datadog リンクは、自動的に展開されプレビューが表示されます。サポートされているリンクには、ログイベント、トレース、ダッシュボードウィジェットが含まれます。ダッシュボードウィジェットを共有するには、ウィジェットにカーソルを合わせて CMD + C
または CTRL + C
を押すか、共有メニューから Copy ボタンをクリックしてクリップボードにコピーし、そのリンクを Slack に貼り付けます。
ボタンをクリックするだけで、Slack のトリガーモニターをミュートすることができます。
Slack アプリから送信されるようモニターを更新するには、以下の 2 つの方法があります。
一括更新: すべてのモニターが Datadog for Slack から送信されるように一括で更新することができます。また、コンフィギュレーションの上部にある “Upgrade” ボタンをクリックことで、Datadog のインテグレーションタイルにある各 Slack アカウントにミュートボタンを含められます。
手動: すべてのチームに展開する前にこの機能をテストしたい場合は、Slack インテグレーションのコンフィギュレーションで、手動でチャンネルを新しいアプリのアカウントコンフィギュレーションに追加することができます。同じチャンネルの重複参照を削除する必要がある場合があります。
Slack を離れることなく、ダッシュボードウィジェットのスナップショットを任意の Slack チャンネルに投稿することができます。
Slack からダッシュボードウィジェットを共有するには、2 つの方法があります。
オンデマンド: /datadog dashboard
を使用するか、/datadog
を使用し、Share Dashboard Widget ボタンをクリックします。
ワークフロービルダー: Datadog for Slack は、Slack 自動化ワークフローの一部としてウィジェットスナップショットを投稿できる Workflow Builder ステップを提供します。
対応ウィジェットの一覧は、スケジュールレポートを参照してください。
以下を使用して、Slack から新しいインシデントを宣言します。
/datadog incident
Datadog へのアクセス権の有無を問わず、Slack 組織内の誰でもインシデントを宣言できます。
新しいインシデントが作成されると、対応する Slack チャンネル #incident-(unique number ID)
が作成され、新しいインシデントチャンネルの使用について伝えるメッセージがチャンネルに送信されます。チャンネルのトピックは、インシデントとともに変わります。
次を使用して、インシデントの状態(重大度など)を更新します。
/datadog incident update
次を使用してオープン(アクティブで安定している)インシデントをリスト表示します。
/datadog incident lists
メッセージのアクションコマンド (#incident チャンネルで送信されたメッセージにカーソルを合わせると右の方に表示される3点リーダー) を使用して、Incident App Timeline にメッセージを送信します。
インシデントの更新チャンネルを使用すると、チームは Slack ワークスペースから、組織全体にすべてのインシデントのステータスを直接公開することができます。ワークスペースで、更新を投稿するチャンネルを選択すると、チャンネルでは以下の投稿を受信します。
Slack アプリをインストールしたら、Incident Settings ページに移動します。Incident Updates Channel セクションまでスクロールして、セットアップの手順を開始します。
Slack アプリに入ったら、インシデント更新のためのチャンネルを設定します。
このチャンネルのセットアップ方法:
Slack アクションおよび /datadog
Slack コマンドを使用することで、Slack から直接インシデントタスクを作成・管理できます。インシデントタスクのコマンドはインシデントチャンネルで使用する必要があります。
Slack アクション: Slack アクションを使用して、インシデントチャンネルで送信されたメッセージにマウスオーバーすることでタスクを作成できます。カーソルを合わせると、メッセージの右側に 3 点ドットが表示され、そこから「タスクをインシデントに追加」することができます。
利用可能なコマンド:
/datadog task
はインシデントのタスクを作成します。表示されるモーダル画面でタスクの説明の入力、チームメイトの割り当て、期限の設定を行うことができます。/datadog task list
はあるインシデントについて作成されたすべてのタスクのリストを表示します。このリストを利用してタスクを完了としてマークしたり、再開したりすることができます。作成されたすべてのタスクは、インシデント UIの Incident Tasks の Remediation タブで管理することができます。詳しくは、インシデント管理ドキュメントを参照してください。
Slack 用インテグレーションは、Datadog サイトのインテグレーションタイルを使用してインストールします。
@slack-<ACCOUNT_NAME>-<CHANNEL_NAME>
構文を使用する必要があります。アカウントを 1 つだけ使用する場合、または最初のアカウントのみを参照する場合は、@slack-<CHANNEL_NAME>
も使用できます。@-mentions
Slack 用インテグレーションをセットアップしたら、通知メッセージに @slack
を入力すると、通知の送信先として使用可能なチャンネルがリストされます。
モニターのメッセージテンプレートで @username
を < >
で囲み(例: @slack-SLACK_CHANNEL <@USERNAME>
または @slack-SLACK_ACCOUNT-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>
標準の Datadog 通知と同じルール、テンプレート変数、タグ、条件を使用します。たとえば、この通知は、再通知時に、infrastructure
と呼ばれる Slack チャネルのサブチームに ping を送信します。
CPU usage has exceeded {{warn_threshold}} on {{ @machine_id.name }}.
{{#is_renotify}}
Notifying @slack-infrastructure <!subteam^12345>
{{/is_renotify}}
Slack @ 通知の場合、チャンネル名の後に特殊文字を付けることはサポートされていません。
たとえば、@----critical_alerts
は機能しますが、@--critical_alerts--
は通知を受信しません。
モニターメッセージ内でメッセージテンプレート変数を使用して、動的に @ メンションを作成できます。
たとえば、Slack 用インテグレーションで、次の変数がチャンネルとしてセットアップされている場合
@slack-{{owner.name}}
は、このモニターの所有者のチャンネルにメッセージを投稿します。
@slack-{{host.name}}
は、#host.name チャンネルに Slack メッセージを投稿します。
または、特定のメールに直接アクセスする @メンションを作成します。
@team-{{team.name}}@company.com
は、チームのメーリングリストにメールを送信します。Slack チャンネルのモニターアラートは、いくつかのフィールドを含んでいます。
Slack インテグレーションタイルで、各フィールドのオン/オフを切り替えることができます。各チャンネルで、通知に含めたい各フィールドの横にあるチェックボックスを選択します。その他のチェックボックスはチェックを外したままにしてください。
Slack 用インテグレーションは、メトリクスを提供しません。
Slack 用インテグレーションには、イベントは含まれません。
Slack 用インテグレーションには、サービスのチェック機能は含まれません。
Datadog for Slack は、以下の OAuth Scope を必要とします。詳しくは、Slack の権限スコープに関するドキュメントを参照してください。
スコープ | リクエスト理由 |
---|---|
channels:join | Datadog の Slack インテグレーションタイルで構成された公開チャンネルに自動で参加します。 |
channels:manage | Datadog Incident Management を使用して、インシデントを管理および修復するチャンネルを作成します。 |
channels:read | Datadog の Slack インテグレーションタイルにチャンネル名のオートコンプリートの提案を提供します。 |
chat:write | 承認されたチャンネルや会話で Datadog のアラートと通知を受け取ります。 |
commands | Datadog のアクションを実行するために、/datadog コマンドとそのエイリアスである /dd を有効化します。 |
groups:read | Datadog の Slack インテグレーションタイルの非公開チャンネルにチャンネル名のオートコンプリートの提案を提供します。 |
im:history | Datadog が Messages タブで、オンボーディングの指示などのメッセージを送信できるようにします。 |
im:read | ダイレクトメッセージから Datadog のアクションを実行するために、/datadog コマンドとエイリアスである /dd を有効化します。 |
im:write | Datadog アカウントに関連する Datadog ボットからのメッセージ、プロンプト、エラーを受信します。 |
links:read | グラフやログサンプルなどの追加情報とともに、会話中の Datadog のリンクを展開します。 |
links:write | グラフやログサンプルなどの追加情報とともに、会話中の Datadog のリンクを展開します。 |
mpim:read | グループダイレクトメッセージから Datadog のアクションを実行するために、/datadog コマンドとエイリアスである /dd を有効化します。 |
reactions:write | インシデントタイムラインに追加されたメッセージに、ショートカットで絵文字のリアクションを追加します。 |
team:read | Datadog の Slack インテグレーションタイルで、ワークスペースの状態を常に最新に保つことができます。 |
users:read | Datadog アカウントに関連付けられた Datadog ユーザーとして、Slack からアクションを実行します。 |
users:read.email | Datadog の Slack 以外で作成されたインシデントのメッセージングとユーザーを追加します。 |
workflow.steps:execute | Slack Workflow Step から Datadog のダッシュボードウィジェットを使ってメッセージを自動送信します。 |
Datadog for Slack では、オプションの Bot Token Scopes を追加で有効にする必要がある機能があります。これらのスコープは、機能の有効化に基づいて動的に追加され、最初のインストール時には追加されません。
スコープ | リクエスト理由 |
---|---|
channels:history | インシデントチャンネルからのメッセージをインシデントタイムラインに自動的に同期します。 |
groups:write | Datadog Incident Management を使用して、インシデントを管理および修復するプライベートチャンネルを作成します。 |
pins:write | インシデントチャンネルに、Datadog インシデントの関連リンクやリソースのピンを作成します。 |
bookmarks:write | 対応中のインシデントチャンネルで重要なリンクをブックマークします。 |
bookmarks:read | 重要なリンクのブックマークは、変更したときに編集します。 |
スコープ | リクエスト理由 |
---|---|
identity.basic | Datadog のアカウントと接続することで、Slack から Datadog のアクションを実行します。 |
ご不明な点は、Datadog のサポートチームまでお問合せください。