Hyperfold AI

Alerting

Set up proactive alerts for business and technical metrics.

Overview

Alerting notifies you when metrics exceed thresholds—before issues impact customers. Configure alerts for error rates, revenue drops, slow responses, and any metric Hyperfold tracks.

Alerts integrate with your existing tools: Slack, PagerDuty, email, and custom webhooks.

Creating Alerts

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
27
28
29
# Create an alert
$ hyperfold alerts create \
  --name="High Error Rate" \
  --condition="error_rate > 5%" \
  --window="5m" \
  --channels="slack:#alerts,email:ops@company.com"
 
Alert created:
  ID:              alert_err_001
  Name:            High Error Rate
  Condition:       error_rate > 5% over 5 minutes
  Channels:        Slack (#alerts), Email (ops@company.com)
  Status:          active
 
# Create revenue drop alert
$ hyperfold alerts create \
  --name="Revenue Drop" \
  --condition="revenue.hourly < revenue.hourly.avg_7d * 0.7" \
  --window="1h" \
  --severity=critical \
  --channels="pagerduty,slack:#critical"
 
# Create conversion rate alert
$ hyperfold alerts create \
  --name="Low Conversion" \
  --condition="conversion_rate < 0.20" \
  --window="1h" \
  --cooldown="30m" \
  --channels="slack:#sales"

Alert Options

OptionDescription
--conditionMetric condition to evaluate
--windowTime window for evaluation
--severityinfo, warning, critical
--cooldownMinimum time between alerts
--channelsWhere to send notifications

Alert Conditions

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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
# Available alert conditions
 
METRICS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
PERFORMANCE
  error_rate              Error percentage (0-100)
  response_time_p50       Median response time (ms)
  response_time_p95       95th percentile response time
  response_time_p99       99th percentile response time
  throughput              Requests per second
 
BUSINESS
  revenue.hourly          Revenue in last hour
  revenue.daily           Revenue today
  conversion_rate         Sessions → conversions (0-1)
  avg_order_value         Average order value
  discount_rate           Average discount given
 
AGENTS
  agent.sessions          Active sessions
  agent.errors            Error count
  agent.latency           Processing latency
  agent.llm_tokens        Token usage
 
INVENTORY
  inventory.low_stock     Products below threshold
  inventory.out_of_stock  Products with zero inventory
 
INTEGRATIONS
  integration.sync_errors Sync failure count
  integration.latency     API response time
 
# Condition operators
  >   Greater than
  <   Less than
  >=  Greater than or equal
  <=  Less than or equal
  ==  Equal to
  !=  Not equal to
 
# Aggregation functions
  avg()     Average over window
  sum()     Sum over window
  min()     Minimum in window
  max()     Maximum in window
  count()   Count in window
  rate()    Rate of change
 
# Examples
$ hyperfold alerts create \
  --name="Slow Response" \
  --condition="response_time_p95 > 500"
 
$ hyperfold alerts create \
  --name="Token Spike" \
  --condition="rate(agent.llm_tokens) > 1000"
 
$ hyperfold alerts create \
  --name="Daily Revenue Target" \
  --condition="revenue.daily < 10000" \
  --schedule="0 18 * * *"  # Check at 6 PM daily

Notification Channels

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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# Configure notification channels
$ hyperfold alerts channels list
 
NOTIFICATION CHANNELS
 
CHANNEL         TYPE        STATUS     CONFIGURED
slack           chat        active     #alerts, #critical
email           email       active     ops@company.com
pagerduty       oncall      active     service_id_xxx
webhook         http        active     https://hooks.example.com/alert
 
# Add Slack channel
$ hyperfold alerts channels add slack \
  --webhook-url="https://hooks.slack.com/services/xxx" \
  --default-channel="#alerts"
 
# Add PagerDuty
$ hyperfold alerts channels add pagerduty \
  --integration-key="xxx" \
  --service-id="P123ABC"
 
# Add custom webhook
$ hyperfold alerts channels add webhook \
  --name="custom-alerts" \
  --url="https://hooks.example.com/hyperfold" \
  --headers='{"Authorization": "Bearer xxx"}'
 
# Webhook payload format
{
  "alert_id": "alert_err_001",
  "alert_name": "High Error Rate",
  "status": "firing",
  "severity": "warning",
  "condition": "error_rate > 5%",
  "current_value": 7.2,
  "threshold": 5,
  "window": "5m",
  "fired_at": "2025-01-20T10:15:00Z",
  "message": "Error rate is 7.2%, exceeding threshold of 5%",
  "dashboard_url": "https://console.hyperfold.io/alerts/alert_err_001"
}

Channel Types

ChannelBest For
SlackTeam visibility, non-urgent alerts
EmailAsync notification, audit trail
PagerDutyCritical alerts, on-call escalation
WebhookCustom integrations, automation

Management

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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# List all alerts
$ hyperfold alerts list
 
ALERTS
 
NAME                CONDITION                    STATUS     LAST TRIGGERED
High Error Rate     error_rate > 5%              OK         Never
Revenue Drop        revenue < 70% of avg         OK         Jan 18, 14:30
Low Conversion      conversion_rate < 20%        ALERT      Now
Slow Response       response_time_p95 > 500ms    OK         Jan 15, 09:00
Inventory Low       low_stock_count > 50         WARNING    Jan 19, 11:00
 
# View alert details
$ hyperfold alerts show "High Error Rate"
 
ALERT: High Error Rate
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
ID:                 alert_err_001
Status:             OK
Severity:           warning
Condition:          error_rate > 5%
Window:             5 minutes
Cooldown:           15 minutes
 
CHANNELS
  Slack:            #alerts
  Email:            ops@company.com
 
CURRENT VALUES
  error_rate:       2.1%
  threshold:        5%
 
HISTORY (30 days)
  Triggered:        3 times
  Avg Duration:     8 minutes
  Last:             Jan 18, 14:30
 
# Acknowledge an alert
$ hyperfold alerts ack "Low Conversion" \
  --message="Investigating - appears related to checkout bug"
 
Alert acknowledged:
  By:               ops@company.com
  Message:          Investigating - appears related to checkout bug
  Next reminder:    30 minutes
 
# Silence an alert temporarily
$ hyperfold alerts silence "High Error Rate" \
  --duration="2h" \
  --reason="Scheduled maintenance"
 
Alert silenced for 2 hours
Silence expires: 2025-01-20T12:15:00Z
 
# Delete an alert
$ hyperfold alerts delete "Old Alert" --confirm
Monitor overall system health with Observability.