skills.rest
timbuchinger
timbuchingerCOMMUNITY
Explore all skills by this author →
GitHub

gcp-troubleshoot

Diagnose GCP service issues via scoped logs and metrics.

1|Updated Dec 4, 2025
Search Tags:#troubleshooting#cloud#diagnostics#GCP#IAM#gcloud#Firestore#Cloud Run
One-click install
npx skills add https://github.com/timbuchinger/loadout --skill gcp-troubleshoot
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gcp-troubleshoot
Source: https://github.com/timbuchinger/loadout/tree/main/skills/gcp-troubleshoot
Command: npx skills add https://github.com/timbuchinger/loadout --skill gcp-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines troubleshooting across various GCP services by guiding you through a systematic, tool-first diagnostic process. It helps you quickly identify root causes for issues in Firestore, Cloud Run, IAM, and other key services.

Core Features & Use Cases

  • Service-Specific Diagnostics: Provides targeted troubleshooting for Firestore, Cloud Run, networking, IAM, Pub/Sub, Cloud SQL, and Storage.
  • Tool-First Approach: Prioritizes using efficient tool-based access (e.g., MCP) for logs, metrics, and audit events, falling back to gcloud CLI only when necessary.
  • Systematic Workflow: Guides through identifying the resource, querying scoped logs/metrics/audit logs, interpreting patterns, and suggesting actionable fixes.
  • Use Case: Your Cloud Run service is failing to start. This Skill helps you query Cloud Run logs, check revision history, and look for Cloud SQL connector errors to diagnose the problem efficiently.

Quick Start

Troubleshoot a 'PERMISSION_DENIED' error I'm getting when accessing Firestore, checking audit logs for the principal and role mismatch.

Frequently Asked Questions about gcp-troubleshoot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot a PERMISSION_DENIED error in Firestore?▼

Troubleshoot Firestore permission errors by querying audit logs through tools or gcloud to identify the principal, their assigned roles, and IAM policy mismatches. This Skill guides you through scoped log queries, role analysis, and minimal remediation steps to restore access.

Why is my Cloud Run service failing to start?▼

Diagnose Cloud Run startup failures by querying service logs, revision history, and checking for cloud SQL connector errors or resource constraints. This Skill systematically guides log interpretation and identifies root causes like quota limits or configuration issues.

How do I find and resolve latency issues in GCP services?▼

Resolve GCP latency by querying targeted metrics and logs across Firestore, Cloud Run, networking, and load balancers using tool-first access. This Skill helps you scope queries by service and time window, interpret patterns, and propose safe fixes.

Can I troubleshoot Cloud SQL connectivity and quota problems with GCP tools?▼

Yes. This Skill covers Cloud SQL connectivity diagnostics alongside quota exceedances, networking issues, and load balancer problems using tool-based log and metric queries. It enforces scoped, targeted diagnostics to pinpoint root causes across GCP infrastructure.

What's the best way to diagnose Pub/Sub and Storage issues in GCP?▼

Diagnose Pub/Sub and Storage issues through systematic, tool-first troubleshooting that queries service-specific logs and metrics, interprets error patterns, and proposes targeted remediation. This Skill covers permission errors, connectivity, and quota problems across both services.

Do I need the gcloud CLI to troubleshoot GCP services, or can I use tools instead?▼

This Skill prioritizes tool-based access (MCP tooling when configured) for efficiency, falling back to gcloud CLI only when necessary. You can troubleshoot most GCP services without CLI-only dependency using available tools and scoped queries.

Related Skills

Explore More Software Engineering Skills→
pingwupingwu
12

gcloud-expert

Generate precise gcloud commands for managing Google Cloud resources.

Community
Advanced
briannadoubtbriannadoubt

observability

Configure structured logs, metrics, and traces for Trebuchet actors with CloudWatch export.

Community
Intermediate
automateyournetworkautomateyournetwork
627

gcp-cloud-monitoring

Query Google Cloud Monitoring for metrics, alert policies, and active alerts.

Community
Intermediate
aibangjuxinaibangjuxin
2

architectrue

Designs, optimizes, and implements production-focused GKE and GCP architectures.

Community
Advanced