Skip to main content

log commands

Log commands manage logs generated by tester ports.

log read​

log read command reads a log file from target ports.

Usage​

log read [options] <target> <taskId> <fileName>

Arguments​

  • target: selects a port or ports using a port's name or a tag.
    • all can be used to select all ports.
  • taskId: task ID of the task to which the log file belongs.
  • fileName: log file name to read.

Options​

  • -n, --lines <lines>: set number of lines to be returned
  • --throwOnError: throw error on failure

log dump​

log dump command dumps logs from target ports.

Usage​

log dump [options] <target> [taskId]

Arguments​

  • target: selects a port or ports using a port's name or a tag.
    • all can be used to select all ports.
  • taskId: task ID of the task to which the log file belongs.

Options​

  • -n, --include <incFile...>: include only files that satisfy regex or name
  • -x, --exclude <excFile...>: exclude files that satisfy regrex or name
  • -r, --retry <num>: retry num times if the dump fails
  • --throwOnError: throw error on failure

log list​

log list command lists log files from target ports.

Usage​

log list [options] <target>

Arguments​

  • target: selects a port or ports using a port's name or a tag.
    • all can be used to select all ports.

Options​

  • --throwOnError: throw error on failure

log monitor​

log monitor command tails a log file from a target port.

Usage​

log monitor [options] <target> <dirName> <fileName>

Arguments​

  • target: selects a port or ports using a port's name or a tag.
    • all can be used to select all ports.
  • dirName: task folder of the log file.
  • fileName: log file name to monitor.

Options​

  • --throwOnError: throw error on failure