Documentation

Everything you need to integrate and operate Stack.

Getting Started

Stack provides real-time infrastructure monitoring through lightweight agents deployed across your fleet. This guide covers installation, basic configuration, and your first health check.

Installation

Install the Stack agent on any Linux host with a single command:

# Download and install the agent
curl -sL https://get.stack.io/agent | sh

# Start the agent service
systemctl enable --now stack-agent

# Verify it's running
stack-agent status
→ Agent v2.4.1 running (pid 1842), connected to api.stack.io

Configuration

Agent configuration lives in /etc/stack/agent.yaml. The agent auto-discovers common services (nginx, PostgreSQL, Redis) and starts monitoring them immediately.

# /etc/stack/agent.yaml
api_key: "sk-..."
region: "us-east-1"
checks:
  - type: http
    target: https://api.example.com/health
    interval: 30s
  - type: tcp
    target: db-primary.internal:5432
    interval: 15s

API Authentication

All API requests require a Bearer token passed in the Authorization header. Generate tokens in the dashboard under Settings → API Keys.

# Example API request
curl "https://api.stack.io/v1/health" \
  -H "Authorization: Bearer sk-0a1b2c3d4e5f"

# Response
{
  "status": "healthy",
  "nodes": 19,
  "checks_passed": 472,
  "checks_failed": 0
}