Skip to content
cccskills
FreePublished on GitHub

gcloud

Check the health of Google Cloud Run services and Cloud Functions by reviewing request counts, latency, instance and CPU metrics, and logs. Use the results to investigate service status and cloud infrastructure questions.

OriginalShow the original 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.

BuilderIO/agent-native7,522 stars(GitHub 7,522 + cccskills 0)
Works withGoogle Cloud

Run score Not tested

See how to install

Good for

  • Checking whether a Cloud Run service is healthy
  • Reviewing request counts or latency over a chosen period
  • Reading Cloud Functions or Cloud Run logs
  • Investigating cloud service metrics

Files included (1)

  • SKILL.md3.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

FunctionDescription
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

RouteDescription
GET /api/gcloud/servicesList Cloud Run services
GET /api/gcloud/metricsQuery metrics
GET /api/gcloud/logsRead log entries

Agent Action

Use gcloud for agent-facing Google Cloud work. Do not call /api/gcloud/* directly from the agent.

ModeArgsDescription
servicesList Cloud Run services and Cloud Functions
metricsservice, serviceType, metric, period, extraFilterQuery Cloud Monitoring
logsservice, serviceType, severity, limitRead 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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

a2a-assets

FreeSummary

Generate, refine, export, and place brand images or videos from an Assets library into another app. The skill covers choosing a library, handling image batches and video runs, and updating selected assets after feedback.

  • Generate brand images for slides or another app
  • Refine an existing asset after feedback
  • Create and export a video asset
BuilderIO/agent-native7.5KUpdated Oct 26, 2026

account-health

FreeSummary

Prepare a customer account health, renewal, or contract usage readout. Verify the account identity, use approved metric definitions, compare contracted capacity with actual usage, and trace findings to sources, time windows, and known gaps.

  • Preparing a named customer's account health review
  • Comparing contracted seats or capacity with usage
  • Gathering adoption signals before a renewal or QBR
BuilderIO/agent-native7.5KUpdated Oct 26, 2026

actions

FreeSummary

Create focused app actions that agents can call as tools and frontend code can use through client hooks. Use them to add provider integrations or fetch UI data, with validated inputs and structured results.

  • Adding a new app operation
  • Connecting an external provider API
  • Fetching data for a frontend view
BuilderIO/agent-native7.5KUpdated Oct 26, 2026

adding-a-feature

FreeSummary

Use this checklist when adding a feature or integration to an agent-native app. It covers the user interface, agent-callable actions, instructions, and app-state sync so both the user and agent can work with the capability consistently.

  • Planning a new feature across UI and agent actions
  • Checking that agent changes appear in the UI
  • Documenting actions and feature state for the agent
BuilderIO/agent-native7.5KUpdated Oct 26, 2026

adhoc-analysis

FreeSummary

Investigate complex questions by combining data from multiple sources, then summarize patterns, metrics, and evidence in a clear report. Save requested analyses as dashboards with instructions for future refreshes.

  • Comparing CRM deals with call records
  • Investigating customer health across systems
  • Saving a repeatable performance analysis
BuilderIO/agent-native7.5KUpdated Oct 26, 2026

admin-surfaces

FreeSummary

Use the Analytics admin surfaces to inspect and change workspace feature flags, review dashboard ownership and usage activity, or browse and edit databases connected from other agent-native apps. The skill guides administrators to the relevant view and actions.

  • Review dashboard owners, views, and edits
  • Change a workspace feature flag for an app
  • Browse or edit a connected app database
BuilderIO/agent-native7.5KUpdated Oct 26, 2026

See all skills by BuilderIO

Report a problem with this skill