Skip to content
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -28,10 +28,12 @@ Configure and manage incident-related integrations from the **Incident Settings*
{{< whatsnext desc="Set up and use the following integrations within the context of Datadog Incident Management:">}}
{{< nextlink href="/incident_response/incident_management/integrations/slack" >}}Slack{{< /nextlink >}}
{{< nextlink href="/incident_response/incident_management/integrations/microsoft_teams" >}}Microsoft Teams{{< /nextlink >}}
{{< nextlink href="/incident_response/incident_management/integrations/google_chat" >}}Google Chat{{< /nextlink >}}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, added!

{{< nextlink href="/incident_response/incident_management/integrations/jira" >}}Jira{{< /nextlink >}}
{{< nextlink href="/incident_response/incident_management/integrations/servicenow" >}}ServiceNow{{< /nextlink >}}
{{< nextlink href="/incident_response/incident_management/integrations/status_pages" >}}Status Pages{{< /nextlink >}}
{{< nextlink href="/incident_response/incident_management/integrations/statuspage" >}}Atlassian Statuspage{{< /nextlink >}}

{{< /whatsnext >}}

## Further reading
Expand Down
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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed


## Prerequisites

Install the integration through the [Google Chat Integration tile][1]. A Google Workspace admin must configure delegated user permissions and set up a target audience and add that to the integration tile. For more information, see the [Google Chat integration][2] documentation.

After the integration is installed, navigate to [**Incidents** > **Settings** > **Integrations**][3] to enable Google Chat features for Incident Management.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

removed


## Incident Spaces

You can configure Incident Management to automatically create a dedicated Google space for each incident that meets criteria you define. Your responders can then manage the incident directly in Google Chat from the incident space.

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)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed!


## Further reading

{{< partial name="whats-next/whats-next.html" >}}

[1]: https://app.datadoghq.com/integrations/google-hangouts-chat
[2]: /integrations/google-hangouts-chat/
[3]: https://app.datadoghq.com/incidents/settings#Integrations
Loading