Microsoft Teams チャンネルへのモニター通知の送信

Microsoft のテナントを Datadog に接続します。

1. Datadog で、Integrations > Microsoft Teams に移動します。
2. Add Tenant をクリックすると、Microsoft に移動します。
3. 画面の指示に従って、OK をクリックします。

ボットをチームに追加したら、Datadog で通知ハンドルを構成します。

1. 構成されたテナントの下で、Add Handle をクリックします。ハンドルに名前を付け、ドロップダウンメニューから希望のチームとチャンネルを選択し、Save をクリックします。

旧来コネクタのテナントベースインテグレーションへの移行

Microsoft は、Microsoft Teams 向け Office 365 コネクタの非推奨化を発表しました。これには次の影響があります:

• すべての Datadog コネクタは 2025 年 1 月 31 日に機能しなくなります。
• 更新済み URL のない Incoming Webhook コネクタは 2025 年 1 月 31 日に機能しなくなります。
• すべてのコネクタは 2025 年 12 月 31 日に機能しなくなります (以前は 2024 年 10 月 1 日)。

詳細は、Microsoft の ブログ記事 を参照してください。

レガシーな Office 365 コネクタを現在使用している通知ハンドルを Datadog のテナント ベースのインテグレーションに移行するには:

Usage

Datadog モニターから、@-notification 機能 を使用して Microsoft Teams に通知を送信します。通知はアドレス @teams-<HANDLE> 宛てに送信します。<HANDLE> は Microsoft Teams ハンドル名に置き換えます。Microsoft Teams からトリガーされたモニターをミュートするには、Mute Monitor をクリックし、Mute Duration を選択して、Mute をクリックします。

ユーザー メンション

ユーザー メンションを使用すると、モニターのアラートがトリガーされたときに Microsoft Teams のチャネルで特定のユーザーに通知できます。これにより、重要なイベントについて適切な担当者に確実に通知できます。特定のユーザーにメンションするには、以下の手順に従ってユーザー プリンシパル名 (UPN) を見つけます。

構文: <at>{User Principal Name}</at>

例: <at>user@microsoft.com</at>

完全な通知例: @teams-CHANNEL_NAME <at>user@microsoft.com</at> <at>another.user@microsoft.com</at>

ユーザーのユーザー プリンシパル名 (UPN) を見つけるには:

1. 方法 1 (UPN がメール アドレスと一致する場合のみ有効):

   • Microsoft Teams で、そのユーザーのプロフィール写真または名前をクリックして、連絡先カードを開きます。
   • Chat フィールドに表示されるメール アドレスは、多くの場合 UPN です。異なる場合は、以下の 方法 2 を使用します。

2. 方法 2 (常に有効ですが、Azure Portal の権限が必要):

   • Microsoft Azure Portal にサインインします。
   • Microsoft Entra ID > Manage > Users に移動します。
   • リストで該当ユーザーを見つけ、User principal name 列から UPN をコピーします。

確実な配信を確認するため、Datadog はモニター通知のテストを推奨します。手順については、通知のテスト を参照してください。

ダッシュボード

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

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

1. Datadog でダッシュボードウィジェットにカーソルを合わせ、CMD + C または CTRL + C を押すか、共有メニューから Copy ボタンをクリックします。
2. リンクを Teams に貼り付けます。

編集アクセス権の制限

既定では、接続済みの Microsoft Teams テナントに対して、すべてのユーザーにフル アクセスが付与されています。

特定のテナントを編集できるロールを制限するには、きめ細かなアクセス制御 を使用します:

1. テナントを表示している間に、右上の歯車アイコンをクリックして設定メニューを開きます。
2. Permissions を選択します。
3. Restrict Access をクリックします。ダイアログボックスが更新され、組織のメンバーはデフォルトで Viewer アクセス権を持っていることが表示されます。
4. ドロップダウンを使用して、Microsoft Teams テナントを編集できる 1 つ以上のロール、チーム、またはユーザーを選択します。
5. Add をクリックします。ダイアログ ボックスが更新され、選択したロールに Editor 権限が付与されたことが表示されます。
6. Save をクリックします。

注: テナントに対する編集アクセスを維持するには、保存前に自分が所属するロールを少なくとも 1 つ含める必要があります。

編集アクセスがある場合、以下の手順を完了することで、制限されたテナントへの一般アクセスを復元できます:

1. テナントを表示中に、右上の歯車アイコンをクリックして設定メニューを開きます。
2. Permissions を選択します。
3. Restore Full Access をクリックします。
4. Save をクリックします。

Microsoft Workflows Webhooks とは何ですか？

Workflows / Power Automate は、自動化されたワークフローを作成するための Microsoft 製品です。Microsoft Workflows を使用すると、Incoming Webhook で通知を送信できます。推奨は Microsoft Teams テナントへの Datadog アプリのインストールですが、インストールできない場合やプライベート チャネルに通知を送信したい場合は、Datadog ハンドルを構成して Microsoft Workflows 経由で Microsoft Teams のチャネルに通知を送信できます。このインテグレーションは、次の Microsoft Workflows テンプレートでの使用を想定しています: Webhook リクエストを受信したときにチャネルに投稿

レガシー コネクタを Microsoft Workflows Webhooks インテグレーションに移行しますか？

Microsoft は、Microsoft Teams 向け Office 365 コネクタの非推奨化を発表しました。既存のコネクタ URL は 2025 年 1 月 31 日に動作を停止します。Microsoft は、レガシー コネクタの代替として Microsoft Workflows の incoming webhooks の使用を推奨しています。現在レガシー Office 365 コネクタを使用しているすべての通知ハンドルを Datadog の Microsoft Workflows webhooks インテグレーションに移行するには、以下の手順に従ってください。

Microsoft Teams インテグレーション タイル内の各レガシー コネクタ ハンドルについて:

1. セットアップ手順 に従って、目的の Microsoft Teams チャネル向けのワークフロー Webhook ハンドルを作成します。
2. Microsoft Workflows Webhooks セクションで、新しいハンドルに置き換える対象のコネクタ ハンドルと同じ名前を付けます。たとえば、レガシー コネクタ ハンドル名が channel-123 の場合、Microsoft Workflows Webhooks セクションで新しいハンドルにも channel-123 という名前を付けます。この新しいハンドルが既存のレガシー コネクタ ハンドルを上書きします。

Microsoft Workflows Webhook を作成する

前提条件

• 新しいワークフローを作成する際、ワークフローの所有およびチャネルへの通知送信の双方に Microsoft アカウントが必要です (同一の Microsoft アカウントである必要はありません)。
• ワークフローを所有するアカウント (以下の手順 2 で構成) が、ワークフローの編集および更新を行えるアカウントです。共有アクセス性を高めるには、サービス アカウントの使用を推奨します。
• チャネルに通知を送信するアカウント (以下の手順 8 で構成) は、そのアカウントのユーザーとして投稿します。このアカウントは、通知を送信したいチームのメンバーである必要があります。プライベート チャネルに通知を送信する場合は、このアカウントをチャネルにも追加する必要があります。このアカウントに「Datadog Notifications」のような名前を付けたい場合は、サービス アカウントを使用してください。

手順

注: これらの手順の多くは Microsoft Workflows 側での操作です。Microsoft が Workflows を更新すると、以下の手順は最新の変更を反映していない場合があります。

1. Microsoft Teams で、Workflows アプリ を通知したいすべてのチームに追加します。チームにアプリを追加できない場合は、以下の “Private channels” セクションの手順に従ってください。

2. Microsoft の Webhook リクエストを受信したときにチャネルに投稿 テンプレートから、Power Automate で新しいワークフローを作成します。

3. ワークフローの所有に使用する Microsoft アカウントを選択します (共有アクセスを容易にするため、サービス アカウントの使用を推奨)。その後、Continue をクリックします。

4. Edit in advanced mode をクリックします。

5. Send each adaptive card を展開し、Post card in a chat or channel をクリックします。

6. Post As のドロップ ダウンで Post as を Flow bot に設定します。通知は「<NAME> via Workflows」から送信されたように表示されます。これらの通知を受信するには、Workflows アプリケーションを目的のチームに追加する必要があります。プライベート チャネルに通知を送信する場合は、Post As をそのチャネル内のユーザーに設定する必要があります。詳細は下記の “Private channels” セクションを参照してください。注: Post as を変更すると、Post in フィールドがリセットされます。

7. チームおよびチャネルのドロップ ダウンにアクセスするには、@ 記号を削除するか、X アイコンをクリックして取り除きます。

8. ドロップ ダウンを使用して、目的のチームとチャネルを選択します。

9. 通知送信用に意図した Microsoft アカウント (例: “Datadog Notifications” という名前のサービス アカウント) にワークフローが接続されていることを確認します。通知は「<NAME> through Workflows」から送信されたように表示されます。このアカウントは、構成済みの Microsoft Teams チャネルにアクセスできる必要があります。アカウントを変更するには、Change connection をクリックし、表示に従って別の Microsoft アカウントを構成します。

10. Save ボタンをクリックします。

11. Webhook リンクを見つけるには、ワークフローの最初のブロックをクリックします。

12. Anyone がフローをトリガーできることを確認し、リンクをコピーします。

13. Back ボタンをクリックして、ワークフローのダッシュボードに移動します。

14. ダッシュボードで、ワークフローがオンになっていることを確認します。オフの場合は、“Turn on” ボタンをクリックします。

15. Datadog で、Integrations > Microsoft Teams に移動します。

16. Configuration タブで Microsoft Workflows Webhooks セクションに進み、Add Handle をクリックします。ハンドルに名前を付け (レガシー コネクタ ハンドルから移行する場合は、対応するコネクタ ハンドルと同じ名前を使用)、Webhook URL を貼り付けます。

17. Save をクリックします。

プライベート チャネル

プライベート チャネルに通知を送信するには、Post Card to chat or channel ブロック内で構成されたアカウントがそのチャネルにアクセスできる必要があります。これにより、ワークフローはそのユーザー アカウントの代理として通知を送信できます。

1. Post Card to chat or channel ブロック内で、Post as を User に変更します。

2. 次に、アカウントを選択するため Change connection をクリックし、表示に従ってアカウントを変更します。

制限

• Microsoft 365 のお客様は、成功したトリガーが 90 日間発生しない場合、ワークフローは自動的にオフになります。ワークフローの有効期限が近づくと、Microsoft はワークフローの所有者アカウントにメールを送信します。この 90 日のタイマーは、Microsoft Workflows 内でテストを実行することでリセットできます。

• テンプレートを使用している場合、すべてのメッセージの末尾に、ワークフローの作成者とテンプレートへのリンクを示す 1 行のテキストが追加されます。

  これを削除するには、対象のワークフローを開いて Save As をクリックしてコピーを作成し、My Flows 内でそのコピーを見つけて開き、元のワークフローではなくコピーしたワークフローの新しい Webhook を使用します。

• Microsoft Workflows は、投稿するメッセージに対するインタラクティブな機能 (Microsoft Teams から直接モニターをミュートするなど) をサポートしません。

• Microsoft Workflows は、共有チャネルをサポートしません。

• Microsoft Workflows では、Post as を User に設定して Workflows Webhook を投稿する場合、ユーザー メンションはサポートされません。

Usage

Datadog モニターから、@-notification 機能 を使用して Microsoft Teams に通知を送信します。通知はアドレス @teams-<HANDLE> 宛てに送信します。<HANDLE> は Microsoft Teams ハンドル名に置き換えます。

Microsoft Workflows Webhooks ハンドルでのユーザー メンション

ユーザー メンションを使用すると、モニターのアラートがトリガーされたときに Microsoft Teams のチャネルで特定のユーザーに通知できます。これにより、重要なイベントについて適切な担当者に確実に通知できます。特定のユーザーにメンションするには、以下の手順に従ってユーザー プリンシパル名 (UPN) を見つけます。

構文: <at>{User Principal Name}</at>

例: <at>user@microsoft.com</at>

完全な通知例: @teams-CHANNEL_NAME <at>user@microsoft.com</at> <at>another.user@microsoft.com</at>

ユーザーのユーザー プリンシパル名 (UPN) を見つけるには:

1. 方法 1 (UPN がメール アドレスと一致する場合のみ有効):

   • Microsoft Teams で、そのユーザーのプロフィール写真または名前をクリックして連絡先カードを開きます。
   • Chat フィールドに表示されるメール アドレスは、多くの場合 UPN です。異なる場合は、以下の 方法 2 を使用します。

2. 方法 2 (常に有効ですが、Azure Portal の権限が必要):

   • Microsoft Azure Portal にサインインします。
   • Microsoft Entra ID > Manage > Users に移動します。
   • リストで該当ユーザーを見つけ、User principal name 列から UPN をコピーします。

確実な配信を確認するため、Datadog はモニター通知のテストを推奨します。手順については、通知のテスト を参照してください。

編集アクセス権の制限

既定では、すべてのユーザーに各 Microsoft Workflows Webhook ハンドルへのフル アクセスが付与されています。

特定の Workflows Webhook ハンドルを編集できるロールを制限するには、きめ細かなアクセス制御 を使用します:

1. Workflows Webhooks を表示中に、対象のハンドルにカーソルを合わせて、行の右側にアクションを表示します。
2. Permissions と表示された鍵アイコンをクリックします。
3. Restrict Access をクリックします。ダイアログボックスが更新され、組織のメンバーはデフォルトで Viewer アクセス権を持っていることが表示されます。
4. ドロップ ダウンを使用して、その Workflows Webhook ハンドルを編集できる 1 つ以上のロール、チーム、またはユーザーを選択します。
5. Add をクリックします。ダイアログ ボックスが更新され、選択したロールに Editor 権限が付与されたことが表示されます。
6. Save をクリックします。

注: Workflows Webhook ハンドルに対する自分の編集アクセスを維持するには、保存前に自分が所属するロールを少なくとも 1 つ含める必要があります。

編集アクセスがある場合、以下の手順を完了することで、制限された Workflows Webhook ハンドルへの一般アクセスを復元できます:

1. Workflows Webhooks を表示中に、制限されたハンドルにカーソルを合わせて、行の右側にアクションを表示します。
2. Permissions と表示された鍵アイコンをクリックします。
3. Restore Full Access をクリックします。
4. Save をクリックします。

API 経由で Workflows Webhooks の権限を編集するには:

1. Microsoft Teams Integration API を使用して、Workflows Webhooks の ID を取得します。
2. Restriction Policies API を使用します。Resource Type は integration-webhook、id は microsoft-teams:<workflows_webhook_id> です。

旧来コネクタのテナントベースインテグレーションへの移行

Microsoft は、Microsoft Teams 向け Office 365 コネクタの非推奨化を発表しました。これには次の影響があります:

• すべての Datadog コネクタは 2025 年 1 月 31 日に機能しなくなります。
• 更新済み URL のない Incoming Webhook コネクタは 2025 年 1 月 31 日に機能しなくなります。
• すべてのコネクタは 2025 年 12 月 31 日に機能しなくなります (以前は 2024 年 10 月 1 日)。

詳細は、Microsoft の ブログ記事 を参照してください。

レガシーな Office 365 コネクタを現在使用しているすべての通知ハンドルを、テナント ベースの Datadog アプリに移行するには:

レガシー コネクタから Microsoft Workflows Webhooks インテグレーションに移行する

Microsoft は、Microsoft Teams 向け Office 365 コネクタの非推奨化を発表しました。これには次の影響があります:

• すべての Datadog コネクタは 2025 年 1 月 31 日に機能しなくなります。
• 更新済み URL のない Incoming Webhook コネクタは 2025 年 1 月 31 日に機能しなくなります。
• すべてのコネクタは 2025 年 12 月 31 日に機能しなくなります (以前は 2024 年 10 月 1 日)。

詳細は、Microsoft の ブログ記事 を参照してください。

現在レガシー Office 365 コネクタを使用しているすべての通知ハンドルを Datadog の Microsoft Workflows webhooks インテグレーションに移行するには、Microsoft Workflows Webhooks を参照してください。

コネクタのセットアップ (非推奨)

1. チャンネルのリストで、チャンネル名の横にある ... ボタンを選択し、Connectors を選択します。

2. Datadog を検索し、Configure をクリックします。

3. コネクタ構成モーダルで、Webhook URL をコピーします。

4. Datadog で、Integrations > Microsoft Teams に移動します。

5. Configuration タブで、Add Handle をクリックしてハンドルに名前を付け、webhook URL を貼り付けます。

6. コネクタ構成モーダルで、Save をクリックします。