-
Notifications
You must be signed in to change notification settings - Fork 1.3k
Incident Response: Google Chat space creation #33690
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from 5 commits
01fa954
588fb17
f89cad7
8d07ba2
65de474
3c18464
9abd7ac
b2cc31e
4e497b2
84b0318
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -0,0 +1,53 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| --- | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| title: Integrate Google Chat with Datadog Incident Management | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| description: Manage Datadog incidents directly from Google Chat. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| aliases: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| - /service_management/incident_management/integrations/google_chat/ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| further_reading: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| - link: "/incident_response/incident_management/incident_settings/integrations" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tag: "Documentation" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| text: "Incident Integrations Settings" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| - link: "/integrations/google-hangouts-chat" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tag: "Documentation" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| text: "Google Chat Integration" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| --- | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ## Overview | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| The Google Chat integration for Datadog Incident Management connects your incident response workflows directly to Google Chat by automatically creating Google Chat spaces for collaboration when Datadog incidents are declared. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| The Google Chat integration for Datadog Incident Management connects your incident response workflows directly to Google Chat by automatically creating Google Chat spaces for collaboration when Datadog incidents are declared. | |
| The Google Chat integration for Datadog Incident Management connects your incident response workflows directly to Google Chat. When your team declares a Datadog incident, the integration automatically creates a Google Chat space for collaboration. |
This sentence was long and a bit difficult to follow, so I tried breaking it up.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
fixed
Outdated
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| After the integration is installed, navigate to [**Incidents** > **Settings** > **Integrations**][3] to enable Google Chat features for Incident Management. |
This is pretty vague (which features? How do you do it?), and it's confusing that the click steps are different from the one in the next section, even though the link is the same. Because you go into these details in the next section, I think you can go ahead and remove this! It's a prerequisites section, so I think users generally understand that there's more to do.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
removed
Outdated
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| To use incident spaces, go to **[Incident Response > Incident Management > Settings > Integrations][3]** and enable **Automatically create Google Chat spaces for incidents**. | |
| 1. Select an Organization from the dropdown. If you don't see any options, reach out to Google Workspace administrator to connect your Google organization to Datadog. | |
| 2. Select a Target Audience from the dropdown. "Default" is the default target audience set by your Google Workspace administrator, which could be a private or public target audience group. Reach out to your Google Workspace administrator if this is unclear. | |
| 3. The **channel name template** you define determines how Datadog names the incident spaces it creates. The following variables are available in channel name templates: | |
| * `{{public_id}}`: Incident's numeric ID | |
| * `{{title}}`: Incident's title | |
| * `{{created}}`: Incident's creation date in format MM_DD_YYYY | |
| * `{{yyyy}}`: Incident's four-digit creation year | |
| * `{{mm}}`: Incident's two-digit creation month | |
| * `{{dd}}`: Incident's two-digit creation day of month | |
| * `{{severity}}`: Incident's severity | |
| * `{{random_adjective}}`: Random adjective | |
| * `{{random_noun}}`: Random noun | |
| * `{{slug}}`: Slug (when slug source is set to 'servicenow', this will display the ServiceNow record number) | |
| To use incident spaces: | |
| 1. In Datadog, go to **[Incident Response > Incident Management > Settings > Integrations][3]** and enable **Automatically create Google Chat spaces for incidents**. | |
| 2. Select an **Organization** from the dropdown. If you don't see any options, reach out to your Google Workspace administrator to connect your Google organization to Datadog. | |
| 3. Select a **Target Audience** from the dropdown. **Default** is the default target audience set by your Google Workspace administrator, which could be a private or public target audience group. Reach out to your Google Workspace administrator if this is unclear. | |
| 4. The **Channel Name Template** you define determines how Datadog names the incident spaces it creates. The following variables are available in channel name templates: | |
| * `{{public_id}}`: Incident's numeric ID | |
| * `{{title}}`: Incident's title | |
| * `{{created}}`: Incident's creation date in format `MM_DD_YYYY` | |
| * `{{yyyy}}`: Incident's four-digit creation year | |
| * `{{mm}}`: Incident's two-digit creation month | |
| * `{{dd}}`: Incident's two-digit creation day of month | |
| * `{{severity}}`: Incident's severity | |
| * `{{random_adjective}}`: Random adjective | |
| * `{{random_noun}}`: Random noun | |
| * `{{slug}}`: Slug (set to `servicenow` to display the ServiceNow record number) |
A bunch of suggestions for readability and formatting. I can't see the UI, so feel free to revert anything that isn't accurate!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
fixed!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do we also need a link on this page? https://docs.datadoghq.com/incident_response/incident_management/incident_settings/integrations/
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, added!