Microsoft Teams

概要

Microsoft Teams と統合して、以下のことができます。

  • Microsoft Teams で Datadog アラートとイベントの通知を受信
  • Microsoft Teams の中からインシデントを管理することができます。
  • Microsoft Teams から直接トリガーされたモニターをミュートします。

  • Microsoft Teams で Datadog アラートとイベントの通知を受信
  • Microsoft Teams から直接トリガーされたモニターをミュートします。

Note: While your Datadog account is hosted in the secure US1-FED environment, you are responsible for managing the security of your Microsoft Teams environment, including access, permissions, and data protection.

セットアップ

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

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

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

    Datadog の通知を受信したいすべてのチームに Datadog アプリを追加済みであることを確認します。

    Ensure you have added the Datadog for Government app to all teams where you want to receive Datadog notifications.

    1. Microsoft Teams を開きます。
    2. 垂直ツールバーの Apps をクリックします。
    3. Search for “Datadog” and click on Open.
    4. In the modal that opens, select the primary channel of the team where the app should be added. Click Go to complete the installation.

    1. Microsoft Teams を開きます。
    2. 垂直ツールバーの Apps をクリックします。
    3. Search for “Datadog for Government” and click on Open.
    4. In the modal that opens, select the primary channel of the team where the app should be added. Click Go to complete the installation.

    Microsoft Teams でアプリをチームに追加

    Microsoft Teams Add App to Team

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

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

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

    Microsoft has announced that Office 365 connectors for Microsoft Teams are being deprecated. This has the following effects:

    • All Datadog Connectors will stop working on January 31, 2025.
    • URL の更新が行われていない Incoming Webhook コネクタは 2025 年 1 月 31 日に機能しなくなります。
    • All connectors will stop working on December 31, 2025 (previously October 1, 2024).

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

    To migrate all notification handles currently using the legacy Office 365 connectors over to Datadog’s tenant-based integration:

    1. セットアップ手順 に従って Microsoft テナントを Datadog に接続します。
    2. Add the Datadog app to all teams where you have a legacy Office 365 connector configured.
    3. Microsoft Teams Integration Tile の各レガシー通知コネクタ ハンドルについて:
      1. Under the configured tenant, click Add Handle.
      2. 新しいハンドルに、コネクタハンドルと同じ名前を付けます。例えば、旧来のコネクタハンドルの名前が channel-123 の場合、テナント構成に channel-123 という名前で新しいハンドルを作成します。
      3. 旧来のコネクタハンドルがメッセージを送信していたドロップダウンメニューから希望するチームとチャンネルを選択し、Save をクリックします。この新しいハンドルは既存の旧来のコネクタハンドルをオーバーライドします。

    1. セットアップ手順 に従って Microsoft テナントを Datadog に接続します。
    2. Add the Datadog for Government app to all teams where you have a legacy Office 365 connector configured.
    3. Microsoft Teams Integration Tile の各レガシー通知コネクタ ハンドルについて:
      1. Under the configured tenant, click Add Handle.
      2. 新しいハンドルに、コネクタハンドルと同じ名前を付けます。例えば、旧来のコネクタハンドルの名前が channel-123 の場合、テナント構成に channel-123 という名前で新しいハンドルを作成します。
      3. 旧来のコネクタハンドルがメッセージを送信していたドロップダウンメニューから希望するチームとチャンネルを選択し、Save をクリックします。この新しいハンドルは既存の旧来のコネクタハンドルをオーバーライドします。

    使用状況

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

    User mentions

    User mentions allow you to notify specific users in your Microsoft Teams channels when monitor alerts are triggered. This helps ensure that the right people are notified about important events. To mention a specific user, follow the steps below to find their User Principal Name (UPN).

    Syntax: <at>{User Principal Name}</at>

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

    Complete notification example: @teams-CHANNEL_NAME <at>user@microsoft.com</at> <at>another.user@microsoft.com</at>

    To find a user’s User Principal Name (UPN):

    1. Method 1 (only works if UPN matches email):

      • In Microsoft Teams, click on the user’s profile picture or name to open their contact card.
      • The email shown in the Chat field is often the UPN. If they differ, use Method 2 below.

    2. Method 2 (always works, but requires Azure Portal permissions):

      • Microsoft Azure Portal にサインインします。
      • Navigate to Microsoft Entra ID > Manage > Users
      • Locate the user in the list and copy their UPN from the User principal name column.

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

    ダッシュボード

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

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

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

    Microsoft Teams でダッシュボード ウィジェットを共有

    Sharing a dashboard widget in Microsoft Teams

    編集アクセス権の制限

    By default, all users have full access to connected Microsoft Teams tenants.

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

    1. While viewing a tenant, click the gear icon in the upper-right corner to open the settings menu.
    2. Permissions を選択します。
    3. Restrict Access をクリックします。ダイアログボックスが更新され、組織のメンバーはデフォルトで Viewer アクセス権を持っていることが表示されます。
    4. Use the dropdown to select one or more roles, teams, or users that can edit the Microsoft Teams tenant.
    5. Click Add. The dialog box updates to show that the role you selected has the Editor permission.
    6. Save をクリックします。

    Note: To maintain your edit access to the tenant, you must include at least one role you belong to before saving.

    If you have edit access, you can restore general access to a restricted tenant by completing the following steps:

    1. While viewing the tenant, click the gear icon in the upper-right corner to open the settings menu.
    2. Permissions を選択します。
    3. Restore Full Access をクリックします。
    4. Save をクリックします。

    API 経由でテナントの権限を編集するには:

    1. Microsoft Teams Integration Tile に移動します。
    2. Tenants タブをクリックします。
    3. 選択したテナントについて表示されたテナント ID をコピーします。
    4. Restriction Policies API を使用します。Resource Type は integration-account、id は microsoft-teams:<tenant_id> です。

    What are Microsoft Workflows Webhooks?

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

    Post to a channel when a webhook request is received template

    Are you migrating legacy connectors to the Microsoft Workflows Webhooks integration?

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

    For each legacy notification connector handle in the Microsoft Teams Integration Tile:

    1. Follow the setup steps to create a workflow webhook handle for the desired Microsoft Teams channel.
    2. Under the Microsoft Workflows Webhooks section, give the new handle the same name as the connector handle it should replace. For example, if your legacy connector handle is named channel-123, name your new handle in the Microsoft Workflows Webhooks section with the name channel-123. This new handle overrides the existing legacy connector handle.

    Create a Microsoft Workflows Webhook

    前提条件

    • When creating a new workflow, a Microsoft account is required for both ownership of the workflow and sending notifications to channels (these do not need to be the same Microsoft account).
    • The account that owns the workflow (configured in step 2 below) is the account that can edit and renew the workflow. For easier shared access, use a service account.
    • The account that sends notifications to channels (configured in step 8 below) posts as the user of the account. This account must be part of the team that you want to send notifications to. If sending notifications to a private channel, then this account must be also be added to the channel. If you want to give this account a name like “Datadog Notifications,” use a service account.

    手順

    Note: Most of these steps are in Microsoft Workflows. As Microsoft makes changes to Workflows, the steps below may not reflect the most recent changes.

    1. Microsoft Teams で、通知したいすべてのチームに Workflows アプリを追加します。チームにアプリを追加できない場合は、以下の「プライベート チャネル」セクションの手順に従ってください。

      Instructions step 1

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

    3. Choose the Microsoft account that you would like to use to own the workflow (use a service account for easier shared access), then click Continue.

      Instructions step 3

    4. Click Edit in advanced mode.

      Instructions step 4

    5. Expand Send each adaptive card, then click Post card in a chat or channel.

      Instructions step 5

    6. Use the Post As dropdown to set Post as to Flow bot. Notifications will appear to be sent by “<NAME> via Workflows”. To receive these notifications, the Workflows application must be added to the desired team. If sending notifications to a private channel, Post As must be set to a user in the channel. See the “Private channels” section below for more information. Note: Changing Post as will reset the Post in field.

      Instructions step 6

    7. To access the team and channel drop-downs, remove the @ symbols by deleting them or clicking the X icons.

      Instructions step 7

    8. Use the drop-downs to select the desired team and channel.

      Instructions step 8

    9. Ensure that the workflow is connected to the intended Microsoft account for sending notifications (such as a service account named “Datadog Notifications”). Notifications will appear to be sent by “<NAME> through Workflows”. This account must have access to the configured Microsoft Teams channel. To change the account, click Change connection and follow the prompts to configure another Microsoft account.

      Instructions step 9

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

      Instructions step 10

    11. To find your webhook link, click the first block of the workflow.

      Instructions step 11

    12. Make sure that Anyone can trigger the flow, and then copy the link.

      Instructions step 12

    13. Click the Back button to navigate to the dashboard for the workflow.

      Instructions step 13

    14. Ensure that the workflow is on by checking the dashboard. If it is off, click the “Turn on” button.

      Instructions step 14

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

    16. On the Configuration tab, go to the Microsoft Workflows Webhooks section and click Add Handle. Give the handle a name (if migrating from a legacy connector handle, use the same name as the corresponding connector handle), and paste the webhook URL.

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

    Private channels

    To send notifications to private channels, the account configured within the Post Card to chat or channel block must have access to the channel. This enables the workflow to send notifications on behalf of that user account.

    1. Within the Post Card to chat or channel block, change Post as to User.

      Private channels instructions step 1

    2. Then to choose the account, click Change connection and follow the prompts to change the account.

      Private channels instructions step 2

    制限

    • If you are a Microsoft 365 customer, workflows will automatically turn off after 90 days of no successful triggers. When a workflow is nearing expiration, Microsoft sends an email to the account that owns the workflow. This 90 day timer can be reset by running a test within Microsoft Workflows.

    • When using the template, all messages are appended with a line of text stating who created the workflow along with a link to the template.

      User used a template

      To remove this, go to your workflow and click Save As to make a copy, navigate to the copy by finding it within My Flows, and use the new webhook from the copied workflow instead of the original workflow.

    • Microsoft Workflows does not support interactive features for the messages that it posts (such as muting monitors directly from Microsoft Teams).

    • Microsoft Workflows does not support shared channels.

    • Microsoft Workflows does not support user mentions when posting a Workflows Webhook as a User.

    使用状況

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

    User mentions with Microsoft Workflows Webhooks handles

    User mentions allow you to notify specific users in your Microsoft Teams channels when monitor alerts are triggered. This helps ensure that the right people are notified about important events. To mention a specific user, follow the steps below to find their User Principal Name (UPN).

    Syntax: <at>{User Principal Name}</at>

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

    Complete notification example: @teams-CHANNEL_NAME <at>user@microsoft.com</at> <at>another.user@microsoft.com</at>

    To find a user’s User Principal Name (UPN):

    1. Method 1 (only works if UPN matches email):

      • In Microsoft Teams, click on the user’s profile picture or name to open their contact card.
      • The email shown in the Chat field is often the UPN. If they differ, use Method 2 below.

    2. Method 2 (always works, but requires Azure Portal permissions):

      • Microsoft Azure Portal にサインインします。
      • Navigate to Microsoft Entra ID > Manage > Users
      • Locate the user in the list and copy their UPN from the User principal name column.
    User mentions are NOT supported for Workflows Webhook handles posted as a User (for private channels). Including a user mention when posting a Workflows Webhook as a user will fail. To include user mentions using Workflows Webhooks, you must use the Flow Bot.

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

    編集アクセス権の制限

    By default, all users have full access to each Microsoft Workflows webhook handle.

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

    1. While viewing the Workflows Webhooks, hover over a handle to reveal actions on the right side of the row.
    2. Click the lock icon labeled Permissions.
    3. Restrict Access をクリックします。ダイアログボックスが更新され、組織のメンバーはデフォルトで Viewer アクセス権を持っていることが表示されます。
    4. Use the dropdown to select one or more roles, teams, or users that can edit the Workflows webhook handle.
    5. Click Add. The dialog box updates to show that the role you selected has the Editor permission.
    6. Save をクリックします。

    Note: To maintain your edit access to the Workflows webhook handle, you must include at least one role you belong to before saving.

    If you have edit access, you can restore general access to a restricted Workflows webhook handle by completing the following steps:

    1. While viewing the Workflows Webhooks, hover over the restricted handle to reveal actions on the right side of the row.
    2. Click the lock icon labeled Permissions.
    3. Restore Full Access をクリックします。
    4. Save をクリックします。

    To edit Workflows Webhooks permissions through the API:

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

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

    Microsoft has announced that Office 365 connectors for Microsoft Teams are being deprecated. This has the following effects:

    • All Datadog Connectors will stop working on January 31, 2025.
    • URL の更新が行われていない Incoming Webhook コネクタは 2025 年 1 月 31 日に機能しなくなります。
    • All connectors will stop working on December 31, 2025 (previously October 1, 2024).

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

    To migrate all notification handles currently using the legacy Office 365 connectors over to the tenant-based Datadog app:

    1. セットアップ手順に従って Microsoft テナントを Datadog に接続します。
    2. Add the Datadog app to all teams where you have a legacy Office 365 connector configured.
    3. Microsoft Teams Integration Tile の各レガシー通知コネクタ ハンドルについて:
      1. Under the configured tenant, click Add Handle.
      2. 新しいハンドルに、コネクタハンドルと同じ名前を付けます。例えば、旧来のコネクタハンドルの名前が channel-123 の場合、テナント構成に channel-123 という名前で新しいハンドルを作成します。
      3. 旧来のコネクタハンドルがメッセージを送信していたドロップダウンメニューから希望するチームとチャンネルを選択し、Save をクリックします。この新しいハンドルは既存の旧来のコネクタハンドルをオーバーライドします。

    1. セットアップ手順に従って Microsoft テナントを Datadog に接続します。
    2. Add the Datadog for Government app to all teams where you have a legacy Office 365 connector configured.
    3. Microsoft Teams Integration Tile の各レガシー通知コネクタ ハンドルについて:
      1. Under the configured tenant, click Add Handle.
      2. 新しいハンドルに、コネクタハンドルと同じ名前を付けます。例えば、旧来のコネクタハンドルの名前が channel-123 の場合、テナント構成に channel-123 という名前で新しいハンドルを作成します。
      3. 旧来のコネクタハンドルがメッセージを送信していたドロップダウンメニューから希望するチームとチャンネルを選択し、Save をクリックします。この新しいハンドルは既存の旧来のコネクタハンドルをオーバーライドします。

    Migrate from legacy connectors to the Microsoft Workflows Webhooks integration

    Microsoft has announced that Office 365 connectors for Microsoft Teams are being deprecated. This has the following effects:

    • All Datadog Connectors will stop working on January 31, 2025.
    • URL の更新が行われていない Incoming Webhook コネクタは 2025 年 1 月 31 日に機能しなくなります。
    • All connectors will stop working on December 31, 2025 (previously October 1, 2024).

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

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

    Connector setup (deprecated)

    レガシー通知ハンドルは、同じ @teams-HANDLE_NAME を使用しない限り新しいセットアップの影響を受けませんが、使用する場合は新しい構成がレガシー構成をオーバーライドします。

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

      Microsoft Teams step 1

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

      Microsoft Teams step 2

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

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

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

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

    Microsoft Teams における Datadog Incident Management

    アカウント設定

    First, install the Datadog App in Microsoft Teams:

    1. Microsoft Teams を開きます。

    2. 垂直ツールバーの Apps をクリックします。

    3. Search for “Datadog” and click on Open.

    4. In the modal that opens, select the primary channel of the team where the app should be added. Click Go to complete the installation.

      Microsoft Teams Add App to Team

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

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

    Granting additional permissions

    一部の Datadog Incident Management 機能では、テナント上での操作 (例: インシデント用の新規チャネルの作成) を実行するための権限が必要です。Global Admin ロールを割り当てられたユーザーなど、Microsoft 組織を代表して同意を付与できる権限を持つ人物が、テナント全体の管理者同意を付与する必要があります。Datadog アプリケーションに対してテナント全体の管理者同意を付与できるのは誰かについては、Microsoft Entra ID のドキュメントを参照してください。

    Datadog に対してアプリケーション権限と委任された権限の両方を付与するか、委任された権限のみを付与するかを選択できます。両方の権限を使用する方法は設定が容易で、委任された権限のみを使用する方法は、テナント内の Datadog アプリに対してよりきめ細かな制御が可能になります。詳細は、Microsoft の権限と同意の概要ドキュメントを参照してください。

      1. Datadog で Microsoft Teams インテグレーションタイルに移動します。
      2. For the tenant in which you want to use Incident Management, click the gear icon on the right-hand side.
      3. Click Grant application permissions, which redirects you to Microsoft. A user who can grant tenant-wide admin consent must perform this step. This user must have a Datadog account, but the email used for their Datadog account does not need to match the email for their Microsoft account.
      4. 画面の指示に従って、OK をクリックします。

      委任された権限を使用すると、Datadog は Microsoft Teams テナント内でユーザーとして動作できます。Datadog は、そのユーザーが実行できるあらゆる操作を行い、同ユーザーがアクセスできるリソースにアクセスできます。

      First, grant the Datadog app delegated permissions:

      1. Datadog で Microsoft Teams インテグレーションタイルに移動します。
      2. For the tenant in which you want to use Incident Management, click the gear icon on the right-hand side.
      3. Click Grant delegated permissions, which redirects you to Microsoft. A user who can grant tenant-wide admin consent must perform this step. This user must have a Datadog account, but the email used for their Datadog account does not need to match the email for their Microsoft account.
      4. 画面の指示に従って、OK をクリックします。

      Next, create the service account for Datadog to act as:

      1. Create an Office365 service account user. Datadog recommends giving this service account user a name such as ‘Datadog’ to distinguish it from actual Microsoft Teams users and avoid confusion.

      2. Assign a Microsoft Teams license to the service account.

      3. Add the service account user to each team where you would like to manage incident response. This includes teams where new incident channels are created and teams from which users declare incidents.

      4. Ensure that those teams have the following permissions enabled:

        • Allow members to create and update channels
        • Allow members to delete and restore channels
        • Allow members to create, update, and remove tabs

        To enable these permissions, click … next to the team name > Manage Team > Settings > Member Permissions.

      Finally, connect the service account user that you created in the first step.

      1. Ensure you are logged in as the service account user you just created. Note: You do not need to create a Datadog user for the service account, and the service account user is not connected to the Datadog user that performs this step.
      2. Datadog で Microsoft Teams インテグレーションタイルに移動します。
      3. For the tenant in which you want to use Incident Management, click the gear icon on the right-hand side.
      4. Click Connect delegated user, which redirects you to Microsoft. Note: You do not need to be a tenant-wide admin to perform this step.
      5. 画面の指示に従って、OK をクリックします。

      Important note about refresh tokens

      When you connect Microsoft Teams using a delegated service account, Datadog uses a refresh token to maintain access without requiring repeated logins. This token can become invalid if the service account’s password changes, the account is disabled, or Microsoft revokes the token.

      これらのトークンも 90 日後に期限切れになります。Datadog が委任ユーザーの代理でアクションを実行するたびに新しいトークンが発行されますが、委任ユーザーを利用したアクションが 90 日間行われない場合はトークンが失効し、インテグレーションは動作を停止します。

      If the token becomes invalid or expires you’ll need to reconnect the service account to restore functionality.

      詳細は、Microsoft のドキュメント Microsoft ID プラットフォームにおけるリフレッシュ トークンを参照してください。

      ユーザー設定

      Microsoft Teams から Datadog のアクションを実行するには、Datadog と Microsoft Team のアカウントを接続する必要があります。

      Microsoft Teams からアカウントを接続するには

      1. Microsoft Teams を開きます。

      2. 垂直ツールバーの ... ボタンをクリックし、Datadog を選択すると、Datadog ボットとのチャットが開始されます。

      3. “accounts” と入力し、エンターキーを押します。

        Microsoft Teams からのアカウント接続

      4. Datadog ボットが、アカウントの接続方法について応答します。Connect Datadog Account をクリックします。

      5. その後、Datadog ボットが、アカウントを接続するためのリンクが含まれたメッセージを送信します。リンクをクリックし、プロンプトに従います。

      6. Microsoft Teams Integration Tile にリダイレクトされます。

      7. Microsoft Teams Integration Tile 上のプロンプトで Create をクリックして、アプリケーション キーを作成します。

      Datadog からアカウントを接続することも可能です。

      1. Datadog で、Microsoft Teams Integration Tile に移動します。
      2. 表示されたテナントの中から、Connect をクリックします。
      3. 画面の指示に従って、OK をクリックします。
      4. 上記のプロンプトで Create をクリックして、Microsoft Teams Integration Tile からアプリケーション キーを作成します。
      Datadog Microsoft Teams インテグレーションタイルからアカウントを接続します

      Incident Usage

      インシデント

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

      1. Start a conversation in a channel in any team, or a chat with the Datadog app.
      2. Type @Datadog incident
      3. An adaptive card appears. Click the Declare Incident button to open the Datadog tab and declare an incident.

      A user must connect their Microsoft Teams account to their Datadog account to declare an incident.

      インシデントを更新するには、作成と同様の手順で行います。

      1. インシデントチームにいながら、会話を始めます。
      2. @Datadog と入力するか、... ボタンで Messaging extensions メニューを開き、Datadog アプリを選択します。
      3. Update Incident を選択します。
      4. 希望の情報をフォームに入力します。
      5. Update をクリックします。

      次を使用してオープン（アクティブで安定している）インシデントをリスト表示します。

      @Datadog list incidents

      インシデントチーム内のメッセージの右端にある “More actions” メニューを使用すると、そのメッセージをインシデントタイムラインに送信することができます。

      インシデントの更新チャンネル

      インシデント更新チャンネルを使用すると、関係者は Microsoft Teams から直接、すべてのインシデントのステータスを組織全体で確認することができます。これらのアップデートを投稿するチームとチャンネルをアカウントで選択すると、チャンネルは次の投稿を受け取ります。

      • 新しく宣言されたインシデント。
      • 重要度、ステータスの移行、インシデントコマンダーへの変更点。
      • Links to the incident’s overview page in App.
      • インシデント専門チームへの参加リンク。

      Microsoft Teams アプリがインストールされたら、Incident Settings ページに移動できます。ここから、Incident Updates Channel セクションまでスクロールダウンし、セットアップフローを開始することができます。

      インシデントチャンネルの設定方法

      1. Incidents Settings に移動します。
      2. Microsoft Teams セクションで、接続している Microsoft Teams テナントを選択します。
      3. Automatically create a Microsoft Teams channel for every incident (インシデントごとに Microsoft Teams チャンネルを自動的に作成する) をオンに切り替えます。
      4. 新しいチャンネルを自動的に作成するチームを選択します。
      5. 設定を保存します。
      Microsoft Teams インシデント更新チャンネル設定

      収集されたデータ

      メトリクス

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

      イベント

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

      サービスチェック

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

      権限

      Microsoft Teams インテグレーションは、追加されたチームに対して次の権限を受け取ります。詳細は、[Microsoft アプリの権限リファレンス][978]を参照してください。

      権限の説明リクエスト理由
      私が提供するメッセージとデータを受信します。ユーザーは、Datadog アプリと個人チャットでやり取りすることができます。
      私にメッセージや通知を送信します。ユーザーは、Datadog アプリと個人チャットでやり取りすることができます。
      名前、メールアドレス、会社名、使用言語など、私のプロフィール情報にアクセスします。Datadog UI 内で Microsoft Teams の通知やワークフローを構成することができます。
      チームやチャットのメンバーがチャンネルやチャットで提供するメッセージやデータを受信します。ユーザーは、@Datadog コマンドを通して Datadog とやり取りすることができます。
      チャンネルやチャットでメッセージや通知を送信します。構成されたターゲットに Datadog 通知を送信します。
      チームやチャットの情報 (チーム名やチャット名、チャンネルリスト、名簿 (チームやチャットメンバーの名前やメールアドレスを含む)) にアクセスし、それを使って連絡を取ることができます。ユーザーが Datadog 内で Microsoft Teams の通知やワークフローを構成できるようにします。

      Microsoft Teams インテグレーションで Incident Management 機能を使用するには、追加の権限が必要です。これらはテナント全体に対する権限を持つユーザーによって承認される必要があります (詳細な手順は Microsoft Teams の Datadog Incident Management: アカウントのセットアップ を参照)。 これらの権限の詳細は、Microsoft Graph の権限リファレンスを参照してください。

        API / 権限名種類リクエスト理由
        Channel.Createアプリケーション権限および委任された権限Datadog Incident Management を使用してインシデントを管理・復旧するためにチャネルを作成します。
        Channel.Delete.Allアプリケーション権限および委任された権限指定した期間後にインシデント チャネルを自動アーカイブします。
        ChannelMessage.Read.Allアプリケーション権限および委任された権限インシデント チャネルからインシデント タイムラインへ、タイムライン メッセージを自動同期します。
        ChannelSettings.ReadWrite.Allアプリケーション権限および委任された権限Datadog Incident Management を使用してインシデントを復旧するため、チャネルを作成および変更します。
        Directory.Read.All,GroupMember.Read.Allアプリケーション権限Datadog Incident Management の構成時に、チーム名およびチャネル名のオート コンプリート候補を提供します。
        TeamsTab.Createアプリケーション権限および委任された権限Datadog アプリ用にチーム内にタブを作成します (この権限は今後の Microsoft Teams におけるインシデント宣言エクスペリエンスに必要です)。
        OnlineMeetings.ReadWrite委任された権限Datadog アプリ用にチーム内で会議を自動作成します (この権限は今後の Microsoft Teams におけるインシデント宣言エクスペリエンスに必要です)。
        TeamsAppInstallation. ReadWriteSelfForTeam委任された権限Datadog アプリがチームのメンバーであるかどうかを確認できるようにします。
        TeamsTab.Read.All委任された権限チャネルに Datadog タブが作成されているかどうかを確認します (この権限は今後の Microsoft Teams におけるインシデント宣言エクスペリエンスに必要です)。
        User.Read委任された権限Microsoft Teams アカウントを対応する Datadog アカウントに接続するため、サインイン中のユーザーに関する詳細を提供します。
        User.Read.All委任された権限インシデントを更新または作成した Microsoft Teams ユーザーの名前を表示します。
        Team.ReadBasic.All委任された権限インシデント設定ページに、サービス アカウントがメンバーであるチームを表示します。
        API / 権限名種類リクエスト理由
        Channel.Create委任された権限Datadog Incident Management を使用してインシデントを管理・復旧するためにチャネルを作成します。
        Channel.Delete.All委任された権限指定した期間後にインシデント チャネルを自動アーカイブします。
        ChannelMessage.Read.All委任された権限インシデント チャネルからインシデント タイムラインへ、タイムライン メッセージを自動同期します。
        ChannelSettings.ReadWrite.All委任された権限Datadog Incident Management を使用してインシデントを復旧するため、チャネルを作成および変更します。
        TeamsTab.Create委任された権限Datadog アプリ用にチーム内にタブを作成します (この権限は今後の Microsoft Teams におけるインシデント宣言エクスペリエンスに必要です)。
        OnlineMeetings.ReadWrite委任された権限Datadog アプリ用にチーム内で会議を自動作成します (この権限は今後の Microsoft Teams におけるインシデント宣言エクスペリエンスに必要です)。
        TeamsAppInstallation. ReadWriteSelfForTeam委任された権限Datadog アプリがチームのメンバーであるかどうかを確認できるようにします。
        TeamsTab.Read.All委任された権限チャネルに Datadog タブが作成されているかどうかを確認します (この権限は今後の Microsoft Teams におけるインシデント宣言エクスペリエンスに必要です)。
        User.Read委任された権限Microsoft Teams アカウントを対応する Datadog アカウントに接続するため、サインイン中のユーザーに関する詳細を提供します。
        User.Read.All委任された権限インシデントを更新または作成した Microsoft Teams ユーザーの名前を表示します。
        Team.ReadBasic.All委任された権限インシデント設定ページに、サービス アカウントがメンバーであるチームを表示します。

        トラブルシューティング

        SSO の使用

        次の手順を使用して、新しいチャンネルコネクターを設定します。

        1. Datadog にログインし、セットアップ手順 1 および 2 を完了します。

        2. セットアップ手順 3 で MS Teams ページから Datadog にリダイレクトされたら、新しいタブを開き、SSO で Datadog にログインします。次に、セットアップ手順 4 を個別に実行します。

        インテグレーションタイルにチームが表示されないのはなぜですか？

        Datadog にテナントを追加する前にボットをチームに追加した場合、Datadog はチームが存在することを認識するためのチーム参加イベントを受信できていません。 次のいずれかを試してください:

        • そのチームの任意の標準チャンネルに @Datadog sync を投稿して、チームの標準チャンネルを Datadog と同期します。
        1. 同期したい Team 内の標準チャンネルに移動します。
        2. そのチャンネルで投稿を開始します。
        3. チャンネルに @Datadog sync を投稿し、操作が成功したことを示す確認メッセージがスレッドに表示されるのを待ちます。
        • Remove the Datadog app from the team, then add it back again. Note: This removes configured connectors for that team. Perform this action only when you are ready to migrate all connectors for that team to Datadog’s tenant-based integration:
        1. 左サイドバーのチーム名の横にある 3 つの点をクリックします。
        2. Manage Team をクリックします。
        3. Apps というラベルの付いたタブに移動します。
        4. Datadog アプリの横にある 3 つの点をクリックします。
        5. Remove をクリックします。
        6. セットアップ手順に従って Datadog アプリを追加し直します。

        If you added the bot to the team before adding the tenant to Datadog, then Datadog would have missed the team join event to know that the team exists. You can:

        • Synchronize your team standard channels to Datadog by posting @Datadog for Government sync on any standard channel for that team:
        1. 同期したい Team 内の標準チャンネルに移動します。
        2. そのチャンネルで投稿を開始します。
        3. Post @Datadog for Government sync to the channel and wait for a confirmation message in the thread indicating the operation’s success.
        • Remove the Datadog for Government app from the team, then add it back. Note: This removes configured connectors for that team. Perform this action only when you are ready to migrate all connectors for that team to Datadog’s tenant-based integration.
        1. 左サイドバーのチーム名の横にある 3 つの点をクリックします。
        2. Manage Team をクリックします。
        3. Apps というラベルの付いたタブに移動します。
        4. Click the three dots next to the Datadog for Government app.
        5. Remove をクリックします。
        6. セットアップ手順に従って Datadog for Government アプリを追加し直します。

        プライベートチャンネルはボットでサポートされていますか？

        Microsoft Teams のプライベート チャネルの制限により、プライベート チャネルはボットではサポートされていません。プライベート チャネルに通知を送信したい場合は、Microsoft Workflows Webhooks を参照してください。

        Are multiple user mentions supported in monitor notifications?

        Yes, you can include multiple user mentions in a single notification to ensure all relevant team members are notified.

        Example: @teams-handle <at>user1@microsoft.com</at> <at>user2@microsoft.com</at> <at>user3@microsoft.com</at>

        When multiple user mentions are included in a notification and one is invalid, the valid users will still receive notifications, but invalid user mentions may cause the mentions to appear out of order.

        Is the Datadog for Government app supported in GCC or GCC High?

        Currently, the Datadog for Government app only supports Datadog US1-FED customers who are trying to connect to their commercial Microsoft Teams tenant. GCC and GCC High tenants are not supported by the app.

        Why isn’t an incident feature working when using delegated permissions?

        First, ensure that the service account user is a member of the team that the feature is being used in.

        • If incident tab is not being created, ensure that you have allowed members to create, update, and remove tabs in channels in that team.
        • If new incident channels are not being created or renamed, ensure that you have allowed members to create and update channels in that team.
        • If incident channels are not being archived, ensure that you have allowed members to delete and restore channels in that team.

        Lastly, it is possible that the delegated user’s token has expired or been revoked. If that’s the case, re-connect the delegated user.

        Why am I getting prompted to check my app configuration when trying to declare an incident?

        In order to use the new incident declaration experience, ensure the following:

        • アプリのバージョンが 3.1.23 以上であること。アプリのバージョンを更新する方法をご覧ください。
        • If you’re using application permissions, ensure you have granted the TeamsTab.Create application permission
        • If you’re using delegated permissions, ensure you have granted the TeamsTab.Create and TeamsTab.Read.All delegated permissions.
        • If you’re using delegated permissions, ensure that the service account is a member of the team you’re running the @Datadog incident command in.

        You can also use the new incident declaration experience by clicking the + sign at the top of a channel and searching for the Datadog app.

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