---
title: Connect with a New Relic service account
source: https://docs.newrelic.com/docs/infrastructure/google-cloud-platform-integrations/get-started/install-and-configure/connect-gcp-service-account
---

With this connection method, New Relic calls your GCP project APIs using a New Relic-managed service account ID and its associated public/private key pair. You don't need to create or manage the service account or its private key — just add the service account ID as a member with viewing permissions in your project. New Relic collects tags and other attributes whenever possible using this method.

> #### 💡 TIP
>
> You can use Terraform to automate the process of enabling cloud integrations. Read how in the [Terraform official documentation site](https://registry.terraform.io/providers/newrelic/newrelic/latest/docs/guides/cloud_integrations_guide).

## Requirements [#reqs]

Before you connect, ensure the following:

| Requirement   | Details                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Monitoring    | In the GCP project **API & Services Library** settings, you must enable **Google Stackdriver Monitoring API**.                                                                                                                                                                                                                                                                                                                                            |
| Authorization | You need a user with the **Project IAM Admin** role to add the service account ID to your GCP project. Before you add it, select **Fetch data** in the New Relic onboarding wizard to verify authorization. In **IAM & admin**, assign the service account the **Viewer** and **Service Usage Consumer** roles, or a [custom role](https://docs.newrelic.com/docs/integrations/google-cloud-platform-integrations/get-started/integrations-custom-roles). |
| Project name  | As part of the [online setup process](#connect), you must identify the `Project name` of the projects you want to monitor with New Relic. The UI workflow automatically lists active projects you can select.                                                                                                                                                                                                                                             |

If your organization uses a domain restriction constraint, update the policy to allow New Relic. For the identifiers to allow, see [Domain restriction constraints](https://docs.newrelic.com/docs/infrastructure/google-cloud-platform-integrations/get-started/integrations-custom-roles#domain-restrictions).

## Connect GCP to New Relic [#connect]

> #### ⚠️ IMPORTANT
>
> If this is your first time setting up GCP with New Relic, ensure that you've enabled Cloud Monitoring API for your project. You can do this in the [Google Cloud console](https://console.cloud.google.com/apis/api/monitoring.googleapis.com/).

To connect your Google Cloud project to New Relic with service account authorization:

1.  Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > GCP**. On the **Google Cloud Services** integrations page, select **Add a GCP account**.
2.  **Choose Authorization Method**: Select **Authorize a Service Account**, and follow the instructions in the UI to authorize New Relic.
3.  **Add projects:** Select the projects that you want New Relic to receive data from.
4.  **Select services:** From the list of available services for your GCP account, select the individual services you want New Relic to receive data from, or select all of the services.

    > #### 💡 TIP
    >
    > These services are enabled for **all** of the projects that you selected in the previous step. Once the setup process is finished, you can fine-tune the services that you want monitored for each project individually.
5.  To complete the setup process, select **Finish**.

If you see API authentication errors, follow the [troubleshooting procedures](https://docs.newrelic.com/docs/infrastructure/google-cloud-platform-integrations/troubleshooting/troubleshooting-gcp-integrations).

New resources may take a few minutes to be detected and synthesized as entities. For more information, see Cloud integrations [system limits](https://docs.newrelic.com/docs/data-apis/manage-data/view-system-limits).

## View your GCP data [#find-data]

After you connect, New Relic starts monitoring your GCP data at regular [polling intervals](https://docs.newrelic.com/docs/infrastructure/google-cloud-platform-integrations/get-started/view-your-data/polling-intervals-gcp-integrations), and your data appears in the New Relic UI after a few minutes. To learn how to view, query, and explore it — including dashboards, alerts, and entities — see [View and query your GCP data](https://docs.newrelic.com/docs/infrastructure/google-cloud-platform-integrations/get-started/view-your-data/view-and-query-your-gcp-data).

## Link multiple Google projects [#connect-multiple]

The setup process lets you select more than one project at a time.

After the first setup, to monitor additional GCP projects with New Relic, repeat the procedure to [connect your GCP services](#connect) as many times as you need.

## Disable or unlink your GCP integrations [#disconnect]

You can disable any integrations any time and still keep your Google project connected to New Relic.

### Disable one or more GCP services [#disable-services]

To disable services while keeping your GCP account linked to New Relic:

1.  Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > GCP > Manage services**.
2.  From your **Edit GCP account** page, clear the checkbox for each active service you want to disable.
3.  Save your changes.

### Disconnect and unlink your account [#unlink-account]

To completely disconnect from New Relic, unlink your GCP account. This disables all New Relic integrations associated with it. If you delete a custom role, note that the role might serve purposes beyond New Relic access.

For a **custom user role**:

1.  Sign in to New Relic and go to **Infrastructure > Integrations > Google Cloud Platform**.
2.  Go to **IAM > admin > Roles**, search for the role, select it, and select **DELETE**.

For a **standard (non-custom) user role**:

1.  Sign in to New Relic and go to **Infrastructure > Integrations > Google Cloud Platform**.
2.  Select **Manage services** for the account you want to remove. Copy the value of **User** and save it.
3.  Sign in to [Google Cloud](https://console.cloud.google.com/) and select the correct project in the **Select a project** box.
4.  From the navigation menu, select **IAM & admin > IAM**.
5.  Search for and select the user value you saved, then select **REMOVE**.

### Clean up GCP after unlinking [#clean-up]

To clean your GCP project after unlinking:

1.  Open the GCP IAM Console.
2.  Select the project you want to unlink from New Relic and select **Open**.
3.  Select the service account used by New Relic.
4.  Select the **Remove** icon.
