Add guide for collecting GCP managed service metrics - #241
Merged
Conversation
Documents the googlecloudmonitoring receiver for pulling metrics from GCP managed services (Cloud SQL, Memorystore, Pub/Sub, Cloud Run, BigQuery, Compute Engine) into Scout. Complements the existing GCP Cloud Logging guide. Metrics use a different mechanism to logs: the collector polls the Cloud Monitoring API, so there is no Log Router sink, Pub/Sub topic, or subscription — only a roles/monitoring.viewer grant and a metrics list. Covers metric discovery via Metrics Explorer, metric_name vs metric_descriptor_filter prefix collection, receiver options, and the GAUGE/DISTRIBUTION failure mode that can drop an entire scrape batch. Scoped to a single GCP project. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds
instrument/infra/gcp/gcp-cloud-monitoring-to-scout.md, covering thegooglecloudmonitoringreceiver for pulling GCP managed service metricsinto Scout.
Why
GCP had exactly one page on the site — the Cloud Logging guide — and no
metrics story at all. That's a gap next to AWS (a five-page
cloudwatch-metrics/section) and Azure (an overview plus ~22 per-servicepages). This is the metrics companion to the existing logs guide.
What it covers
Cloud Monitoring API, so there is no Log Router sink, Pub/Sub topic,
subscription, or publisher binding — just
roles/monitoring.viewerand ametrics list.
exhaustive per-service references (Cloud SQL, Memorystore Redis).
collection_intervaldefaults to 300s,minimum 60s;
initial_delay,timeout,endpoint).metric_namevsmetric_descriptor_filterfor collecting a wholeservice by prefix.
GAUGE+DISTRIBUTIONfailure mode, where one bad metric fails theentire scrape batch and drops every metric from that receiver instance.
Scope
Single GCP project. A cross-project variant is intended as a follow-up,
mirroring the one in the logs guide.
Verification
markdownlintclean on the new filenpm run typecheckpassesnpm run buildsucceeds —onBrokenLinksisthrow, so this confirmsall internal links resolve
Note:
npm run checkwas not run as-is because itsmarkdownlint -fstepauto-fixes every file in the repo, which would have swept in unrelated
changes. The three underlying checks were run individually instead.
🤖 Generated with Claude Code