Каталог / google / google-agents-cli-observability
google-agents-cli-observability
google/agents-cli
12.6K
установок
#757
в рейтинге
Что делает
Настраивай трейсинг, логирование и мониторинг развёрнутых ADK-агентов через Cloud Trace, BigQuery и сторонние платформы.
- Четыре уровня observability: Cloud Trace (всегда включен, distributed tracing), Prompt-Response Logging (GenAI→GCS/BigQuery), BigQuery Agent Analytics (структурированные события агентов) и интеграции с третьими сторонами (AgentOps, Phoenix, MLflow, Weave, Freeplay и др.).
- Для Agent Runtime разверни agents-cli infra single-project перед первым деплоем чтобы провизионировать Terraform-управляемую инфраструктуру (сервис-аккаунт, GCS-бакет, BigQuery-датасет); постдеплойная настройка требует ручной IAM и env-var конфигурации.
- Cloud Trace работает из коробки с OpenTelemetry-спанами, отслеживающими invocation-поток, LLM-вызовы и выполнение инструментов; доступен в Cloud Console Trace explorer.
- Prompt-response логирование конфиденциально по умолчанию (метаданные только через OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=NO_CONTENT); отключено локально если LOGS_BUCKET_NAME не установлен.
- Включает гайд troubleshooting: отсутствующие трейсы, неправильная конфигурация privacy, BigQuery-настройка, стратегии оптимизации стоимости.
Установка
$ npx skills add google/agents-cli