Skip to main content

​
Beacon

Beacon is an uptime monitoring service that watches your endpoints, APIs, and services from multiple global locations. Get instant alerts when something goes down.

​
Features

Multi-Region Checks

Monitor from NYC, London, Singapore, and more

Multiple Protocols

HTTP, SSL, DNS, and TCP monitoring

Instant Alerts

Get notified via Signal, Slack, PagerDuty

Status Pages

Public status pages for your users

​
Quick Start

# Create a monitor via SDK
BrainzLab::Beacon.create_monitor(
  name: "Production API",
  url: "https://api.example.com/health",
  check_interval: 60,
  regions: [:nyc, :london, :singapore]
)

# Check current status
status = BrainzLab::Beacon.status("production-api")
puts status.up? # => true
puts status.response_time # => 145 (ms)

​
Check Types

TypeWhat It Monitors
httpStatus codes, response time, body content
sslCertificate expiry, validity, chain
dnsResolution, propagation, record values
tcpPort connectivity, response time

​
How It Works

Your Service
    │
    ├── NYC Checker ─────┐
    ├── London Checker ──┼── Beacon ── Alert if down
    └── Singapore Checker┘
Beacon checks your endpoints from multiple global locations every 30-300 seconds. If a check fails from multiple regions, an incident is created and you’re alerted immediately.

​
Automatic Features

  • SSL Expiry Warnings - Get notified 30/14/7 days before expiry
  • Performance Tracking - Historical response time charts
  • Incident Timeline - Full history of downtime events
  • Maintenance Windows - Suppress alerts during planned maintenance

​
Next Steps

Monitors

Configure uptime monitors

Incidents

Handle and track incidents

Status Pages

Create public status pages

API Reference

Beacon API endpoints