Configuring Logging for External Object Type Connectors

  • This is an advanced feature for advanced users only.
  • Logging is only available for some External Object Type connectors. Check your connector documentation to see if logging is available for it.
  • To use logging, you must first configure an External Object Type connection. For instructions, see Connections to External Databases for Object Types.
  • In production environments, it is recommended that logging is disabled or set to only log errors and enabled temporarily to diagnose specific issues.

Administrators and developers can enable logging to help diagnose connector behavior and common issues. You can configure logging to include only warnings and errors, and some connectors let you include more details. For example, exact queries that are run against the external database.

To configure logging for an External Object Type connector:

  1. In M-Files Admin, go to Document vaults > A vault > Configurations > External Repositories
  2. Click your connector with the secondary mouse button and select Show Application Diagnostics from the list.
    Result:A new diagnostics section appears.
  3. Go to Diagnostics > Logging and open the Configuration tab.
  4. Set Enabled to Yes.
  5. Set at least one of the target categories.
    Default Target saves the log files in the vault's temporary folder. For more information about specific settings, click the information icon next to the setting ().
  6. Set the Default Log Level.
    Trace level logs the all possible events while Fatal logs only critical errors.
  7. Click Save.
Logging is now configured, and log files will start accumulating into your target folder.

Downloading log files

To download the log files as a compressed .zip file:

  1. In the left-hand pane, click Logging with the secondary mouse button.
  2. Select Download Logs from the list.
    Result:Download Log Files window opens.
  3. Select the files you want to download.
  4. Click Download.
  5. Select a location for the .zip file.
  6. Click Save.