概要
Microsoft Teams と統合して、以下のことができます。
- Microsoft Teams で Datadog アラートとイベントの通知を受信
- Microsoft Teams の中からインシデントを管理することができます。
Microsoft Teams チャンネルへのモニター通知の送信
セットアップ
Microsoft のテナントを Datadog に接続します。
- Datadogで、Integrations > Microsoft Teams の順に移動します。
- Add Tenant をクリックすると、Microsoft に移動します。
- 画面の指示に従って、OK をクリックします。
Datadog 通知を受信させたいすべてのチームに Datadog アプリが追加されていることを確認します。
- Microsoft Teams の左サイドバーで、Apps をクリックし、Datadog アプリを検索します。
- Add ボタンの横にあるドロップダウン矢印をクリックし、Add to a team をクリックします。
- Datadog 通知を受信させたいチームを選択します。
- Set up a bot をクリックします。
ボットをチームに追加したら、Datadog で通知ハンドルを構成します。
- 構成されたテナントの下で、Add Handle をクリックします。ハンドルに名前を付け、ドロップダウンメニューから希望のチームとチャンネルを選択し、Save をクリックします。
旧来コネクタのテナントベースインテグレーションへの移行
Microsoft は、Microsoft Teams 用の Office 365 コネクタが非推奨となり、2025 年 12 月 31 日 (従来は 2024 年 10 月 1 日) に機能停止することを発表しました。コネクタの新規作成は 2024 年 8 月 15 日からブロックされます。詳細は同社のブログ記事を参照してください。
旧来の Office 365 コネクタを現在使用しているすべての通知ハンドルを Datadog のテナントベースのインテグレーションに移行するには、以下の手順に従います。
- セットアップ手順 に従って Microsoft テナントを Datadog に接続します。
- 旧来の Office 365 コネクタが構成されているすべてのチームに Datadog アプリを追加します。
- Microsoft Teams インテグレーションタイルの各レガシー通知コネクタハンドルについて:
- 構成されているテナントの下にある Add Handle をクリックします。
- 新しいハンドルに、コネクタハンドルと同じ名前を付けます。例えば、旧来のコネクタハンドルの名前が
channel-123
の場合、テナント構成に channel-123
という名前で新しいハンドルを作成します。 - 旧来のコネクタハンドルがメッセージを送信していたドロップダウンメニューから希望するチームとチャンネルを選択し、Save をクリックします。この新しいハンドルは既存の旧来のコネクタハンドルをオーバーライドします。
コネクターのセットアップ (レガシー)
レガシー通知ハンドルは、同じ @teams-HANDLE_NAME
を使用しない限り新しいセットアップの影響を受けませんが、使用する場合は新しい構成がレガシー構成をオーバーライドします。
チャンネルのリストで、チャンネル名の横にある ...
ボタンを選択し、Connectors を選択します。
Datadog を検索し、Configure をクリックします。
コネクタ構成モーダルで、Webhook URL をコピーします。
Datadogで、Integrations > Microsoft Teams の順に移動します。
Configuration タブで、Add Handle をクリックしてハンドルに名前を付け、webhook URL を貼り付けます。
コネクタ構成モーダルで、Save をクリックします。
使用方法
Datadog モニターから、@-notification
機能を使用して、Microsoft Teams に通知を送信します。通知を @teams-<HANDLE>
というアドレスに送信し、<HANDLE>
を Microsoft Teams のハンドル名に置き換えます。
Microsoft Teams における Datadog Incident Management
アカウント設定
まず、Microsoft Teams に Datadog アプリをインストールします。
- Microsoft Teams を開きます。
- 垂直ツールバーの Apps をクリックします。
- “Datadog” を検索し、タイルをクリックします。
- Datadog アプリをインストールするには、 Add をクリックします。「Add」ボタンの隣にあるドロップダウンメニューを開き、 Add to a team を選択します。
- ドロップダウンメニューで、アプリを追加するチームを選択し、 Set Up をクリックしてインストールを完了します。
次に、Microsoft のテナントを Datadog に接続します。
- Datadog で、Microsoft Teams Integration Tile に移動します。
- Add Tenant をクリックすると、Microsoft に移動します。
- 画面の指示に従って、OK をクリックします。
Datadog Incident Management の一部の機能では、テナント上でアクションを実行するための権限が必要です。たとえば、インシデント用の新しいチームを作成する場合などです。テナント全体に対する管理者の同意を得るには、Microsoft 組織を代表して同意を与える権限を持つ人物が必要です。例えば、Global Admin ロールが割り当てられたユーザーが該当します。Datadog アプリケーションにテナント全体に対する管理者の同意を付与できる人物についての詳細は、Microsoft Entra ID ドキュメントをご覧ください。
同意を付与するには
- Datadog で Microsoft Teams インテグレーションタイルに移動します。
- Incident Management を使用したいテナントで、右側の歯車アイコンをクリックします。
- Authorize Tenant をクリックすると、Microsoft にリダイレクトされます。テナント全体の管理者同意を付与できるユーザーが、この手順を実行する必要があります。このユーザーは Datadog アカウントを持っている必要がありますが、Datadog アカウントで使用するメールアドレスは Microsoft アカウントのメールアドレスと一致する必要はありません。
- 画面の指示に従って、OK をクリックします。
ユーザー設定
Microsoft Teams から Datadog のアクションを実行するには、Datadog と Microsoft Team のアカウントを接続する必要があります。
Microsoft Teams からアカウントを接続するには
Microsoft Teams を開きます。
垂直ツールバーの ...
ボタンをクリックし、Datadog を選択すると、Datadog ボットとのチャットが開始されます。
“accounts” と入力し、エンターキーを押します。
Datadog ボットが、アカウントの接続方法について応答します。Connect Datadog Account をクリックします。
その後、Datadog ボットが、アカウントを接続するためのリンクが含まれたメッセージを送信します。リンクをクリックし、プロンプトに従います。
Microsoft Teams Integration Tile へと戻ります。
Microsoft Teams Integration Tile のプロンプトで Create をクリックし、アプリケーションキーを作成します。
Datadog からアカウントを接続することも可能です。
- Datadog で、Microsoft Teams Integration Tile に移動します。
- 表示されたテナントの中から、Connect をクリックします。
- 画面の指示に従って、OK をクリックします。
- Microsoft Teams インテグレーションタイルから、上記のプロンプトで Create をクリックしてアプリケーションキーを作成します。
使用方法
ダッシュボード
ダッシュボードウィジェットのスナップショットを任意のチームまたはチャットに投稿できます。サポートされているウィジェットのリストについては、スケジュールレポートを参照してください。
Teams でダッシュボードウィジェットを共有するには
- Datadog でダッシュボードウィジェットにカーソルを合わせ、
CMD + C
または CTRL + C
を押すか、共有メニューから Copy ボタンをクリックします。 - リンクを Teams に貼り付けます。
インシデント
Microsoft Teams から新しいインシデントを宣言するには
- 任意のチームで会話を開始します。
@Datadog
と入力するか、...
ボタンで Messaging extensions メニューを開き、Datadog アプリを選択します。- Create an Incident を選択します。
- 希望の情報をフォームに入力します。
- Create をクリックします。
Datadog へのアクセス権の有無を問わず、Microsoft Teams テナント内の誰でもインシデントを宣言できます。
新しいインシデントが作成されると、incident-( 一意の番号 ID )
という名前の対応するチームが作成されます。
インシデントを更新するには、作成と同様の手順で行います。
- インシデントチームにいながら、会話を始めます。
@Datadog
と入力するか、...
ボタンで Messaging extensions メニューを開き、Datadog アプリを選択します。- Update Incident を選択します。
- 希望の情報をフォームに入力します。
- Update をクリックします。
次を使用してオープン(アクティブで安定している)インシデントをリスト表示します。
インシデントチーム内のメッセージの右端にある “More actions” メニューを使用すると、そのメッセージをインシデントタイムラインに送信することができます。
インシデントの更新チャンネル
インシデント更新チャンネルを使用すると、関係者は Microsoft Teams から直接、すべてのインシデントのステータスを組織全体で確認することができます。これらのアップデートを投稿するチームとチャンネルをアカウントで選択すると、チャンネルは次の投稿を受け取ります。
- 新しく宣言されたインシデント。
- 重要度、ステータスの移行、インシデントコマンダーへの変更点。
- アプリ内のインシデントの概要ページへのリンク。
- インシデント専門チームへの参加リンク。
Microsoft Teams アプリがインストールされたら、Incident Settings ページに移動できます。ここから、Incident Updates Channel セクションまでスクロールダウンし、セットアップフローを開始することができます。
インシデントチャンネルの設定方法
- Incidents Settings に移動します。
- Microsoft Teams セクションで、接続している Microsoft Teams テナントを選択します。
- Automatically create a Microsoft Teams channel for every incident (インシデントごとに Microsoft Teams チャンネルを自動的に作成する) をオンに切り替えます。
- 新しいチャンネルを自動的に作成するチームを選択します。
- 設定を保存します。
データ収集
メトリクス
Microsoft Teams インテグレーションは、メトリクスを提供しません。
イベント
Microsoft Teams インテグレーションには、イベントは含まれません。
サービスチェック
Microsoft Teams インテグレーションには、サービスのチェック機能は含まれません。
権限
Microsoft Teams インテグレーションは、追加されたチームに対して以下の権限を受け取ります。詳細については、Microsoft アプリ権限リファレンスを参照してください。
権限の説明 | リクエスト理由 |
---|
私が提供するメッセージとデータを受信します。 | ユーザーは、Datadog アプリと個人チャットでやり取りすることができます。 |
私にメッセージや通知を送信します。 | ユーザーは、Datadog アプリと個人チャットでやり取りすることができます。 |
名前、メールアドレス、会社名、使用言語など、私のプロフィール情報にアクセスします。 | Datadog UI 内で Microsoft Teams の通知やワークフローを構成することができます。 |
チームやチャットのメンバーがチャンネルやチャットで提供するメッセージやデータを受信します。 | ユーザーは、@Datadog コマンドを通して Datadog とやり取りすることができます。 |
チャンネルやチャットでメッセージや通知を送信します。 | 構成されたターゲットに Datadog 通知を送信します。 |
チームやチャットの情報 (チーム名やチャット名、チャンネルリスト、名簿 (チームやチャットメンバーの名前やメールアドレスを含む)) にアクセスし、それを使って連絡を取ることができます。 | ユーザーが Datadog 内で Microsoft Teams の通知やワークフローを構成できるようにします。 |
Microsoft Teams インテグレーションで Incident Management 機能を使用するには、追加の権限が必要です。これらは、テナント全体の権限を持つユーザーによって認可される必要があります (詳細な手順については、 Microsoft Teams の Datadog Incident Management: アカウントのセットアップを参照してください)。これらの権限の詳細については、 Microsoft Graph 権限リファレンスを参照してください。
API / 権限の名前 | タイプ | リクエスト理由 |
ChannelSettings.ReadWrite.All | アプリケーション | Datadog Incident Management を使用してインシデントを解決するために、チャンネルを作成および変更します。 |
GroupMember.Read.All | アプリケーション | Datadog Incident Management の構成用に、チームおよびチャンネル名のオートコンプリート候補を提供します。 |
Team.Create | アプリケーション | Datadog Incident Management を使用してインシデントを管理および解決するために、チームを作成します。 |
TeamMember.ReadWrite.All | アプリケーション | Datadog Incident Management を使用してインシデントを管理するために、ユーザーをチームに追加します。 |
TeamsAppInstallation.ReadWrite.All | アプリケーション | Datadog Incident Management によって作成されたチームに Datadog アプリを追加します。 |
TeamSettings.ReadWrite.All | アプリケーション | インシデントチームの状態で Datadog Incident Management を最新に保ちます。 |
トラブルシューティング
SSO の使用
次の手順を使用して、新しいチャンネルコネクターを設定します。
Datadog にログインし、セットアップ手順 1 および 2 を完了します。
セットアップ手順 3 で MS Teams ページから Datadog にリダイレクトされたら、新しいタブを開き、SSO で Datadog にログインします。次に、セットアップ手順 4 を個別に実行します。
インテグレーションタイルにチームが表示されないのはなぜですか?
テナントを Datadog に追加する前にボットをチームに追加した場合、Datadog はチーム参加イベントを見逃し、チームの存在を知ることができません。
以下のいずれかを試すことができます。
- Datadog アプリをチームから削除し、再度追加します。注: この操作により、そのチームの構成コネクタが削除されます。そのチームのすべてのコネクタをテナントベースのインテグレーションに移動する準備ができたら、このアクションを実行してください。
- 左サイドバーのチーム名の横にある 3 つの点をクリックします。
- Manage Team をクリックします。
- Apps というラベルの付いたタブに移動します。
- Datadog アプリの横にある 3 つの点をクリックします。
- Remove をクリックします。
- セットアップ手順に従って Datadog アプリを追加します。
- Datadog が利用可能なすべての Microsoft Teams チャンネルをクロールするための管理者同意を認可します。
- Datadog で Microsoft Teams インテグレーションタイルに移動します。
- 管理者同意を付与したいテナントで、右側の歯車アイコンをクリックします。
- Authorize Tenant をクリックすると Microsoft にリダイレクトされます。この手順を実行するには、テナント全体に対する管理者同意を与えることができるユーザーが必要です。注: Microsoft のユーザーが Datadog のアカウントを持っている必要はありません。
- 画面の指示に従って、OK をクリックします。
- 数時間以内にクローラーが実行され、利用可能なすべてのチームとチャンネルが入力されます。
プライベートチャンネルはボットでサポートされていますか?
Microsoft Teams のプライベートチャンネルの制限により、プライベートチャンネルはボットでサポートされていません。
ご不明な点は、Datadog のサポートチームまでお問い合わせください。