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.