Host and infrastructure monitoring for servers and containers.
# Install agent on your server
curl -fsSL https://get.brainzlab.ai/sentinel | bash
# View hosts in dashboard
open https://sentinel.brainzlab.ai/dashboarddocker pull brainzllc/sentinel:latest
docker run -d \
-p 3000:3000 \
-e DATABASE_URL=postgres://user:pass@host:5432/sentinel \
-e REDIS_URL=redis://host:6379/7 \
-e RAILS_MASTER_KEY=your-master-key \
brainzllc/sentinel:latestbin/setup
bin/rails serverInstall the lightweight Go agent on each host:
curl -fsSL https://get.brainzlab.ai/sentinel | bash
# or
wget -qO- https://get.brainzlab.ai/sentinel | bash| Variable | Description | Required |
|---|---|---|
DATABASE_URL |
PostgreSQL connection | Yes |
REDIS_URL |
Redis for real-time stats | Yes |
RAILS_MASTER_KEY |
Rails credentials | Yes |
BRAINZLAB_PLATFORM_URL |
Platform URL for auth | Yes |
- Backend: Rails 8 API + Dashboard
- Agent: Go binary (~10MB, minimal overhead)
- Database: PostgreSQL 16 with TimescaleDB
- Cache: Redis 7 (real-time stats, heartbeats)
- Frontend: Hotwire (Turbo + Stimulus) / Tailwind CSS
| Category | Metrics |
|---|---|
| CPU | Usage %, load average, per-core |
| Memory | Used, available, swap, cache |
| Disk | Space, I/O read/write per mount |
| Network | Bandwidth in/out, packets |
| Processes | Top processes by CPU/memory |
| Containers | Docker stats per container |
- ~10MB binary, minimal CPU/memory overhead
- Collects metrics every 10 seconds
- Auto-registers on first run
- Automatic reconnection
- Secure TLS communication
Set thresholds for:
- CPU usage > 90%
- Memory usage > 85%
- Disk usage > 90%
- Load average > CPU count
- Process memory leak detection
GET /api/v1/hosts- List hostsGET /api/v1/hosts/:id- Host detailsGET /api/v1/hosts/:id/metrics- Host metricsGET /api/v1/hosts/:id/processes- Process list
GET /api/v1/containers- List containersGET /api/v1/containers/:id/metrics- Container metrics
POST /internal/agent/report- Agent metric submission
| Tool | Description |
|---|---|
sentinel_hosts |
List all hosts with status |
sentinel_metrics |
Get metrics for a host |
sentinel_processes |
List top processes |
sentinel_containers |
List containers |
sentinel_alerts |
List host alerts |
Full documentation: docs.brainzlab.ai/products/sentinel
services:
sentinel:
image: brainzllc/sentinel:latest
ports:
- "3000:3000"
environment:
DATABASE_URL: postgres://user:pass@db:5432/sentinel
REDIS_URL: redis://redis:6379/7
RAILS_MASTER_KEY: ${RAILS_MASTER_KEY}
BRAINZLAB_PLATFORM_URL: http://platform:3000
depends_on:
- db
- redisbin/rails test
bin/rubocopSee CONTRIBUTING.md for development setup and contribution guidelines.
This project is licensed under the OSAaSy License.