bigquery-troubleshooting
Provides diagnostic workflows and step-by-step root-cause analysis procedures for actively broken, failing, or slow BigQuery jobs, execution graph and query plan stage bottlenecks, system performance issues, or unexpectedly expensive workloads. Use when interpreting symptoms, isolating bottlenecks, diagnosing cost spikes (on-demand query spend, capacity slot autoscaling, storage growth), execution graph stages or substep variables, identifying root causes, and determining remediation steps. Don't use for writing or optimizing SQL, proactive capacity planning, or storage layout design (use bigquery-optimization), or when the user already knows which telemetry they want and just needs the query (use bigquery-observability).
- Version
- v1
- License
- Apache-2.0
Pinned to revision 6f4818a4c525, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/bigquery-troubleshooting/SKILL.md
- skills/bigquery-troubleshooting/references/cost_compute_capacity.md
- skills/bigquery-troubleshooting/references/cost_compute_ondemand.md
- skills/bigquery-troubleshooting/references/cost_storage.md
- skills/bigquery-troubleshooting/references/performance_config_changed.md
- skills/bigquery-troubleshooting/references/performance_resource_contention.md
- skills/bigquery-troubleshooting/references/query_plan_execution_graph.md
Every link opens the file at its source, pinned to the revision this page describes.