observability-patterns

# Observability Patterns Skill

This skill provides comprehensive templates and configurations for implementing observability in Google ADK agents. Includes logging, tracing, BigQuery analytics, Cloud Trace integration, and third-party observability platforms.

## Overview

Google ADK supports multiple observability approaches for monitoring, debugging, and analyzing agent behavior:

1. **Cloud Trace** - Google Cloud native tracing with OpenTelemetry
2. **BigQuery Agent Analytics** - Comprehensive event logging and analysis
3. **AgentOps** - Session replays and unified tracing analytics
4. **Phoenix (Arize)** - Open-source observability with self-hosted control
5. **Weave (W&B)** - Weights & Biases platform for tracking and visualization

This skill covers production-ready observability implementations with security and scalability.

## Available Scripts

### 1. Setup Cloud Trace

**Script**: `scripts/setup-cloud-trace.sh <project-id>`

**Purpose**: Configures Cloud Trace integration for ADK agents

**Parameters**:
- `project-id` - Google Cloud project ID (required)

**Usage**:
```bash
# Setup Cloud Trace for local development
./scripts/setup-cloud-trace.sh my-project-id

# Setup with ADK CLI deployment
adk deploy agent_engine --project=my-project-id --trace_to_cloud ./agent
```

**Environment Variables**:
- `GOOGLE_CLOUD_PROJECT` - Project ID for Cloud Trace
- `GOOGLE_APPLICATION_CREDENTIALS` - Path to service account key

**Output**: Cloud Trace enabled, traces visible in console.cloud.google.com

### 2. Setup BigQuery Agent Analytics

**Script**: `scripts/setup-bigquery-analytics.sh <project-id> <dataset-id> [bucket-name]`

**Purpose**: Configures BigQuery Agent Analytics plugin for comprehensive event logging

**Parameters**:
- `project-id` - Google Cloud project ID (required)
- `dataset-id` - BigQuery dataset name (required)
- `bucket-name` - GCS bucket for multimodal content (optional)

**Usage**:
```bash
# Setup basic BigQuery analytics
./scripts/setup-bigque