Overview

Datadog Teams allow groups of users to organize their team assets within Datadog and automatically filter their Datadog-wide experience to prioritize these assets.

Use Teams to link resources such as dashboards, services, monitors, and incidents to a group of users. You can also add team-specific links to Slack channels, Jira boards, GitHub repositories, and more.

Team membership is flexible. Users can join teams, be added by other members, or be added by an administrator. Users can belong to multiple teams.

Setup

Navigation

Access the team directory page from Organization Settings or by navigating to Service Management > Teams. The team directory page lists all teams within your organization.

Create team

1. On the team directory page, click New Team at the upper right.
2. Choose a Team Name.
3. The Handle populates based on your team name.
4. Use the dropdown menu to select team members and team managers.
5. Provide an optional Description.
6. Click Create.

Notes:

• Allowed characters for team names are a-z, A-Z, 0-9, and ._-:/. Replace spaces with underscores.
• Allowed characters for team handles are a-z, 0-9, and ._-:/. The last character cannot be an underscore.

Modify team

1. On the team directory page, click the team you wish to modify. The team detail page appears.
2. Click the Settings cog at the top of the screen. A pop-up window appears.
3. Select the item you wish to modify.
4. Make your changes, then click Save.

Choose provisioning source

Choose from three options to determine how admins and team managers may update team membership:

UI and API

Update membership through UI actions and API calls only

SAML

Use a SAML strict model so the identity provider data determines team membership

All sources

Use SAML as a starting point, and allow overrides through the UI and API

1. On the team directory page, click Teams Settings.
2. Select one of the options under Team Provisioning Sources.

If you have teams with existing members, picking the SAML strict option overrides your settings and removes team members from those teams. Picking the All Sources option preserves existing memberships. To manage teams and team membership using SAML attributes, see Map SAML attributes to Teams.

Team handle

A team handle links teams to Datadog resources. Team handles appear in search bars and facets in the format team:<team-handle> or teams:<team-handle>.

To find a team handle:

1. Click the team’s name in the team directory page. The team detail page appears.
2. The team handle appears to the right of the name, at the top of the page.

To associate a resource with a defined team, a Team must exist in Datadog with a matching team handle. When you click on a resource associated with a defined team, a small window appears with the team handle and additional information. Defined teams provide additional functionality such as the Team filter below.

Team handles that aren’t associated with a defined team in Datadog behave similarly to tags. Convert any undefined team handles to defined teams to take advantage of Teams features.

Associate resources with team handles

Datadog supports associating the following resources with team handles:

• Dashboards
• Incidents
• Monitors
• Resource Catalog
• Service Catalog
• Service Level Objectives
• Synthetic Tests, Global Variables, Private Locations

Send notifications to a specific communication channel

Add a notification channel to your Team to route alerts to communication channels such as Slack or Microsoft Teams. Monitor alerts targeting @team-<handle> are redirected to the selected channel.

1. On the team directory page, click the team you wish to modify.
2. Click the Settings cog at the top of the screen. A pop-up window appears.
3. Select Notifications.
4. Add a channel, then click Save.

Team filter

The team filter tailors your experience across Datadog by showing you content associated with your teams. The My Teams list includes teams you are a member of and teams you selected as a favorite.

When you enable the team filter, you see only the resources associated with your teams or with the services owned by your teams. The team filter state is global and persistent, so Datadog applies your team context as you navigate across different products.

The team filter works by adding team-based search terms to the search query. When you enable the team filter, you can see the team-based search terms it adds in the search bar.

Favorite teams

You may be interested in a particular team’s resources without being a member of that team. Adding a team to your favorite teams allows you to get filtered views on that team’s resources without joining the team.

Your favorite teams appear alongside teams you belong to at the top of the team directory page and in the team filter.

Add or remove favorite teams

You can add or remove a team from your favorites from the team directory page or from the team filter.

From the team directory page:

1. Click the team you wish to add as a favorite. The team detail page appears.
2. Click Add Favorite or Remove Favorite in the upper right.

Alternatively, also from the team directory page:

1. Hover over the team you wish to add or remove. Inline icons appear to the right of the team name.
2. Click the star (Add to Favorites or Remove from Favorites) icon.

From the team filter:

1. If the filter is collapsed, click My Teams to expand it.
2. Click Add Favorites. A search box and list of teams appear.
3. To narrow the list of teams, start typing a team name in the search box.
4. Click the star next to the desired team to add or remove it from your favorites.

Supported products

The following table describes the products in which you can use the team filter:

Permissions

Any user in a role with the Teams Manage permission can create teams, rename teams, delete teams, and change team handles. Users with user_access_manage can add, remove, and promote team members and managers.

Manage teams

To customize your team, see Team Management.