Skip to main content

Troubleshooting

This page describes how to set up logs.

Setting up logs​

Dataverse Integration stores in the logs some information about received and transmitted data, logical handlers, and so on. Thus, you can easily get data and analyze it.

Log Storage​

By default, collected data is stored in log files. You can change it to use database as a storage by enabling the ICDS_DB_LOGS option in the Advanced settings.

warning

By enabling this feature, the logs will fill up your database very quickly. Therefore, use it only for troubleshooting purposes. For example, when your hosting has some restrictions on writing files.

QM support​

Dataverse Integration supports the QueryMonitor plugin. So you can control this feature by toggling the ICDS_QM_LOGS option in the Advanced settings.

When this feature is enabled, Dataverse Integration logs will be duplicated in QueryMonitor.

Reading logs​

Some recent logs are displayed on the Status tab in the plugin's admin area. You can view them by clicking on the Show recent logs link.

For a more detailed analysis, you can download the logs by clicking Download Logs.

You can delete saved logs by clicking Remove logs.

Advanced settings`​

To configure advanced settings, navigate to the Dataverse Admin Area and open the Settings tab. At the bottom of the page, you will find Advanced settings.

Here are some of the key flags:

  • ICDS_ADVANCED_USER_BINDING - If set to true, the legacy advanced editor will be used to configure user binding. You can see changes in Bindings -> User Binding;

  • ICDS_DISABLE_CACHE - Use this flag to prevent the caching of any Dataverse-related data.;

  • ICDS_AUTH_KEY, ICDS_FORM_AUTH_KEY - Before connecting the plugin, make sure to set these keys. You can generate suitable keys using the online generator provided by WordPress at https://api.wordpress.org/secret-key/1.0/;

  • ICDS_DISABLE_MONACO - When editing page content, Dataverse Twig block uses the Monaco editor that provides syntax highlighting and intellisense. If ICDS_DISABLE_MONACO flag is set to true, the Monaco editor will be disabled and the plain text editor will be used instead.

  • ICDS_TWIG_DEBUG - When this flag is not set, Twig compile and runtime errors generate a short error message with the details available in the logs. When this flag is set, detailed error information is generated in the output. In addition, the dump() Twig function can be used to display object content, for example {{ dump(contact) }}.