docs/newtmgr/command_list/newtmgr

newtmgr log

Manage logs on a device.

Usage:

    newtmgr log [command] -c <conn_profile> [flags]

Global Flags:

  -c, --conn string       connection profile to use
  -h, --help              help for newtmgr
  -l, --loglevel string   log level to use (default "info")
      --name string       name of target BLE device; overrides profile setting
  -t, --timeout float     timeout in seconds (partial seconds allowed) (default 10)
  -r, --tries int         total number of tries in case of timeout (default 1)

Description

The log command provides subcommands to manage logs on a device. Newtmgr uses the conn_profile connection profile to connect to the device.

Sub-command	Explanation
clear	The newtmgr log clear command clears the logs on a device.
level_list	The newtmgr level_list command shows the log levels on a device.
list	The newtmgr log list command shows the log names on a device.
module_list	The newtmgr log module_list command shows the log module names on a device.
show	The newtmgr log show command displays logs on a device. The command format is: newtmgr log show [log_name [min-index [min-timestamp]]] -c <conn_profile> The following optional parameters can be used to filter the logs to display: log_name: Name of log to display. If log_name is not specified, all logs are displayed.min-index: Minimum index of the log entries to display. This value is only valid when a log_name is specified. The value can be `last` or a number. If the value is `last`, only the last log entry is displayed. If the value is a number, log entries with an index equal to or higher than min-index are displayed.min-timestamp: Minimum timestamp of log entries to display. The value is only valid if min-index is specified and is not the value `last`. Only log entries with a timestamp equal to or later than min-timestamp are displayed. Log entries with a timestamp equal to min-timestamp are only displayed if the log entry index is equal to or higher than min-index.

Examples

Sub-command	Usage	Explanation
clear	newtmgr log clear -c profile01	Clears the logs on a device. Newtmgr connects to the device over a connection specified in the `profile01` connection profile.
level_list	newtmgr log level_list -c profile01	Shows the log levels on a device. Newtmgr connects to the device over a connection specified in the `profile01` connection profile.
list	newtmgr log list -c profile01	Shows the log names on a device. Newtmgr connects to the device over a connection specified in the `profile01` connection profile.
module_list	newtmgr log module_list -c profile01	Shows the log module names on a device. Newtmgr connects to the device over a connection specified in the `profile01` connection profile.
show	newtmgr log show -c profile01	Displays all logs on a device. Newtmgr connects to the device over a connection specified in the `profile01` connection profile.
show	newtmgr log show reboot_log -c profile01	Displays all log entries for the reboot_log on a device. Newtmgr connects to the device over a connection specified in the `profile01` connection profile.
show	newtmgr log show reboot_log last -c profile01	Displays the last entry from the reboot_log on a device. Newtmgr connects to the device over a connection specified in the `profile01` connection profile.
show	newtmgr log show reboot_log 2 -c profile01	Displays the reboot_log log entries with an index 2 and higher on a device. Newtmgr connects to the device over a connection specified in the `profile01` connection profile.
show	newtmgr log show reboot_log 5 123456 -c profile01	Displays the reboot_log log entries with a timestamp higher than 123456 and log entries with a timestamp equal to 123456 and an index equal to or higher than 5. Newtmgr connects to the device over a connection specified in the `profile01` connection profile.