RxLogger Settings

RxLogger 6.0

Overview

RxLogger settings are configured through the RxLogger user interface or by pushing a configuration file to the device. All settings are stored in a single .json file that can be exported and mass-deployed to devices across an enterprise.

Settings Data Types

  • Integer - used to store numerical data such as the number of files to store. Allowable integers range from 0 - 2,147,483,647 (max int). For fields such as file size that do not allow a value of 0, a 1 is substituted at runtime. For integer fields, the UI accepts only numerical input.

  • String - used to store text such as file names and storage paths. The UI accepts any alphanumeric input and symbols as permitted by the file system.

  • Boolean - used to store true/false information such as to enable/disable a module; represented in the UI as a checkbox.

  • List - used to select one value from a list of pre-assigned values; represented in the UI as a group of radio buttons.

Settings GUI

To configure general log settings through the GUI:

  1. Tap the Settings button to display a list of configurable modules currently loaded by diagdaemon:
  2. Tap RxLogger Settings to display a list of general configurations.
  3. Enable/disable the desired settings:
       • Enable notifications - If enabled, RxLogger icon is seen in the notification bar when running. This is helpful to determine whether RxLogger is running in the background. By default, this option is enabled.
       • Enable debug logs - If enabled, the debug logs from RxLogger and Diagdaemon are collected in the location specified in the Settings File section. After enabling/disabling debug logs, tap the back button, tap Save and then reboot the device for the change to take into effect. By default, this option is disabled.
       • Enable internal sdcard only - If enabled, logs are saved to the internal SD card even when an external SD card is inserted into the device. By default, logs are saved tot he external SD card if present.


To configure module settings through the GUI:

  1. Tap the Settings button to display a list of configurable modules currently loaded by diagdaemon:
  2. Tap the module to be edited to display a list of its parameters:
  3. Edit settings as required. Tap the BACK button when done.
  4. Repeat Steps 2 and 3 until all modules are edited as desired.
  5. On the modules listing screen, tap SAVE to preserve all changes.

See the Modules page for settings information.

Settings File

All RxLogger settings are stored in a file on the device, permitting remote configuration and mass deployment of these files using an enterprise mobile management (EMM) system.

  • File name - config.json
  • Internal storage: /sdcard/RxLogger (if the external SD card is not present on the device or Enable internal sdcard only option is activated)
  • External storage (SD card): /storage/<UUID>/RxLogger, where <UUID> represents the UUID of the SD card (if the external SD card is present)

RxLogger settings can be configured through the RxLogger user interface (UI) or by editing the settings file.

Note:

  • Zebra recommends using the same config.json file across devices with the same Android platform version. Use of the same file across multiple Android platform versions may lead to unexpected behavior.
  • A config.json file from a WWAN device cannot be used interchangeably on a WLAN device, and vice versa. WWAN related modules, such as qxdm, are not available on WLAN devices and can result to unexpected behavior.

Configure via UI

To configure RxLogger settings via UI:

  1. Open RxLogger settings.
  2. Modify the desired configuration settings.
  3. Save the configuration. Config.json settings file is created and saved to either internal or external storage. RxLogger restarts to apply the new configuration settings.

This method ensures accuracy and minimizes the risk of errors that caan occur when manually editing values in config.json.

Configure via file

To manually configure RxLogger settings:

  1. Locate and retrieve the config.json settings file from either internal or external storage.

  2. Manually update the config.json file with the required changes, modifying only the values in the "Value" field; all other fields are pre-defined. For parameter values, refer to the Modules section. Zebra recommends viewing the file in JSON format for easier editing.

  3. Deploy the config.json file to the designated path in Step 1.

  4. Broadcast the Refresh Config Intent API to trigger RxLogger to restart and apply the new settings:

     com.symbol.dd.intent.action.REFRESH_CONFIG_ACTION

    Note: Starting with RxLogger v13.0.12.76, Refresh Config Intent API is discontinued. Instead, RxLogger will automatically refresh to implement changes whenever it detects an updated config file.