Google Chat

This product is not supported for your selected Datadog site. ().

Overview

Connect Google Chat™ to Datadog and help your team collaborate by:

  • Receiving alerts and notifications from Datadog within Google Chat™.
  • Sharing graphs with your colleagues in your team’s private or public spaces.

Data Collected: This integration collects identifying information about connected Google user accounts, Google organizations, and Google Chat™ spaces to enable a delegated user account to take action on your behalf. Datadog does not retain or use data obtained through Google Chat™ APIs to develop, improve, or train generalized AI or ML models.

Setup

Prerequisites

Google Workspace administrators must first:

  1. Allowlist the Datadog app for the top-level organizational unit in the Google Workspace Admin Console.
  2. Ensure users have top-level organizational unit access for Google Chat.

Google Chat apps require top-level organizational unit access to function properly. Without top-level access, the Datadog app may fail to work correctly with the Google Chat APIs.

Installation

To add the Datadog application to a Google Chat space:

  1. Type @Datadog in the message composer.
  2. Select the Datadog app.
  3. Send the message.

If users cannot see or install the Datadog app, verify that:

  • The app is allowlisted in the Google Workspace Admin Console
  • Users have the necessary Google Chat permissions
  • The organization allows third-party apps

Send monitor notifications to a Google Chat space

  1. After installation, post the command @Datadog install in the space. To connect the space to Datadog for sites other than the default domain (app.datadoghq.com), append the domain to the command. For example, @Datadog install mydomain.datadoghq.eu.
  2. Click the Datadog app’s prompt to sign in to your Datadog account and follow the redirect to Datadog.
  3. The name and url of the space is now configured in the Google Chat integration tile within Configure > Spaces. You can use the handle @hangouts-<your-space-name> as a standard Datadog notification handle.
  4. In a Datadog monitor, type @hangouts in the monitor message box to see a list of spaces where you can send the notification.
  5. Select @hangouts-<your-space-name> to add it to the monitor.

Connect a delegated user to perform actions in a Google organization

  1. Connect a Google organization
    1. Run the /dd_accounts slash command within a Google Chat space.
    2. Select your Datadog site.
    3. Click Connect Organization, which redirects you to Datadog.
    4. Select your Datadog organization.
    5. Your Google organization is now available in the Google Chat integration tile in Configure > Organizations.
  2. Create the service account user that will take actions on behalf of Datadog
    1. Create a Google service account user. Datadog recommends giving this service account user a name such as ‘Datadog’ to distinguish it from actual Google users and avoid confusion.
    2. Assign a Google Workspace license to the service account user, and ensure it has Google Chat enabled.
  3. Connect the delegated user
    1. Navigate to the Configure tab within the Google Chat integration tile.
    2. Select the Organizations tab.
    3. Select a connected organization.
    4. Click the gear icon in the upper-right corner to open the settings menu.
    5. Select Connect delegated user for organization, which redirects you to Google.
    6. Sign in to Google as the service account user you want to perform actions on behalf of Datadog.
    7. Follow the prompts until you are redirected to the Google Chat integration tile in Datadog.

Datadog app @-mention command summary

CommandDescription
@Datadog install (domain)Starts the workflow to connect a Google Chat space for notifications. Note: If you belong to more than one Datadog organization, an Account selection page is displayed during the install workflow.
@Datadog list installed accountsReturns a list of all Datadog organizations that are connected to the current Google Chat space.
@Datadog remove accountStarts the workflow to remove the current Google Chat space from a specific Datadog organization. The Datadog app responds with a card containing uninstall links for all Datadog organizations connected to the space. Click a Datadog organization to disconnect it from the space. The Datadog app will respond with the removed organization name.

Disconnecting Google Chat from a Datadog organization for notifications

There are three ways to disconnect a Google Chat space from a Datadog organization:

  1. In a Google Chat space, use the @Datadog remove account command to disconnect a space from a selected Datadog organization.
  2. From a Datadog organization, remove a space from the Google Chat integration tile under Configure > Spaces.
  3. Remove the app from the space to remove that space from any connected Datadog organizations.

From a Datadog organization, remove a space from the Google Chat integration tile

Delegated user permissions

To enable Incident Management features, the Google Chat integration requires a connected, delegated Google user to grant the following permissions.

Enable product-specific permissions from that product’s settings page, or grant all permission scopes by connecting a delegated user in the Google Chat integration tile.

Permission nameRequest Reason
chat.spaces.createEnable the delegated user to automatically create new conversations in Google Chat when an incident is declared in Datadog Incident Management.

Data Collected

Metrics

The Google Chat integration does not include any metrics.

Events

The Google Chat integration does not include any events.

Service Checks

The Google Chat integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.

Further Reading

Additional helpful documentation, links, and articles:

Integrate Datadog with Google Hangouts ChatBLOG more more Google Chat | Google for DevelopersAPI more more