New Relic Google Cloud Platform (GCP) integrations are part of New Relic infrastructure and bring your cloud service metrics into infrastructure monitoring, where you can query data, build dashboards, and set alerts alongside the rest of your telemetry. If you don't have a New Relic account yet, create one before you start.
Compare connection options
There are three ways to connect GCP to New Relic. Review the options below, then follow the setup guide for your chosen method.
Workload Identity Federation (Recommended) | New Relic service account | Google user account | |
|---|---|---|---|
Who controls credentials | You create and own the service account | New Relic creates and manages it | A Google user owns it |
Credential type | Short-lived tokens (1 hour) | Long-lived key pair | OAuth refresh token |
Polling frequency | 5 minutes (1 minute in limited preview)* | 5 minutes | 5 minutes |
Metric coverage | All GCP metrics, including some beta metrics, which WIF collects automatically | A predefined set per service | A predefined set per service |
Data format | Dimensional metrics ( | Dimensional metrics and sample events ( | Dimensional metrics and sample events ( |
New metrics | Available automatically as GCP adds them | Requires a New Relic update | Requires a New Relic update |
Important
*1-minute polling intervals for WIF integrations are in limited preview and available only for selected services. Services WIF currently supports: Managed Service for Apache Kafka, Cloud Dataflow, Cloud Dataproc, Cloud Spanner, Google Kubernetes Engine (GKE), BigQuery, AlloyDB for PostgreSQL, Cloud Load Balancing, and Cloud Pub/Sub. To request access, contact New Relic support.
We recommend Workload Identity Federation for new integrations. It uses short-lived credentials for better security, covers a broader set of metrics, and automatically collects new metrics as GCP adds them. If you already have a service account integration, it continues to work—you can add new projects with WIF alongside your existing setup.
Important
- Higher data ingest: WIF collects all generally available (GA) and Beta metrics along with native labels for supported Google Cloud services. Ingest for the same set of services is typically higher than with the service account-based integration.
- Google Cloud API charges: Google Cloud bills the Cloud Monitoring API calls made by the WIF integration to the integrated Google Cloud project. See Google Cloud Observability pricing for details.
To learn about the permissions and roles New Relic needs to monitor your GCP services, see Integrations and custom roles.
Setup guides
- Workload Identity Federation (Recommended)
- Manually integrate your GCP project/folder — uses short-lived credentials for better security
- Automate with Terraform — automates WIF setup using Terraform
- New Relic service account — uses a New Relic-managed service account
- Google user account — uses your Google user account credentials