Dec 3, 2025

Agent Observability Setup

Hyperfold Team

ObservabilityAgents

Metrics Setup

Configure observability for your agents:

# Enable metrics collection
$ hyperfold observability configure

> [Config] Setting up Cloud Monitoring...
> [Config] Creating metrics dashboards...
> [Config] Configuring log exports...

✓ Observability configured!

Metrics:     Cloud Monitoring
Logs:        Cloud Logging
Traces:      Cloud Trace
Dashboard:   https://console.hyperfold.io/dashboard

# View real-time metrics
$ hyperfold metrics agents

AGENT METRICS (24h)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

NEGOTIATOR: sales-bot-01
Sessions:          1,247
Conversions:       412 (33.0%)
Revenue:           $67,840
Response Time:     p50: 120ms  p95: 340ms
Error Rate:        0.3%

Custom Dashboards

Create dashboards for your specific needs:

# Create custom dashboard
$ hyperfold dashboard create --name="Sales Overview" \
--widgets='[
  {"type": "counter", "metric": "sessions_today"},
  {"type": "counter", "metric": "revenue_today"},
  {"type": "chart", "metric": "conversion_rate", "period": "7d"},
  {"type": "table", "metric": "top_products", "limit": 10}
]'

# Widget types:
# - counter: Single value with trend
# - chart: Time series visualization
# - table: Tabular data
# - gauge: Progress toward goal

Distributed Tracing

Trace requests across agents and services:

# View traces for a session
$ hyperfold traces get --session=sess_abc123

TRACE: sess_abc123
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[0ms] Session started
│   buyer: openai_gpt4_buyer
│
[45ms] ├─ ACP Search "waterproof running shoes"
│   │   products_found: 8
│   │   latency: 45ms
│
[890ms] ├─ ACP Quote prod_aero_x2 @ $120
│   │   └─ LLM Decision: counter_offer
│
[32000ms] └─ Session complete
          outcome: conversion

Alert Configuration

Set up proactive alerting:

# Configure alerts
$ hyperfold alerts create \
--name="High Error Rate" \
--condition="error_rate > 5%" \
--window="5m" \
--channels="slack:#alerts,email:ops@company.com"

> Alert created: alert_xyz123

# Available alert conditions:
# - error_rate > X%
# - response_time_p95 > Xms
# - conversion_rate < X%
# - revenue_24h < $X

# List active alerts
$ hyperfold alerts list

ACTIVE ALERTS

NAME                CONDITION              STATUS    LAST TRIGGERED
High Error Rate     error_rate > 5%        OK        Never
Slow Response       p95 > 500ms            OK        Dec 18, 14:30
Low Conversion      conversion < 20%       ALERT     Now

Incident Response

When alerts fire, use these commands:

# Acknowledge alert
$ hyperfold alerts ack alert_xyz123 --message="Investigating"

# View recent errors
$ hyperfold agents logs sales-bot-01 --level=error --last=1h

# Check for anomalies
$ hyperfold metrics anomalies --agent=sales-bot-01

# Quick rollback if needed
$ hyperfold agents rollback sales-bot-01 --to=previous