docs

ix

ix logs

View captured output from a VM

Usage: ix logs [OPTIONS] <VM>

View captured output from a VM.

Logs are the recorded streams ix collects around a VM so you can answer "what already happened?" without attaching to the machine. The default workload stream is stdout and stderr from the workload. Other streams separate kernel messages, guest diagnostics, and ix platform events so you can look at the right layer first.

Use ix logs VM -n 100 for recent history, ix logs VM --follow while a workload is running, and ix console VM instead when the program needs live terminal input.

arguments

  • <VM> VM name from ix ls

options

  • --stream <STREAM> Which recorded stream to read. Use workload for application stdout and stderr, kernel for guest kernel messages, diagnostic for ix guest-side health reports, and platform for ix lifecycle events around the VM one of: workload, kernel, diagnostic, platform default: workload
  • -n, --lines <LINES> Number of recent lines to show. Use this for a quick tail instead of opening the full retained log history
  • --since <SINCE> Only show entries newer than this duration, such as 5m or 1h. Use this to focus on the window around a deploy, restart, or failure
  • --filter <PATTERN> Only show entries whose message contains this substring (case sensitive). Applies to both a recent tail and --follow, so you can watch just the lines that mention a request id, route, or keyword
  • -f, --follow <FOLLOW> Keep reading new entries as they arrive. Use this while reproducing a problem or watching startup default: false
  • --message-format <MESSAGE_FORMAT> Error format one of: human, short, json default: human