Step-by-step walkthrough for setting up the GCP integration manually. Read the Overview first to understand how telemetry flows and the costs, then work through the steps below in order.
1. Create a service account
Enable the required APIs and create a GCP service account with least-privilege IAM roles for metrics.
2. Connect your GCP account in SigNoz
Fill in Account Name, Deployment Project ID, Deployment Region, and Projects to Monitor, then connect the account.
3. Deploy the OpenTelemetry Collector
Run the OpenTelemetry Collector in your deployment project (Cloud Run, or any compute that can reach the Monitoring API).
4. Collect metrics
Configure the googlecloudmonitoring receiver to scrape Cloud Monitoring metrics across your monitored projects.
Connection fields
Step 2 asks for four values. Keep them handy, since later steps refer back to them.
| Field | What it means |
|---|---|
| Account Name | A label to identify this integration in SigNoz, for example production. |
| Deployment Project ID | The project where you deploy the Collector. |
| Deployment Region | The region the Cloud Run Collector runs in. |
| Projects to Monitor | The project IDs whose metrics you want in SigNoz. |
