Troubleshooting Templates with Glowroot Freemarker Plugin

Liferay DXP 2023.Q4+/Portal GA100+

Glowroot can troubleshoot FreeMarker templates to pinpoint slow transactions.

Configuring the FreeMarker Plugin

1. Navigate to Configuration → Plugins. Click Liferay FreeMarker Templates Plugin.

2. The instrumentation can be configured at an INFO, DEBUG, or TRACE level.

   The INFO level shows how much time template transformations are taking. The DEBUG level treats each template transformation as a unique transaction for individual inspection. Note that this setting might use more Glowroot overhead. The TRACE level gives more details about the template script and trace details for inspection.

Troubleshooting FreeMarker Templates

1. Navigate to the Transactions tab and select FreeMarker Templates from the drop-down menu. A list of all template transactions appears.

2. To see details of a specific transaction, click the Slow traces tab in the transaction panel.

3. Click a data point to view transaction details. See the transformation times for the template under the Breakdown section.

   

4. Scroll down further and click Trace entries. The trace is expanded to show details of the fragment transformation.

   

To inspect template transaction errors,

1. Navigate to the Errors tab and select FreeMarker Templates from the drop-down menu.

2. Click on a specific error for inspection.