gcloud
Monitor Google Cloud Run services and Cloud Functions health, metrics, and logs. Use this skill when the user asks about service health, request counts, latencies, or cloud infrastructure.
Source facts
- Repository
- BuilderIO/agent-native
- Last source activity
- July 8, 2026 at 16:20
- Detected SKILL.md language
- English
- Stars
- 7,449
- Forks
- 681
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- gcloud
- description
- Monitor Google Cloud Run services and Cloud Functions health, metrics, and logs. Use this skill when the user asks about service health, request counts, latencies, or cloud infrastructure.
# Google Cloud Integration
## Connection
- **Project**: `BIGQUERY_PROJECT_ID` from Settings → Data sources
- **Service account**: from `GOOGLE_APPLICATION_CREDENTIALS_JSON`
- **Auth**: `GOOGLE_APPLICATION_CREDENTIALS_JSON` credential (JSON credentials string) — no ADC fallback
- **IAM roles**: `monitoring.viewer`, `run.viewer`, `cloudfunctions.viewer`, `logging.viewer`
- **Caching**: 5-minute in-memory cache, max 120 entries
## Server Lib & API Routes
- **File**: `server/lib/gcloud.ts`
### Exported Functions
| Function | Description |
| --------------------------------------------------------------------------- | ---------------------------------- |
| `listCloudRunServices()` | List all Cloud Run services |
| `listCloudFunctions()` | List all Cloud Functions |
| `queryMetrics(filter, period, aligner?, reducer?, groupBy?)` | Query Cloud Monitoring time series |
| `getServiceMetrics(serviceType, serviceName, metric, period, extraFilter?)` | Convenience metric query |
| `listLogEntries(filter, pageSize?)` | Read Cloud Logging entries |
### API Routes
| Route | Description |
| -------------------------- | ----------------------- |
| `GET /api/gcloud/services` | List Cloud Run services |
| `GET /api/gcloud/metrics` | Query metrics |
| `GET /api/gcloud/logs` | Read log entries |
### Agent Action
Use `gcloud` for agent-facing Google Cloud work. Do not call
`/api/gcloud/*` directly from the agent.
| Mode | Args | Description |
| ---------- | ----------------------------------------------------------- | ------------------------------------------- |
| `services` | | List Cloud Run services and Cloud Functions |
| `metrics` | `service`, `serviceType`, `metric`, `period`, `extraFilter` | Query Cloud Monitoring |
| `logs` | `service`, `serviceType`, `severity`, `limit` | Read Cloud Logging |
### Dashboard
- `/adhoc/gcloud` — Google Cloud Health dashboard
## Google Cloud APIs Used
- Cloud Run Admin API v2: `/v2/projects/{project}/locations/-/services`
- Cloud Functions API v2: `/v2/projects/{project}/locations/-/functions`
- Cloud Monitoring API v3: `/v3/projects/{project}/timeSeries`
- Cloud Logging API v2: `/v2/entries:list`
## Key Metrics
- **Cloud Run**: `run.googleapis.com/request_count`, `request_latencies`, `container/instance_count`, `container/cpu/utilization`
- **Cloud Functions**: `cloudfunctions.googleapis.com/function/execution_count`, `execution_times`, `active_instances`
## Key Patterns & Gotchas
- **Scale**: 78 Cloud Run services, 237+ Cloud Functions — UI uses searchable dropdown
- **Alignment periods**: 1h→60s, 6h→300s, 24h→600s, 7d→3600s
- `getServiceMetrics` auto-selects aligner/reducer based on metric name (latency→percentile, request_count→ALIGN_DELTA, memory→ALIGN_MEAN)
- `queryMetrics` maps point values from `doubleValue`, `int64Value`, or distribution mean
- `listLogEntries` uses POST payload; returns entries reversed
- Project ID comes from the user's configured `BIGQUERY_PROJECT_ID`.
View on GitHub