Logs

Lizard captures runtime logs, build logs, and the log tail around restarts. Stream them live in your terminal or browse them in the dashboard.

Lizard collects runtime logs while a log stream is open (lizard logs or the dashboard Logs page, plus 60 seconds after it closes), around deploys and restarts, and while a service is crash-looping. Opening a stream fills in the last 500 lines per replica.

Runtime logs

lizard logs                       # last 200 runtime lines, then live tail
lizard logs --service api         # a specific service
lizard logs --tail 1000           # print the last 1000 lines and exit (max 1000)
lizard logs --level error         # filter by level

Behavior with `--json`

lizard logs --json returns the last 200 lines (override with --tail N, max 1000) and exits. Use it for snapshots and scripting. A snapshot taken while nobody was streaming can miss recent lines; open a stream first if you need them. Stream live only without --json when you want an interactive tail.

Build logs

lizard logs --build               # the most recent build's logs

This is the first thing to check when a deploy fails: read it, fix the cause, then lizard redeploy. See Build Pipeline.

Restart / crash logs

When a replica crashes or restarts, grab the surrounding log tail:

lizard logs --restart latest      # the most recent restart
lizard logs --restart <id>        # a specific restart
lizard logs --restarts            # list recent restarts

Paging through history

lizard service logs supports paging older windows:

lizard service logs --service api --tail all     # last 2,000 lines (no follow)
lizard service logs --service api --page 2       # older window (implies --tail 200)

Dashboard

The dashboard (lizard open) streams runtime and build logs with search and level filters. Open a service and click a deploy in its history to see that deploy’s build output.