Health

---

fleet health

Run health checks for one or all registered apps. Checks cover systemd unit state, container running status, and an optional HTTP endpoint.

Usage

fleet health [app] [--json]

Arguments

Argument	Required	Description
app	No	App name. Omit to check all apps.

Flags

Flag	Description
--json	Output raw JSON

Examples

Check all apps:

$ fleet health
Health Check

APP      SYSTEMD         CONTAINERS   HTTP       OVERALL
myapp    ✓ active        2/2          ✓ 200      ✓ healthy
api      ✓ active        1/1          ✓ 200      ✓ healthy
worker   ✗ failed        0/1          -          ✗ down

Check a single app:

$ fleet health myapp
Health: myapp
  Systemd:    ✓ active
  Container:  ✓ myapp-web-1 (healthy)
  Container:  ✓ myapp-db-1 (none)
  HTTP:       ✓ 200
  Overall:    healthy

JSON output:

$ fleet health myapp --json
{
  "app": "myapp",
  "systemd": { "ok": true, "state": "active" },
  "containers": [
    { "name": "myapp-web-1", "running": true, "health": "healthy" }
  ],
  "http": { "ok": true, "status": 200 },
  "overall": "healthy"
}

HTTP health checks

An HTTP check is only performed if healthPath is set on the app’s registry entry. To add it, use fleet_register from MCP or edit data/registry.json directly, setting healthPath to a path like /healthz.

Related

• MCP tool: fleet_health

---

fleet logs

Stream or print container logs for a registered app.

Usage

fleet logs <app> [-f] [-n <lines>]

Arguments

Argument	Required	Description
app	Yes	App name

Flags

Flag	Description
-f, --follow	Follow log output (stream in real time)
-n <lines>	Number of log lines to show (default: 100)

Examples

$ fleet logs myapp
[last 100 lines of container logs]

$ fleet logs myapp -f
[streaming logs...]

$ fleet logs myapp -n 50
[last 50 lines]

Related

• MCP tool: fleet_logs