Hyperfold AI
Back

Dec 3, 2025

Agent Observability Setup

H
Hyperfold Team
ObservabilityAgents

Metrics Setup

Configure observability for your agents:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 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:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 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:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 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:

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 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:

bash
1
2
3
4
5
6
7
8
9
10
11
# 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