Docs

Agent Installation

Install the optional dbaBrain agent for deep OS-level visibility.

When to Use the Agent

The agent is optional. Use it when you need:

  • -OS metrics (CPU, memory, disk, network) from the database server
  • -Crontab discovery and monitoring
  • -Local PostgreSQL log file analysis
  • -postgresql.conf and pg_hba.conf change detection
  • -Your database is behind a firewall/VPN (agent makes outbound HTTPS only)

Installation

bash
# One-line install
curl -sSL https://install.dbabrain.ai | sh

# Or with specific options
curl -sSL https://install.dbabrain.ai | sh -s -- \
  --api-key YOUR_API_KEY \
  --database-id db_abc123

System Requirements

  • -Linux (x86_64 or arm64), macOS (Intel or Apple Silicon)
  • -Less than 1% CPU usage, under 50MB RAM
  • -Outbound HTTPS (port 443) to api.dbabrain.ai
  • -No inbound ports required

Verify Installation

bash
# Check agent status
dbabrain-agent status

# View agent logs
journalctl -u dbabrain-agent -f