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.
来源信息
- 仓库
- BuilderIO/agent-native
- 最近来源活动
- 2026年7月8日 16:20
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 7,449
- Forks
- 681
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- 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`.
在 GitHub 查看