#---------------------------------------------------------------# # # # (C) Copyright Rubysophic Inc. 2007-2008 # # All rights reserved. # # # # Use, duplication or disclosure of the code is not permitted # # unless licenced. # # # # Last Updated: 7/09/08 # #---------------------------------------------------------------# # # # The master copy of this property file should have been # # installed via the RubyRun gem install package in the # # same directory where rubyrun.rb is. # # # # However, the one that is to be used at run time is the one # # either in # # 1) the current working directiory under which the application# # is running, or # # 2) in RubyRun working directory, pointed to by the # # the environment variable RUBYRUN_WORKING_DIR (lower priority)# # # # ************************************************************ # # * IN ALL HASH SPECIFICATION, A SPACE MUST BE PLACED * # # * AFTER THE COLON AND BEFORE THE VALUES. * # # ************************************************************ # # # #---------------------------------------------------------------# # A source for application candidate classes or modules must # be identifed for instrumentation. These classes/modules should # be part of your application and not the Ruby or Rails libraries. # # APP_PATHS must be an array of directories (absolute path) # from where ruby code is to be loaded in order to run the # application. RubyRun will recursively expand these directories # and open every .rb file looking for Class or Module # statements. These Class or Module names will be noted as # candiates for instrumentation. APP_PATHS: [] # INCLUDE_HASH is a hash keyed on a class name with an array # of method names as values. Class name and method name must be a # string but names are case insensitive. This hash identifies # class/method combination explicitly that are to be instrumented # IN ADDITION to APP_PATHS. # Examples: # INCLUDE_HASH: {Class1: [method1, method2]} # #=> method1 and method2 of Class1 # INCLUDE_HASH: {Class1: []} #=> all methods in Class1 # INCLUDE_HASH: {*: [method1]} #=> method1 of any classes # INCLUDE_HASH: {} #=> Include nothing extra INCLUDE_HASH: {} # EXCLUDE_HASH is a hash keyed on a class name with an array # of method names as values. Class name and method name must be a # string but names are case insensitive. This hash identifies # class/method combinations that are to be excluded from instrumented. # Examples: # EXCLUDE_HASH: {Class1: [method1, method2]} # #=> method1 and method2 of Class1 # EXCLUDE_HASH: {Class1: []} #=> all methods in Class1 # EXCLUDE_HASH: {*: [method1]} #=> method1 of any classes # EXCLUDE_HASH: {} #=> Exclude nothing EXCLUDE_HASH: {} # Specify one of the following to get database I/O timings and sql statements # in method trace. # For Mysql: { ActiveRecord::ConnectionAdapters::MysqlAdapter: [execute] } # For Progres: { ActiveRecord::ConnectionAdapters::PostgreSQLAdapter: [execute] } # For SQLite: { ActiveRecord::ConnectionAdapters::SQLiteAdapter: [execute] } # For SQLite2: { ActiveRecord::ConnectionAdapters::SQLite2Adapter: [execute] } # For Firebird: { ActiveRecord::ConnectionAdapters::FirebirdAdapter: [execute] } # For SQLServer: { ActiveRecord::ConnectionAdapters::SQLServerAdapter: [execute] } # For OpenBase: { ActiveRecord::ConnectionAdapters::OpenBaseAdapter: [execute] } # For FrontBase: { ActiveRecord::ConnectionAdapters::FrontBaseAdapter: [execute] } DB_ADAPTER_HASH: {ActiveRecord::ConnectionAdapters::MysqlAdapter: [execute], ActiveRecord::ConnectionAdapters::JdbcAdapter: [execute]} # Specify how tracing is to be done. # Examples: # TRACE_HASH: {*: []} #=> Trace all instrumented methods: # TRACE_HASH: {} #=> Stop tracing # TRACE_HASH: {Class1: [method1, method2], Class2: [method3, method4]} # #=> Trace only these instrumented methods TRACE_HASH: {*: []} # Only applies when TRACE_HASH is not an empty hash. # Use DEBUG_ARGS to inspect arguments that were passed in method calls. # This can slow down execution and affect memory # footprint tremendously, and inspecting large argument objects can # frequently causes "stack level too deep" error. # Turn this on only as a last resort to debug with trace. DEBUG_ARGS: false # Only applies when TRACE_HASH is not an empty hash. # Use DEBUG_OBJ to inspect objects that made the method call. # This can slow down execution and affect memory # footprint tremendously, and inspecting large objects can # frequently causes "stack level too deep" error. # Turn this on only as a last resort to debug with trace. DEBUG_OBJ: false # Set Dynamic Application Discovery to true if you want to log # the name of the classes and methods that are dynamically added # to the Ruby process. DAD: true # Set the report timer in second(s). Used by the report # thread to wake up every so often to generate the performance report # Max value allowed: 3600 # Min value allowed: 60 REPORT_TIMER: 60 # Set the max no. of RSS reports to be kept before the oldest # report is shifted and purged. # Max value allowed: 120 # Min value allowed: 1 REPORT_SHIFT_AGE: 60 # Select reports. The following reports are available: # 1. perf_summary - Performance summary in RSS format # 2. txn_log - Transaction log in CSV format # Examples: # OUTPUT: [perf_summary] # OUTPUT: [perf_summary, txn_log] OUTPUT: [perf_summary] # Set the location of the RSS channel and item files # Leave this to blank results in [application directory]/public/rubyrun_rss being used RSS_PATH: