-
Notifications
You must be signed in to change notification settings - Fork 0
Cloud Monitoring and Trace
Module flag: monitoring
Enabled by default: yes
The Cloud Monitoring & Trace module provides broad observability: time-series metrics, alert policies, uptime checks, SLOs, dashboards, and trace-based service dependency graphs.
GCP_PROJECT_ID=my-project ./aura-tracker-gcp --modules monitoringgcloud services enable monitoring.googleapis.com cloudtrace.googleapis.com| Role | Tools that need it |
|---|---|
roles/monitoring.viewer |
All monitoring tools |
roles/cloudtrace.user |
Trace tools |
Fetches time-series metric data for a resource.
Parameters:
| Name | Required | Description |
|---|---|---|
project_id |
yes | GCP project ID |
metric_type |
yes | Full metric type, e.g. run.googleapis.com/request/count
|
hours |
no | Lookback window in hours (default: 1) |
alignment_period_seconds |
no | Aggregation bucket size in seconds (default: 60) |
resource_filter |
no | Additional resource label filter |
Returns: Time-series points with timestamps and values, metric descriptor labels.
Lists available metric descriptors, optionally filtered by prefix.
Parameters:
| Name | Required | Description |
|---|---|---|
project_id |
yes | GCP project ID |
filter |
no | Metric type prefix, e.g. run.googleapis.com
|
Returns: Metric type, display name, description, kind (GAUGE/DELTA/CUMULATIVE), value type, unit, labels.
Lists services that have sent traces to Cloud Trace.
Parameters:
| Name | Required | Description |
|---|---|---|
project_id |
yes | GCP project ID |
Returns: Service names with trace activity.
Lists Cloud Monitoring alert policies.
Parameters:
| Name | Required | Description |
|---|---|---|
project_id |
yes | GCP project ID |
Returns: Policy name, display name, enabled/disabled, severity, condition names and types, notification channels.
Lists uptime check configurations.
Parameters:
| Name | Required | Description |
|---|---|---|
project_id |
yes | GCP project ID |
Returns: Check name, display name, monitored resource (URL or IP), check period, timeout, checker type (global/regional).
Lists Service Level Objectives.
Parameters:
| Name | Required | Description |
|---|---|---|
project_id |
yes | GCP project ID |
service_id |
no | Filter to a specific Monitoring service |
Returns: SLO name, display name, goal (0–1), calendar period, SLI type (request-based or windows-based).
Lists Cloud Monitoring dashboards.
Parameters:
| Name | Required | Description |
|---|---|---|
project_id |
yes | GCP project ID |
Returns: Dashboard name, display name, etag, create time.
Infers service-to-service dependency edges from Cloud Trace span parent/child relationships (scans up to 2000 traces over a configurable window).
Parameters:
| Name | Required | Description |
|---|---|---|
project_id |
yes | GCP project ID |
hours |
no | Lookback window in hours (default: 168 = 7 days) |
limit |
no | Max traces to scan (default: 2000) |
Returns: Directed edges (caller_service → callee_service) with call counts.
Metric query
"Show me Cloud Run request error rate for project my-project over the last 30 minutes."
Alert audit
"Which alert policies in project my-project are currently disabled?"
SLO check
"List all SLOs in project my-project and flag any with a goal below 99.9%."
Trace dependency graph
"Infer the service call graph from Cloud Trace for project my-project over the last 7 days."
Metric discovery
"What Cloud Monitoring metrics are available for Cloud Run services?"
| Module flag | Why you'd combine it |
|---|---|
logging |
Correlate metric anomalies with error log entries |
aura |
Aura Score is built on Cloud Monitoring metrics |
coverage |
Coverage analysis uses monitoring signal presence |
archgraph |
Architecture Graph uses trace edges for dependency inference |