What it does. > Cloud Trace works out of the box — no infrastructure needed. Prompt-response logging and BigQuery Agent Analytics require Terraform-provisioned infrastructure (service account, GCS bucket, BigQuery dataset). Run
agents-cli infra single-project --project PROJECT_ID
to provision these resources. See
references/cloud-trace-and-logging.md
for details, env vars, and verification commands. If your project isn't scaffolded yet, see
/google-agents-cli-scaffold
first.
For
deployment_target = agent_runtime
, run
agents-cli infra single-project
before the first
agents-cli deploy
. The Terraform module owns the entire Reasoning Engine resource (service account, deployment spec, env vars), so applying it after an SDK-based deploy creates a state mismatch Terraform can't reconcile without taking ownership of the whole resource.
Highlights
NO_CONTENT
— no content in spans/events (scaffolded default)EVENT_ONLY
— content in Cloud Logging eventsSPAN_ONLY
/ SPAN_AND_EVENT
— content in trace spanstrue
/ false
— invalid; fall back to NO_CONTENT
When to use it. Use when you "set up tracing", "monitor my agent", "configure logging", "add observability", "debug production traffic", or needs guidance on monitoring deployed agents, including ADK (Agent…
Install
npx skills add google/agents-cli --skill google-agents-cli-observability
Or copy the skill folder manually:
git clone https://github.com/google/agents-cli.git
cp -r agents-cli/skills/google-agents-cli-observability/ ~/.claude/skills/google-agents-cli-observability
Source: google/agents-cli — 5,793 stars, Apache-2.0, last pushed 2026-09-01.
