[frs-325] Tracking CFLock wait time and frequency with FusionReactor

Background

Several CFML applications – especially legacy code-bases – make extensive use of the <cflock /> tag but it's very difficult to get metrics on 1) the frequency of <cflock /> usage and 2) the wait times incurred by <cflock />.

FusionReactor v5.0.8 and above can easily track these times.

Enabling

  • Create a file fusionreactoragent.properties in your FusionReactor instance folder ( eg FusionReactor/instance/<instance name>/fusionreactoragent.properties )
  • Insert the following text into the file:
    com.intergral.fusionreactor.agent.pointcuts.ColdFusionScopedLockPointCut=true
    com.intergral.fusionreactor.agent.pointcuts.ColdFusionNamedLockPointCut=true
    
  • Restart your ColdFusion instance

Viewing data

Charts

  • Login to FusionReactor and click the Transactions icon from the left-menu
  • Choose either Activity Graph or Time Graph
  • At the top-right of the graph is a drop-down (typically reading JDBCRequest). Select CFLockWait::Named or CFLockWait::Scope from the drop-down for named or scoped locks respectively.
    • The Activity Graph shows the number of <cflock /> tags encountered.
    • The Time Graph shows the time waiting to acquire a lock.

Tables

  • Login to FusionReactor and click the Transactions icon from the left-menu
  • Choose either Active or History
  • At the top-right of the graph is a drop-down (typically reading JDBCRequest). Select CFLockWait::Named or CFLockWait::Scope from the drop-down for named or scoped locks respectively.
    • The Active list shows currently active locks
    • The History list shows recently encountered locks

Request Details

After enabling, when you drill-down into a request's details, you will also be able to see the wait time, name/scope and other properties of the lock.

Issue Details

Type: Technote
Issue Number: FRS-325
Components: Metrics
Environment:
Resolution: Fixed
Last Updated: 05/Nov/13 12:51 PM
Affects Version: 5.0.0
Fixed Version: 5.0.0
Server: ColdFusion 6, ColdFusion 7, ColdFusion 8, ColdFusion 9, ColdFusion 10
Platform:
Related Issues:

Comments are closed.