Observability

---
name: observability
description: "Use this sub-skill when adding or debugging observability for
  agents-cli projects, including Cloud Trace, Cloud Logging, prompt-response
  logging, BigQuery Agent Analytics, and third-party telemetry."
metadata:
  disco-role: operating
  author: Google
  license: Apache-2.0
  version: 1.3.1
  requires:
    bins:
      - agents-cli
    install: "uv tool install google-agents-cli"
disable-model-invocation: true
license: Apache 2.0
---

# Observability

Use this sub-skill inside the `google-agents-cli` repo skill. It is a router plus operating checklist; move into the bundled references for full command flags, schemas, and examples.

## When to Use

- The user wants traces, logs, prompt-response logging, analytics, or telemetry.
- The task mentions Cloud Trace, Cloud Logging, BigQuery Agent Analytics, AgentOps, Arize, Comet, or Weave.
- You need observability provisioning or verification commands after deployment.

## Workflow

1. Decide whether the user needs traces only or full prompt-response/BigQuery analytics.
2. Provision required infrastructure with the deploy/infra guidance when needed.
3. Set environment variables and deployment config for logging/telemetry sinks.
4. Verify traces/log rows/analytics records after a real request.

## Read These References

- `references/observability-guide.md` — read for observability guide details.
- `references/bigquery-agent-analytics.md` — read for bigquery agent analytics details.
- `references/cloud-trace-and-logging.md` — read for cloud trace and logging details.

## Verification and Safety

Safe checks: inspect config/env and docs; provisioning and telemetry verification need cloud credentials and a deployed/requested agent.

## Boundaries

- Does not deploy or publish by itself.
- Does not enable third-party telemetry without user approval for keys/data flow.

## Related Sub-Skills

- `../workflow/SKILL.md` — lifecycle routing and approval gates.
- `../scaffold/SKILL.md` — project creation/enhancement.
- `../adk-code/SKILL.md` — ADK Python implementation patterns.
- `../eval/SKILL.md` — evaluation loops and metrics.
- `../deploy/SKILL.md` — deployment and infrastructure.
- `../publish/SKILL.md` — Gemini Enterprise registration.
- `../observability/SKILL.md` — logging, tracing, and analytics.