Skip to content

devlanes is in beta and not ready for production use.Report an issue

devlanes debug

devlanes debug [OPTIONS] <COMMAND>

Explain why a unit is not running or not ready, with a fix for each reason.

devlanes debug why [OPTIONS] [UNIT]
  • [UNIT]: Unit to explain ([lane:]unit, such as api or 2:web) [default: pick from a list].

List failed units, crash counts, recent error lines and port conflicts.

devlanes debug errors [OPTIONS]
  • --since <DURATION>: Count crashes and error lines from this long ago, such as 5m or 2h [default: all recorded runs].

Print the daemon’s event stream: lane, unit, task and port events.

devlanes debug events [OPTIONS]
  • -f, --follow: Keep streaming until interrupted [default: print recent events].

Show CPU and memory of the running units and containers of the current project, or of every project outside one.

devlanes debug top [OPTIONS]

Freeze this lane’s processes and own containers now, as if it had been idle for lanes.freeze_after.

devlanes debug freeze [OPTIONS] [LANE]
  • [LANE]: Lane to freeze ([project@]lane) [default: the current lane].

Resume a throttled or frozen lane.

devlanes debug thaw [OPTIONS] [LANE]
  • [LANE]: Lane to thaw ([project@]lane) [default: the current lane].

Print the lane’s project config as YAML after merging its files and templates; expressions stay unevaluated.

devlanes debug config [OPTIONS]

Write a redacted archive to attach to a bug report and print its path.

The archive holds the client and daemon versions, doctor, config check and status as JSON, the last lines of the daemon’s log and, with – ARGS, the output of devlanes -vv ARGS. Values of secret-looking variables, URL passwords and the home directory are replaced before anything is written; read the files before sending them anyway.

devlanes debug bundle [OPTIONS] [-- <ARGS>...]
  • --to <PATH>: Write the archive here [default: devlanes-debug-<time>.tar.gz in the temporary directory].
  • --log-lines <N>: Lines of the daemon’s log to include.
    • Default: 500.
  • [ARGS]...: devlanes arguments to run again with -vv and include, such as: – start api.
Examples:
devlanes debug bundle
devlanes debug bundle --to bug.tar.gz -- start api

Every command also takes the global options.