이 페이지는 아직 한국어로 제공되지 않으며 번역 작업 중입니다. 번역에 관한 질문이나 의견이 있으시면 언제든지 저희에게 연락해 주십시오.
Overview
Integrate with Microsoft Teams to:
- Be notified of Datadog alerts and events in Microsoft Teams.
- Manage incidents from within Microsoft Teams.
Send monitor notifications to a Microsoft Teams channel
Setup
To integrate Datadog with a Microsoft Teams channel:
Choose the ...
button next to the channel name in the list of channels and then choose Connectors.
Search for Datadog and click Configure.
In the connector configuration modal, copy the webhook URL.
In Datadog, navigate to Integrations > Microsoft Teams
.
On the Configuration tab, click Add Channel, give the channel a name, and paste the webhook URL.
In the connector configuration modal, click Save.
Usage
From a Datadog monitor, send a notification to Microsoft Teams using the @-notification
feature
. Send the notification to the address @teams-<CHANNEL>
, replacing <CHANNEL>
with the name of your Microsoft Teams channel.
Datadog Incident Management in Microsoft Teams
Account setup
First, install the Datadog App in Microsoft Teams:
- Open Microsoft Teams.
- In the vertical toolbar, click Apps.
- Search for “Datadog” and click on the tile.
- Click Add to install the Datadog App.
Next, connect your Microsoft tenant to Datadog:
- In Datadog, navigate to the Microsoft Teams Integration Tile
.
- Click Add Account, which redirects you to Microsoft.
- Follow the prompts and click OK.
Some Datadog Incident Management features need permission to perform actions on your tenant, for example, creating a new
team for an incident. You need someone who is authorized to consent on behalf of the Microsoft organization to
grant tenant-wide admin consent, such as a user assigned the Global Admin role. View Microsoft Entra ID documentation
for more
information on who can grant tenant-wide admin consent to the Datadog application.
To grant consent:
- Navigate to the Microsoft Teams Integration Tile
in Datadog.
- Click Authorize, which redirects you to Microsoft. A user who can grant tenant-wide admin consent must perform this step. Note that the Microsoft user does not need to have a Datadog account.
- Follow the prompts and click OK.
User setup
Performing actions in Datadog from Microsoft Teams requires you to connect your Datadog and Microsoft Team accounts.
To connect your account from Microsoft Teams:
Open Microsoft Teams.
Start a chat with the Datadog bot by clicking on the ...
button in the vertical toolbar and selecting Datadog.
Type “accounts” and hit enter.
The Datadog bot will respond with instructions on how to connect your accounts. Click Connect Datadog Account.
The Datadog bot will then send a message containing a link to connect your accounts. Click the link and follow the prompts.
You will be redirected back to the Microsoft Teams Integration Tile
.
Create an application key by clicking Create in the prompt on the Microsoft Teams Integration Tile
.
You can also connect your accounts from Datadog:
- In Datadog, navigate to the Microsoft Teams Integration Tile
.
- Click Connect in the tenant listed.
- Follow the prompts and click OK.
- From the Microsoft Teams Integration Tile
, create an application key by clicking Create in the above prompt.
Usage
To declare a new incident from Microsoft Teams:
- Start a conversation in any team.
- Type
@Datadog
or use the ...
button to open the Messaging extensions menu and select the Datadog App. - Select Create an Incident.
- Complete the form with your desired information.
- Click Create.
Anyone in your Microsoft Teams tenant can declare an incident, regardless of whether they have access to Datadog.
When a new incident is created, a corresponding team named incident-(unique number ID)
is created.
To update an incident, follow a similar process as creation:
- Start a conversation while in an incident team.
- Type
@Datadog
or use the ...
button to open the Messaging extensions menu and select the Datadog App. - Select Update Incident.
- Complete the form with your desired information.
- Click Update.
List all open (active and stable) incidents with:
Use the “More actions” menu on any message inside an incident team on the far right to send that message to the incident Timeline.
Incident updates channel
Using an incident updates channel provides your stakeholders with organization-wide visibility into the status of all incidents directly from Microsoft Teams. Select which team and channel in your account to post these updates to, and the channel receives the following posts:
- Newly declared incidents.
- Changes to severity, status transition, and incident commander.
- Links to the incident’s overview page in App.
- Link to join the dedicated incident team.
Once the Microsoft Teams App has been installed, you can navigate to the Incident Settings page. From this, you can scroll down to the Incident Updates Channel section and begin the set-up flow.
How to set up an incident channel:
- Navigate to Incidents Settings
.
- Locate the Incident Updates Channel section of the Microsoft Teams integration.
- Select the correct tenant, team, and channel for your incident updates.
Data collected
Metrics
The Microsoft Teams integration does not provide any metrics.
Events
The Microsoft Teams integration does not include any events.
Service checks
The Microsoft Teams integration does not include any service checks.
Permissions
Datadog for Microsoft Teams requires the following permissions. For more information, see the Microsoft Graph permission reference
.
API / Permissions name | Type | Request Reason |
---|
ChannelSettings.ReadWrite.All | Application | Create and modify channels to remediate incidents using Datadog Incident Management. |
GroupMember.Read.All | Application | Provides team and channel name auto-complete suggestions for Datadog Incident Management configuration. |
Team.Create | Application | Create teams to manage and remediate incidents using Datadog Incident Management. |
TeamMember.ReadWrite.All | Application | Add users to Teams to manage incidents with Datadog Incident Management. |
TeamsAppInstallation.ReadWrite.All | Application | Adds the Datadog App to teams created by Datadog Incident Management. |
TeamSettings.ReadWrite.All | Application | Keeps Datadog Incident Management up to date with the state of incident teams. |
Troubleshooting
Using SSO
Use the following steps to set new channel connectors:
Login to Datadog, then complete setup steps 1 and 2.
After setup step 3 redirects you to Datadog from the MS Teams page, open a new tab and log into Datadog with your SSO. Then perform setup step 4 separately.
Need help? Contact Datadog support
.