The following section describes how to enable, view, and share log files.

Two types of logs can be collected:

  • Internal logs collect information about a user's interactions within the iManage Work Mobility app.
  • External logs (called a Sysdiagnose file) collect system-level information about Apple iOS devices, including iManage Work Mobility's external interactions.

Internal logs

iManage Work 10 Mobility can collect logs based on the specific actions the user has taken while using the app.

For any authentication issues, iManage Work Mobility produces a Share Diagnostic File alert. In the alert, the user can choose to share or mail the report.

Figure: Share Diagnostic File alert

 

When encountering an issue within the app, tap Settings, then one of the following options:

  • Tap View Log File to open the the log file for viewing. Tap the Share  icon to share the file.

  • Tap Share Diagnostic File to send the log file to another app.
  • Tap Mail Diagnostic File to open an email and attach the log file to the email.

TIP:

The Mail Diagnostic File option is available only if the user has the Mail app configured and the app allows it.


External logs

The following instructions describe how to enable external iOS logs (Sysdiagnose). See the Apple iOS developer documentation for more details.

Enable external logging

  1. To trigger the Sysdiagnose log file, simultaneously press and release both Volume buttons and the Power (side or top) button.


    NOTE:

    Make sure to add the date and time when this issue occurred to the bug report.


    The Sysdiagnose is triggered when you release the buttons.

    TIP:

    If you are using an iPhone, it briefly vibrates when the Sysdiagnose is successfully triggered.

  2. Allow some time (about 10 minutes) for the diagnostics to complete the information gathering.

  3. Sync the mobile device with iTunes on your host computer, or AirDrop the file to your Mac computer.

  4. Use the Log Location instructions below to generate and attach the file to your bug report.


    IMPORTANT:

    Make sure the user(s) provides the name(s) of the affected application(s) in the bug report.

    We also recommend that the Sysdiagnose be triggered as soon as the sign in issue occurs, even if the logs are synced later.

Sharing the log file

Please retrieve a log file called Sysdiagnose from the user's iOS mobile device by sharing the following instructions:

  1. Tap to open Settings.

  2. Tap Privacy > Analytics, and select Analytics Data.
    Various system log files are listed.

  3. Tap Sysdiagnose to view the logs, and tap to share the file.
    If you have multiple Sysdiagnose files listed, scroll down to the file with the current date, and share it.

    TIP:

    You can ask user(s) to Airdrop the Sysdiagnose file from their mobile device to a Mac device. When the transfer completes (can take several minutes), the file is located at:

    /Users/[Your Username]/Downloads folder.

    The file name is in the format:

    sysdiagnose_YYYY.MM.DD_HH-MM-SS-XX

Parsing the log file

  1. Unzip the Sysdiagnose_*.zip file.
  2. Open system_logs.logarchive from the unzipped contents.
    A searchable Console tool appears.
  3. Search using Process = "volter".
    For network issues, search for the iManage Work URL. For example: test.imanage.com.