Support report overview
Generating a Support Report
Support reports provide a snapshot of a device's current settings and connection status at the time of the report's generation. The relevant log files are packaged into a .bin file that can be downloaded from the local (web) UI. For more information about generating support reports, see Generate a support report.
Note Information logged on the device will be erased when the device is powered off or rebooted to avoid unnecessary wear to the flash memory. See Configure options for the event and system logs for more information on how to enable persistent system logs.
Use 7-Zip or any other file-archiving utility to extract a support report. Its contents are organized into the following directories:
/etc
This folder most notably contains a running list of the cellular connections that have been registered by the device's radio.
Directory | Filename | Notes |
---|---|---|
/etc | version | Active firmware version |
/etc/config | mn.json | Cellular connections logged as having been engaged by the radio; establishes previous APN associations |
/opt
Information stored here persists between reboots and system resets.
Directory | Filename | Notes |
---|---|---|
/opt/log_last | messages | With persistent system logs enabled, syslog info will be stored in the /opt directory which isn't erased after reboots or system resets |
/tmp
Output from a series of diagnostic queries is stored in a randomly generated sub-directory within /tmp. When combing through these logs, pay particular attention to config_dump-public (to verify local device settings) and mmcli-dump (to validate the cellular connection status).
Directory | Filename | Notes |
---|---|---|
/tmp/#* | *# is generated at random | |
arp_-nv | The table of IP-address to MAC-address translations used by the address resolution protocol (ARP) | |
arptables_-nvv_-L | The tables of ARP packet filter rules in the Linux kernel | |
cat_procmeminfo | A breakdown of memory utilization at the time when the support report was generated | |
config_dump-public | The device's current settings, scrubbed of passwords and preshared keys | |
conntrack_-L | A list of all currently tracked connections through the system | |
conntrack_-S | A summary of currently tracked connections | |
date | Local system time. If the device isn't online when the support report is generated, the date will be based on the date/month/year that the firmware running on the device was created (e.g. 18.4.54.41 was created 2018-07-05) | |
df_-h | A report of the file system disk space usage | |
event_list | A list of events leveraged for syslog messages | |
fw_printenv | The entire environment for the bootloader U-Boot | |
ip_addr_list | IP addresses listed per interface | |
ip_route_list | Default routing information per interface | |
ip6tables_-nv_-L | A list of IPv6 routing tables | |
ip6tables_-nv_-L_-t_mangle | Firewall table used when handling mangled/fragmented IPv6 packets | |
ip6tables_-nv_-L_-t_nat | Firewall table used to direct NAT'd traffic | |
iptables_-nv_-L | A list of IPv4 firewall tables | |
iptables_-nv_-L_-t_mangle | Firewall table used when handling mangled/fragmented IPv4 packets | |
iptables_-nv_-L_-t_nat | Firewall table used to direct NAT'd traffic | |
s_-RlhA_etcconfig | An index of items in /etc/config (and its sub-directories) | |
ls_-RlhA_opt | An index of items in /opt (and its sub-directories) | |
ls_-RlhA_tmp | An index of items in /tmp (and its sub-directories) | |
ls_-RlhA_var | An index of items in /var (and its sub-directories) | |
mmcli-dump | A repository of critical information about the cellular radio based off of the cited modem-manager output and defined set of AT commands | |
netstat_-i | Interface statistics for transmitted/ received packets | |
netstat_-na | List of both listening and non-listening network sockets on the device | |
ps_l | A snapshot of the current processes running at the time of generating the report | |
runt_json | Storage for active/ engaged system variables | |
sprite_config_dump | Not used for cellular devices | |
ubus-dump | A log of ubus calls for network devices and interfaces | |
uptime | The device's uptime at the time of generating the report, along with CPU load averages for the past 1, 5, and 15 minutes |
/var/log
The running system log is stored in "messages" until reaching a set line count (1,000 lines by default). Once this limit is exceeded, that file is renamed to "messages.0" and a new running log is written to the now-empty "messages" log.
Directory | Filename | Notes |
---|---|---|
/var/log | messages | Current syslog information |
messages.0 | Rollover syslog information |
/var/run
This directory can be disregarded for most troubleshooting/ diagnostic purposes.
Directory | Filename | Notes |
---|---|---|
/var/run | all files | Runtime settings for the device -- referenced in the syslog data gathered in /tmp (see above) |