Skip to main content
View your app’s runtime logs from the terminal. Filter by severity, time range, or errors only. Stream in real-time. Get structured JSON output for automated debugging.

​
View logs

floo logs --app my-app
Shows the last 100 log lines with timestamps and severity.

​
Filter by count

floo logs --app my-app --tail 20

​
Filter by time

floo logs --app my-app --since 1h      # Last hour
floo logs --app my-app --since 30m     # Last 30 minutes
floo logs --app my-app --since 2d      # Last 2 days
Accepts m (minutes), h (hours), d (days), or an ISO 8601 timestamp.

​
Filter errors only

floo logs --app my-app --error
Shorthand for --severity ERROR. Shows only error-level and above.

​
Filter by severity

floo logs --app my-app --severity WARNING
Severity levels: DEBUG, INFO, WARNING, ERROR, CRITICAL. Shows the specified level and above.

​
Filter by service

floo logs --app my-app --services api
Filter logs to a specific service in multi-service apps.

​
Search log text

floo logs --app my-app --search "timeout"
Case-insensitive text search across log messages.

​
Stream in real-time

floo logs --app my-app --live
Polls every 2 seconds for new log entries. Cannot combine with --output.

​
Write to file

floo logs --app my-app --output logs.txt
floo logs --app my-app --output logs.json --json

​
Log retention

Logs are retained for 7 days.

​
For agents

This is where floo shines for agents. Get structured logs that can be parsed and acted on: 
floo logs --app my-app --error --json 2>/dev/null | jq '.data.logs'

{
  "success": true,
  "data": {
    "app_name": "my-app",
    "logs": [
      {
        "timestamp": "2026-02-18T10:30:00Z",
        "severity": "ERROR",
        "message": "Connection refused: postgres://..."
      }
    ]
  }
}
An agent can read the error, set the correct DATABASE_URL, and redeploy — all without human intervention: 
floo logs --app my-app --error --json 2>/dev/null | jq '.data.logs[0].message'
# → "Connection refused: postgres://..."

floo env set DATABASE_URL=postgres://correct-url --app my-app --json
floo deploy --app my-app --json