-
Notifications
You must be signed in to change notification settings - Fork 1k
/
_index.md
143 lines (100 loc) · 7.16 KB
/
_index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
---
title: Teams
---
## 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][1] or by navigating to [**Service Management > Teams**][2]. The [team directory page][1] lists all teams within your organization.
### Create team
1. On the [team directory page][1], click **New Team** at the upper right.
1. Choose a **Team Name**.
1. The **Handle** populates based on your team name.
1. Use the dropdown menu to select team members and team managers.
1. Provide an optional **Description**.
1. Click **Create**.
**Note:** Allowed characters for team names and team handles are `a-z`, `A-Z`, `0-9`, and `._-:/`. Replace spaces with underscores.
### Modify team
1. On the [team directory page][1], click the team you wish to modify. The [team detail page][3] appears.
1. Click the **Settings** cog at the top of the screen. A pop-up window appears.
1. Select the item you wish to modify.
1. 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][1], click **Teams Settings**.
1. 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][4].
## 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. A side panel appears with team details.
1. Look for the **handle** field at the top of the panel.
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][5]
- [Incidents][6]
- [Monitors][7]
- [Resource Catalog][8]
- [Service Catalog][9]
- [Service Level Objectives][10]
- 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][1], click the team you wish to modify.
1. Click the **Settings** cog at the top of the screen. A pop-up window appears.
1. Select **Notifications**.
1. Add a channel, then click **Save**.
## Filter
The team filter tailors a user's experiences across Datadog to content associated with their teams.
The team filter appears in two places in each list view:
- A list of search facets at the top left
- A search term in the search bar
When a user enables a team filter, they see only the resources associated with their teams or with the services owned by their teams. The team filter state is global and persistent. Therefore, Datadog maintains team context across a user's navigation journey over all applicable products.
The following table describes the products in which you can use the team filter:
| Product List Page | Filter basis |
|-------------------------|----------------------------------------------------------------------------------|
| [Dashboards][11] | Team handle |
| [Resource Catalog][8] | Team handle |
| [Service Catalog][12] | Team handle |
| [Incidents][13] | Team handle |
| [Monitors][14] | Team handle |
| [APM Error Tracking][15] | Service owned by teams (determined by ownership inside the [Service Catalog][12]) |
| [Logs Error Tracking][16] | Service owned by teams (determined by ownership inside the [Service Catalog][12]) |
| [Service Level Objectives][17] | Team handle |
| [Data Streams Monitoring][18] | Team handle |
| [Synthetic Tests][19] | Team handle |
| [Notebooks][20] | Team handle |
## 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][3].
[1]: https://app.datadoghq.com/organization-settings/teams
[2]: https://app.datadoghq.com/teams
[3]: /account_management/teams/manage/
[4]: /account_management/saml/mapping/#map-saml-attributes-to-teams
[5]: /dashboards/#dashboard-details
[6]: /service_management/incident_management/incident_details#overview-section
[7]: /monitors/configuration/?tab=thresholdalert#add-metadata
[8]: /infrastructure/resource_catalog/
[9]: /tracing/service_catalog/adding_metadata/#add-metadata-from-the-datadog-ui
[10]: /service_management/service_level_objectives/#slo-tags
[11]: https://app.datadoghq.com/dashboard/lists
[12]: https://app.datadoghq.com/services
[13]: https://app.datadoghq.com/incidents
[14]: https://app.datadoghq.com/monitors/manage
[15]: https://app.datadoghq.com/apm/error-tracking
[16]: https://app.datadoghq.com/logs/error-tracking
[17]: https://app.datadoghq.com/slo/manage
[18]: https://app.datadoghq.com/data-streams
[19]: https://app.datadoghq.com/synthetics
[20]: https://app.datadoghq.com/notebook/list/