skilld
All skills
google avatar

/google-agents-cli-observability

@2c39459
by googlegoogle/agents-cli6k stars
686

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).

Requires /google-agents-cli-scaffold /google-agents-cli-deploy /google-agents-cli-workflow /google-agents-cli-adk-code

Ask your Agent

Use this Skill: https://skilld.dev/gh/google/agents-cli/google-agents-cli-observability

This session only. Nothing lands on disk.

referencesbigquery-agent-analytics.md

≈333 tokens on demand. Your agent reads this file only when SKILL.md points to it.

BigQuery Agent Analytics Plugin

ADK Python projects only. Opt-in. Enable with --bq-analytics at scaffold time, or add manually to app/agent.py.

An optional ADK plugin that logs structured agent events directly to BigQuery via the Storage Write API. Enables:

  • Conversational analytics — session flows, user interaction patterns
  • LLM-as-judge evals — structured data for evaluation pipelines
  • Custom dashboards — Looker Studio integration
  • Tool provenance tracking — LOCAL, MCP, SUB_AGENT, A2A, TRANSFER_AGENT

Enabling

Method How
At scaffold time agents-cli scaffold create <project-name> --bq-analytics
Post-scaffold Add the plugin manually to app/agent.py (see ADK docs)

Infrastructure (BigQuery dataset, GCS offloading) is provisioned automatically by Terraform when enabled at scaffold time.

Key Features

  • Auto-schema upgrade (new fields added without migration)
  • GCS offloading for multimodal content (images, audio)
  • Distributed tracing via OpenTelemetry span context
  • SQL-queryable event log for all agent interactions

For full schema, SQL query examples, and Looker Studio setup, fetch https://adk.dev/integrations/bigquery-agent-analytics/index.md.

Source: SKILL.md on GitHub

Third-party checks

1 warningtoday3 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    This skill provides configuration and architectural guidance for agent observability within a specific development environment. It includes information on distributed tracing, logging, and third-party integrations, which are standard practices for production monitoring.

  • Sockettoday

    No alerts

  • Snyktoday

    Risk: MEDIUM · 1 issue

Provenance

Signed by skilld at 2c39459. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated 2 days ago

Capability

Other metadata
metadata
{
  "author": "Google",
  "license": "Apache-2.0",
  "version": "1.8.0",
  "requires": {
    "bins": [
      "agents-cli"
    ],
    "install": "uv tool install google-agents-cli"
  }
}

README badge

README badge for google/agents-cli/google-agents-cli-observability