Community생산성 & 협업github.com

google/adk-observability-guide

ADK 에이전트의 관측 가능성(Observability) 설정 전에 반드시 읽어야 할 가이드입니다. Cloud Trace, 프롬프트-응답 로깅, BigQuery Agent Analytics, 타사 통합 및 문제 해결 방법을 다룹니다.

adk-observability-guide란 무엇인가요?

이 스킬은 Google Agent Development Kit (ADK) 기반 에이전트의 관측 가능성을 설정하고 활용하는 방법을 상세히 안내합니다. 에이전트의 동작 디버깅, 성능 분석, 프로덕션 트래픽 모니터링이 필요할 때 이 가이드를 참조해야 합니다. 주요 구성 요소로는 분산 추적을 위한 Cloud Trace, 프롬프트-응답 쌍 로깅, BigQuery를 활용한 에이전트 분석, 그리고 OpenTelemetry 기반 타사 통합이 포함됩니다. 이 가이드는 ADK 에이전트를 배포한 환경에서 실제 트래픽을 처리하는 방식을 이해하고, 잠재적인 문제를 진단하며, 전반적인 성능을 최적화하는 데 필수적인 모범 사례와 설정 방법을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/google/adk-docs/tree/main/skills/adk-observability-guide

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

adk-observability-guide은(는) 무엇을 하나요?

ADK 에이전트의 관측 가능성(Observability)을 설정하기 전이나 프로덕션 트래픽을 분석할 때, 에이전트 동작을 디버깅할 때, 또는 에이전트 성능을 개선할 때 반드시 읽어야 합니다. ADK 관측 가능성 가이드 — Cloud Trace, 프롬프트-응답 로깅, BigQuery Agent Analytics, 타사 통합, 문제 해결에 대해 다룹니다. 에이전트에 대한 모니터링, 추적 또는 로깅을 구성할 때, 또는 배포된 에이전트가 실제 트래픽을 어떻게 처리하는지 이해해야 할 때 이 가이드를 사용하세요.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

google/adk-cheatsheet

MUST READ before writing or modifying ADK agent code. ADK API quick reference for Python — agent types, tool definitions, orchestration patterns, callbacks, and state management. Includes an index of all ADK documentation pages. Do NOT use for creating new projects (use adk-scaffold).

google/adk-deploy-guide

MUST READ before deploying any ADK agent. ADK deployment guide — Agent Engine, Cloud Run, GKE, CI/CD pipelines, secrets, observability, and production workflows. Use when deploying agents to Google Cloud or troubleshooting deployments. Do NOT use for API code patterns (use adk-cheatsheet), evaluation (use adk-eval-guide), or project scaffolding (use adk-scaffold).

google/adk-dev-guide

ALWAYS ACTIVE — read at the start of any ADK agent development session. ADK development lifecycle and mandatory coding guidelines — spec-driven workflow, code preservation rules, model selection, and troubleshooting.

google/adk-eval-guide

MUST READ before running any ADK evaluation. ADK evaluation methodology — eval metrics, evalset schema, LLM-as-judge, tool trajectory scoring, and common failure causes. Use when evaluating agent quality, running adk eval, or debugging eval results. Do NOT use for API code patterns (use adk-cheatsheet), deployment (use adk-deploy-guide), or project scaffolding (use adk-scaffold).

google/adk-scaffold

MUST READ before creating or enhancing any ADK agent project. Use when the user wants to build a new agent (e.g. "build me a search agent") or enhance an existing project (e.g. "add CI/CD to my project", "add RAG").

관련 스킬