Skip to main content

​
Signal

Signal is the unified alerting system for Brainz Lab. It monitors all your data sources, detects issues using configurable rules, and notifies your team through multiple channels.

​
Features

Alert Rules

Threshold, anomaly detection, absence detection, and composite rules

Multi-Source

Integrates with Flux, Pulse, Reflex, and Recall

Notification Channels

Slack, PagerDuty, Email, Webhook, Discord, Teams, Opsgenie

Incident Management

Automatic incident grouping with timeline tracking

Escalation Policies

Multi-step escalation with configurable delays

On-Call Schedules

Weekly and rotation-based scheduling

​
Quick Start

​
1. Create a Notification Channel

Set up where alerts should be sent: 
POST /api/v1/channels
{
  "channel": {
    "name": "ops-alerts",
    "channel_type": "slack",
    "config": {
      "webhook_url": "https://hooks.slack.com/...",
      "channel": "#ops"
    }
  }
}

​
2. Create an Alert Rule

Define what conditions trigger alerts: 
POST /api/v1/rules
{
  "rule": {
    "name": "High Error Rate",
    "source": "reflex",
    "source_name": "error_count",
    "rule_type": "threshold",
    "operator": "gt",
    "threshold": 100,
    "window": "5m",
    "severity": "critical",
    "notify_channels": ["<channel-uuid>"]
  }
}

​
3. Monitor Alerts

View and manage alerts in the dashboard or via API: 
GET /api/v1/alerts
POST /api/v1/alerts/:id/acknowledge

​
Data Sources

Signal can monitor data from all Brainz Lab products:
SourceWhat You Can Monitor
FluxCustom metrics and events
PulseResponse times, error rates, throughput
ReflexError counts, new error types
RecallLog patterns, error logs

​
Alert Rule Types

TypeDescriptionUse Case
ThresholdValue crosses a limitError rate > 100/min
AnomalyValue deviates from baselineUnusual traffic patterns
AbsenceNo data receivedService stopped reporting
CompositeMultiple conditions combinedHigh errors AND low traffic

​
Architecture

Signal
├── Alert Rules      # Define conditions for alerts
├── Alerts           # Active alert instances
├── Incidents        # Groups related alerts
├── Channels         # Notification destinations
├── Policies         # Escalation configurations
├── Schedules        # On-call rotations
└── Windows          # Maintenance periods

​
What’s Next?

Alert Rules

Create and manage alert rules

Channels

Configure notification channels

Incidents

Manage and resolve incidents

Schedules

Set up on-call rotations