Individual skill
cloud-trace-querying
Query Cloud Trace spans, filter by latency thresholds or error status, correlate distributed traces with Cloud Logging, and diagnose latency bottlenecks across Google Cloud services. Use when investigating slow requests, analyzing trace hierarchies, or resolving latency regressions. Do NOT use for querying non-GCP telemetry or database query optimization outside Cloud Trace.
skills/cloud/cloud-trace-querying/SKILL.md
Source commit 496fbede89dac1faf0d180a936bfc472b6fbf886
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 4, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 23,637
- Repository last updated
- Nov 7, 2026
- License
- Apache-2.0
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- google Repository topic
- googlecloud Repository topic
- skills Repository topic
- data Derived category
- data-databases Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 7,328 bytesSKILL.mdcore · 7,328 bytesSKILL.mdcore · 7,328 bytesSKILL.mdcore · 7,328 bytesSKILL.mdcore · 7,328 bytesSKILL.mdcore · 7,328 bytesSKILL.mdcore · 7,328 bytesSKILL.mdcore · 7,328 bytesSKILL.mdcore · 7,328 bytesSKILL.mdcore · 7,328 bytesSKILL.mdcore · 7,328 bytesSKILL.mdcore · 7,328 bytesassets/formatting/a2ui/single_span/display.a2ui.jsonasset · 1,113 bytesassets/formatting/a2ui/trace_chart/display.a2ui.jsonasset · 1,133 bytesassets/formatting/a2ui/trace_flow/display.a2ui.jsonasset · 767 bytesassets/formatting/a2ui/traces_heat_map/display.a2ui.jsonasset · 1,817 bytesassets/formatting/ascii/single_span/display.txtdoc · 377 bytesassets/formatting/ascii/trace_chart/display.txtdoc · 517 bytesassets/formatting/ascii/trace_flow/display.txtdoc · 430 bytesassets/formatting/ascii/traces_heat_map/display.txtdoc · 887 bytesassets/queries/billing_errors/SCENARIO.mddoc · 1,396 bytesassets/queries/billing_errors/query.txtdoc · 73 bytesassets/queries/checkout_latency/SCENARIO.mddoc · 416 bytesassets/queries/checkout_latency/query.txtdoc · 47 bytesassets/queries/customer_spans/SCENARIO.mddoc · 307 bytesassets/queries/customer_spans/query.txtdoc · 24 bytesassets/queries/prod_outliers/SCENARIO.mddoc · 979 bytesassets/queries/prod_outliers/query.txtdoc · 51 bytesassets/queries/slow_db/SCENARIO.mddoc · 440 bytesassets/queries/slow_db/query.txtdoc · 35 bytesreferences/api-limits.mddoc · 1,595 bytesreferences/attribution.mddoc · 1,900 bytesreferences/concepts-span.mddoc · 869 bytesreferences/concepts-trace.mddoc · 1,321 bytesreferences/console-deep-links.mddoc · 1,109 bytesreferences/conventions-gcp-legacy.mddoc · 3,496 bytesreferences/conventions-gcp.mddoc · 2,789 bytesreferences/conventions-otel-genai.mddoc · 7,017 bytesreferences/conventions-otel-grpc.mddoc · 2,416 bytesreferences/conventions-otel-http.mddoc · 1,906 bytesreferences/conventions-otel.mddoc · 4,254 bytesreferences/conventions.mddoc · 2,589 bytesreferences/correlated-logs.mddoc · 2,551 bytesreferences/decision-tree.mddoc · 2,150 bytesreferences/filter-syntax.mddoc · 4,092 bytesreferences/index.mddoc · 2,784 bytesreferences/knowledge-overview.mddoc · 3,241 bytesreferences/logs-trace-correlation.mddoc · 1,699 bytesreferences/observability-scopes.mddoc · 3,050 bytesreferences/querying-mcp.mddoc · 2,078 bytesreferences/querying-observability-analytics.mddoc · 5,002 bytesreferences/troubleshoot-latency.mddoc · 2,166 bytesreferences/workflows-overview.mddoc · 881 bytesscripts/fetch_entire_trace/run.shruns · 231 bytesscripts/fetch_entire_trace/src/main.pyruns · 1,815 bytesscripts/fetch_entire_trace/test.shruns · 279 bytesscripts/fetch_entire_trace/tests/main_test.pyruns · 3,969 bytesscripts/fetch_related_logs/run.shruns · 231 bytesscripts/fetch_related_logs/src/log_fetcher.pyruns · 7,611 bytesscripts/fetch_related_logs/src/main.pyruns · 2,437 bytesscripts/fetch_related_logs/src/observability_scopes.pyruns · 3,029 bytesscripts/fetch_related_logs/src/timestamp_utils.pyruns · 577 bytesscripts/fetch_related_logs/test.shruns · 422 bytesscripts/fetch_related_logs/tests/main_test.pyruns · 10,808 bytesscripts/fetch_related_logs/tests/timestamp_utils_test.pyruns · 1,125 bytesscripts/fetch_trace_span/run.shruns · 231 bytesscripts/fetch_trace_span/src/main.pyruns · 2,685 bytesscripts/fetch_trace_span/test.shruns · 279 bytesscripts/fetch_trace_span/tests/main_test.pyruns · 5,211 bytesscripts/generate_links/run.shruns · 138 bytesscripts/generate_links/src/main.pyruns · 1,706 bytesscripts/generate_links/test.shruns · 279 bytesscripts/generate_links/tests/main_test.pyruns · 2,812 bytesscripts/get_trace_project/run.shruns · 231 bytesscripts/get_trace_project/src/main.pyruns · 402 bytesscripts/get_trace_project/src/project_resolver.pyruns · 2,097 bytesscripts/get_trace_project/test.shruns · 279 bytesscripts/get_trace_project/tests/integration_test.pyruns · 2,796 bytesscripts/get_trace_project/tests/project_resolver_test.pyruns · 2,833 bytesscripts/requirements.txtdoc · 92 bytesscripts/run_python_with_deps/run.shruns · 2,003 bytesscripts/run_python_with_deps/src/cleanup_env.pyruns · 2,143 bytesscripts/run_python_with_deps/src/lock_manager.pyruns · 2,577 bytesscripts/run_python_with_deps/src/manage_venv.pyruns · 1,724 bytesscripts/run_python_with_deps/src/path_resolver.pyruns · 3,521 bytesscripts/run_python_with_deps/src/venv_cleaner.pyruns · 800 bytesscripts/run_python_with_deps/src/venv_executor.pyruns · 1,192 bytesscripts/run_python_with_deps/src/venv_setup.pyruns · 2,140 bytesscripts/run_python_with_deps/test.shruns · 364 bytesscripts/run_python_with_deps/tests/cleanup_env_test.pyruns · 2,551 bytesscripts/run_python_with_deps/tests/lock_manager_test.pyruns · 2,065 bytesscripts/run_python_with_deps/tests/path_resolver_test.pyruns · 5,493 bytesscripts/run_python_with_deps/tests/venv_setup_test.pyruns · 1,845 bytesscripts/search_traces/run.shruns · 231 bytesscripts/search_traces/src/main.pyruns · 2,140 bytesscripts/search_traces/src/timestamp_utils.pyruns · 1,526 bytesscripts/search_traces/src/trace_searcher.pyruns · 16,347 bytesscripts/search_traces/test.shruns · 279 bytesscripts/search_traces/tests/main_test.pyruns · 2,794 bytesscripts/search_traces/tests/timestamp_utils_test.pyruns · 1,785 bytesscripts/search_traces/tests/trace_searcher_test.pyruns · 17,804 bytes
Read excerpt
# Cloud Trace Querying Skill (`cloud-trace-querying`)
This skill equips the agent to interact with Cloud Trace by providing standard query patterns, diagnostic workflows for latency and errors, and tools to fetch and inspect trace hierarchies.
> [!IMPORTANT]
> **AUTONOMOUS TOOL EXECUTION MANDATE**:
> You MUST execute the tool scripts directly in bash to query telemetry.
> Do NOT just describe query strings or write Python scripts. Run the provided bash tools directly and report the exact results.
## Attribution
**MUST READ**: Before executing any `gcloud`, REST API, or MCP command, you
MUST read [Usage Attribution](references/attribution.md). For commands executed
directly in the terminal (never in generated scripts, Terraform, or user code),