FusionReactor Lucee and Railo line performance

Introduction

This technote is going to introduce the Lucee and Railo line performance plugins. The FusionReactor plugins allow you to profile the execution of ColdFusion CFML code at line level. This data can then be used to identify performance issues deep inside your ColdFusion pages and components and can be an invaluable tool for finding problems within your applications. This feature also gathers information about the CFML code coverage which can be very valuable when testing applications.

If you are using a ColdFusion server, FusionReactor 6.04 or above supports the FusionReactor ColdFusion Plugin. More information about the FusionReactor ColdFusion line performance, check out the link below.

• https://intergral.atlassian.net/wiki/display/FR62/FusionReactor+ColdFusion+Line+Performance+Profiler

Getting Started

If you are using FusionReactor 6.2.0 or above and a Lucee 4.5 server, you will be able to use the FusionReactor Lucee Plugin. However, if you are on Railo server then you will be able to use the FusionReactor Railo Plugin.

Currently Lucee 5 is not supported.

In order to view any of the profiled data, you will require the “CF Line Performance Explorer” application. This can be downloaded from the link below.

• https://github.com/intergral/cfperformanceexplorer

When the tool has been downloaded, you will need to unzip the folder and copy the contents into your Lucee or Railo /webapps/ROOT directory. Going to the following address, http://localhost:8888/cfperformanceexplorer-master/ you will see the following when you attempt to view a files metric data.

To enable the line tracking for your CFML files you can follow the steps outlined below;

1. Access your FusionReactor Instance .
2. Navigate to FusionReactor > Plugins > Active Plugins
3. Locate the FusionReactor Lucce Plugin or the FusionReactor Railo Plugin and then press the Configuration button.
4. Change the value of the “Track CFML Line Execution Times” field to “Enabled” and Save the changes.
   

This will take immediate effect and any CFML code that is run is going to be profiled. You can now return to the CF Line Performance Explorer application to view the profile data for any classes that have been run since enabling of the plugin. See screen below

Though the data gained from the profiled classes may be invaluable the profiler can have a performance impact on your server. It is recommended to only use the profiler when required and to take precautions when using it in a production environment.

More Information

For more information you can view the following documentation.

• https://intergral.atlassian.net/wiki/display/FR62/FusionReactor+Lucee+and+Railo+Plugin