-
Notifications
You must be signed in to change notification settings - Fork 0
Observability Coverage
Module flag: coverage
Enabled by default: yes
The Observability Coverage module scores each compute node (Cloud Run service, GKE workload, Cloud Function) on how completely it is covered by observability signals: metrics, traces, logs, and alert policies. Use it to find blind spots and prioritize instrumentation investment.
GCP_PROJECT_ID=my-project ./aura-tracker-gcp --modules coveragegcloud services enable monitoring.googleapis.com cloudtrace.googleapis.com logging.googleapis.com| Role | Tools that need it |
|---|---|
roles/monitoring.viewer |
Metrics and alert policy checks |
roles/cloudtrace.user |
Trace presence check |
roles/logging.viewer |
Log presence check |
Computes an observability coverage score (0.0–1.0) for each compute node in the project.
Parameters:
| Name | Required | Description |
|---|---|---|
project_id |
yes | GCP project ID |
resource_kind |
no | Filter to cloud_run, gke_workload, or cloud_function; omit for all |
Coverage score formula:
| Signal | Weight |
|---|---|
| Metrics present | 0.35 |
| Traces present | 0.35 |
| Logs present | 0.20 |
| Alert policy present | 0.10 |
| OpenTelemetry sidecar (bonus) | +0.10 |
Returns: Per-node coverage score and which signals are present/missing. Project-wide gap list (nodes scoring below 0.5) with estimated monthly cost impact of enabling the missing signals.
Full coverage report
"Run an observability coverage analysis for project my-project and show me which services have the biggest gaps."
Trace gap
"Which Cloud Run services in project my-project have no trace data?"
Alert gap
"Which compute nodes in project my-project have no alert policy configured?"
Cost estimate
"What would it cost to enable Cloud Trace on all the Cloud Run services currently missing it in project my-project?"
| Module flag | Why you'd combine it |
|---|---|
monitoring |
Inspect or create the alert policies filling coverage gaps |
cloudrun |
Get service details for nodes flagged as under-covered |
aura |
Aura Score complements coverage — health vs. observability completeness |