# Google Agents CLI Observability

Should be used when the user wants to "set up tracing", "monitor my agent", "configure...

- Repository: https://github.com/google/agents-cli (6276 stars)
- Category: Testing
- License: Apache-2.0
- Last updated: 2026-10-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add google/agents-cli --skill google-agents-cli-observability -g -a claude-code -y`
Codex: `npx skills add google/agents-cli --skill google-agents-cli-observability -g -a codex -y`
Cursor: `npx skills add google/agents-cli --skill google-agents-cli-observability -g -a cursor -y`
Gemini CLI: `npx skills add google/agents-cli --skill google-agents-cli-observability -g -a gemini-cli -y`

## Description

This skill should be used when the user wants to "set up tracing", "monitor my agent", "configure logging", "add observability", "debug production traffic", or needs guidance on monitoring deployed agents, including ADK (Agent Development Kit) agents. Covers Cloud Trace, prompt-response logging, BigQuery Agent Analytics, third-party integrations (AgentOps, Phoenix, MLflow, etc.), and troubleshooting. Part of the agents-cli skills suite. Do NOT use for deployment setup (use google-agents-cli-deploy) or API code patterns (use google-agents-cli-adk-code).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Observability Guide

> **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 --apply --project PROJECT_ID` to provision these resources. Go projects get the BigQuery telemetry stack too; the GCS completion upload behind prompt-response logging and the BigQuery Agent Analytics plugin are Python only. 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.

### Deployment order

| Do you want Terraform-managed observability? | Action |
|---|---|
| **No** | Run `agents-cli deploy` directly (works for all targets). |
| **Yes** | Run `agents-cli infra single-project --apply` first, then `agents-cli deploy`. |

The rest: https://github.com/google/agents-cli/blob/HEAD/skills/google-agents-cli-observability/SKILL.md