Skip to main content

​
Sentinel

Sentinel monitors your servers, containers, and infrastructure. Get real-time visibility into CPU, memory, disk, and network usage across your entire fleet.

​
Features

Host Monitoring

CPU, memory, disk, network metrics

Container Monitoring

Docker container stats and health

Process Tracking

Top processes by resource usage

Lightweight Agent

10MB Go agent with minimal overhead

​
Quick Start

Install the Sentinel agent on your servers: 
# Download and install
curl -fsSL https://get.brainzlab.ai/sentinel | bash

# Configure with your project key
sentinel configure --key YOUR_PROJECT_KEY

# Start the agent
sentinel start

​
What Gets Monitored

CategoryMetrics
CPUUsage %, load average, per-core stats
MemoryUsed, available, swap, cache, buffers
DiskSpace per mount, I/O read/write, IOPS
NetworkBandwidth in/out, packets, errors
ProcessesTop processes by CPU/memory
ContainersDocker stats per container

​
Dashboard Overview

┌─────────────────────────────────────────────────────┐
│  Hosts: 5 healthy, 1 warning                        │
├─────────────────────────────────────────────────────┤
│  web-1   CPU: 45%  MEM: 68%  DISK: 52%  ● healthy  │
│  web-2   CPU: 38%  MEM: 72%  DISK: 51%  ● healthy  │
│  api-1   CPU: 62%  MEM: 85%  DISK: 48%  ● warning  │
│  worker  CPU: 28%  MEM: 45%  DISK: 33%  ● healthy  │
│  db-1    CPU: 15%  MEM: 92%  DISK: 67%  ● healthy  │
└─────────────────────────────────────────────────────┘

​
Agent

The Sentinel agent is a lightweight Go binary:
  • ~10MB compiled size
  • < 1% CPU overhead
  • < 20MB RAM usage
  • 10 second collection interval
  • Auto-updates with zero downtime

​
Alerts

Set up alerts for infrastructure issues: 
BrainzLab::Sentinel.alert_on(
  host: "api-1",
  metric: :memory,
  threshold: 90,
  channel: :pagerduty
)

​
Next Steps

Hosts

Monitor server health

Containers

Track Docker containers

Agent

Install and configure the agent

Alerts

Set up infrastructure alerts