collate
Collect logs from the system and all connected secondary devices (e.g. controllers), including ecosystem application logs from apps running on the system/secondaries, and collate them into a single gzipped tarball file written to a system-determined path.
The log package file will be automatically removed from the file system ~10 minutes after it is created, or upon system reboot.
This API is only available from the PRIMARY device and will throw exception if called from CONTROLLER. Use getDeviceType to know the type device.
See #prepareSystemLogs(String, long, boolean) for similar functionality with more options, including the ability to call on a DeviceType.CONTROLLER.
Return
The full path and filename of the log file package; null if the log file package could not be successfully created.