Troubleshooting Microsoft Office 365 Errors

Learn how to troubleshoot common errors that may be encountered when ingesting from Microsoft Office 365.

This topic provides details for troubleshooting known errors that result in inaccessible items (mime-type:"filesystem/inaccessible“) that may be encountered when processing data.

ERROR
com.nuix.data.util.RetryCallable - Final retry attempt number 10 failed
  • Description: The request to retrieve data from Office 365 has failed. This error is likely to occur after a connection has been throttled and the maximum number of retries has been reached.
  • Impact: Data will be missing from the evidence set.
  • Resolution: Retry the ingestion once the connection is no longer being throttled.
  • Important: To reduce the potential for data loss resulting from connection throttling, it is recommended to not use more than four workers when ingesting data from Office 365.

To try and prevent future failures of this type, the following system properties can also be configured at startup:

  • Increase the default (10) maximum retry count:
    nuix.data.msgraph.retries=10
  • Increase the default (1 second) retry delay:
    nuix.data.msgraph.retryDelay=1
  • Increase the default (5 seconds) retry delay increment:
    nuix.data.msgraph.retryDelayIncrement=5

Errors
com.nuix.data.network.microsoftgraph.client.exception.MsGraphMailboxItemMissingException: The user mailbox does not contain the requested item. Missing id: ArchiveMsgFolderRoot
com.nuix.data.network.microsoftgraph.client.exception.MsGraphMailboxItemMissingException: The user mailbox does not contain the requested item. Missing id: ArchiveRecoverableItemsRoot
  • Description: A request was made to retrieve a mailbox that does not exist for a user. For example: Requesting to ingest archived mailboxes from a user with no archives.
  • Impact: Result set includes Inaccessible Items.

Error
MsGraphApiException: Failed to retrieve data from Microsoft Graph API: Access is denied. Check credentials and try again.
  • Description: Indicates that an error with code “ErrorAccessDenied” was returned from the Microsoft Graph API for this request.
  • Impact: Data is inaccessible, potentially due to a missing application permission or invalid credentials.
  • Resolution: Verify that the credentials being used are correct and review Applying Permissions to the Application to ensure that all required permissions are applied within your Azure tenant.

Error
RuntimeException: REST API is not yet supported for this mailbox.
  • Description: Indicates that the user associated with a particular mailbox has not been issued a license.

Error
java.net.SocketException: Connection reset by peer: socket write error.
  • Description: Indicates that long-lived connections are being closed, potentially due to firewall configurations.

  • Impact: Attachments are missing when retrieving Teams messages.

  • Resolution: Set the following system property at startup to allow the embedded Apache HTTPClient to accept additional Java system properties, such as proxy settings.

    nuix.data.msgraph.http.use-system-props=true

    See HttpClientConfiguration for details on configuring the Apache HTTPClient.