156. EPMO Open Source Coordination Office Redaction File Detail Report

Produced by Araxis Merge on 10/2/2017 1:40:11 PM Central Daylight Time. See www.araxis.com for information about Merge. This report uses XHTML and CSS2, and is best viewed with a modern standards-compliant browser. For optimum results when printing this report, use landscape orientation and enable printing of background images and colours in your browser.

156.1 Files compared

# Location File Last Modified
1 chef-repo.zip\chef-repo\third_party_cookbooks\newrelic\templates\default\agent\php newrelic.ini.erb Fri Jul 1 19:03:51 2016 UTC
2 chef-repo.zip\chef-repo\third_party_cookbooks\newrelic\templates\default\agent\php newrelic.ini.erb Mon Oct 2 15:39:24 2017 UTC

156.2 Comparison summary

Description Between
Files 1 and 2
Text Blocks Lines
Unchanged 3 1320
Changed 2 4
Inserted 0 0
Removed 0 0

156.3 Comparison options

Whitespace
Character case Differences in character case are significant
Line endings Differences in line endings (CR and LF characters) are ignored
CR/LF characters Not shown in the comparison detail

156.4 Active regular expressions

No regular expressions were active.

156.5 Comparison detail

  1   ; ######## ########## #
  2   ; # Genera ted by Che f
  3   ; ######## ########## #
  4  
  5   ;
  6   ; This fil e contains  the vario us setting s for the  New Relic  PHP agent.  There
  7   ; are many  options,  all of whi ch are des cribed in  detail at  the follow ing URL:
  8   ; https:// newrelic.c om/docs/ph p/php-agen t-phpini-s ettings
  9   ;
  10  
  11   ; If you u se a full  path to th e extensio n you insu late yours elf from t he
  12   ; extensio n director y changing  if you ch ange PHP i nstallatio ns or vers ions.
  13   ; If you d o not use  an absolut e path the n the file  must be i nstalled i n the
  14   ; active c onfigurati on's exten sion direc tory.
  15   extension= newrelic.s o
  16  
  17   [newrelic]
  18   ;
  19   ; Setting:  newrelic. enabled
  20   ; Type   :  boolean
  21   ; Scope  :  per-direc tory
  22   ; Default:  true
  23   ; Info   :  Enable or  disable t he agent.  Please not e that you  cannot gl obally
  24   ;           disable t he agent a nd then se lectively  enable it  on a per-d irectory
  25   ;           basis. If  you disab le the age nt in the  global INI  file then  the
  26   ;           agent wil l not init ialize at  all. Howev er, you ca n selectiv ely
  27   ;           disable t he agent o n a per-di rectory ba sis.
  28   ;
  29   <% if @res ource.enab led.nil? % >
  30   ;newrelic. enabled =  true
  31   <% else %>
  32   newrelic.e nabled = < %= @resour ce.enabled  %>
  33   <% end %>
  34  
  35   ;
  36   ; Setting:  newrelic. license
  37   ; Type   :  string
  38   ; Scope  :  per-direc tory
  39   ; Default:  none
  40   ; Info   :  Sets the  New Relic  license ke y to use.  This can v ary from d irectory
  41   ;           to direct ory if you  are runni ng a multi -tenant sy stem. By s pecial
  42   ;           dispensat ion if you  upgraded  from a pre vious vers ion of the  agent
  43   ;           where the  license k ey was set  in the da emon, the  installati on and
  44   ;           upgrade s cript will  have pres erved your  license k ey from th e file
  45   ;           /etc/newr elic/newre lic.cfg, b ut ONLY if  you insta lled via r pm/yum
  46   ;           or dpkg.  The key is  saved in  /etc/newre lic/upgrad e_please.k ey
  47   ;           and the a gent will  look for t hat file i f you do n ot specify  a valid
  48   ;           license h ere.
  49   ;           It is *ST RONGLY* re commended  that you s et the lic ense key i n your
  50   ;           INI file( s) and do  not rely o n the key  file being  present.  Also
  51   ;           please no te that ev en if you  are not le tting the  agent star t the
  52   ;           daemon an d are stil l using ne wrelic.cfg  (see belo w) the lic ense
  53   ;           keyword i n that fil e is no lo nger obeye d. Instead  the agent  will
  54   ;           use the p reserved v alue of th at license  from the  key file.
  55   ;           Once you  have updat ed your IN I files to  contain t he license  we
  56   ;           urge you  to remove  /etc/newre lic/upgrad e_please.k ey in orde r to
  57   ;           eliminate  the poten tial for c onfusion a bout exact ly where t he key
  58   ;           is coming  from.
  59   ;
  60   newrelic.l icense = " <%= @resou rce.licens e %>"
  61  
  62   ;
  63   ; Setting:  newrelic. logfile
  64   ; Type   :  string
  65   ; Scope  :  system
  66   ; Default:  none
  67   ; Info   :  Sets the  name of th e file to  send log m essages to .
  68   ;
  69   <% if @res ource.logf ile.nil? % >
  70   newrelic.l ogfile = " /var/log/n ewrelic/ph p_agent.lo g"
  71   <% else %>
  72   newrelic.l ogfile = " <%= @resou rce.logfil e %>"
  73   <% end %>
  74  
  75   ;
  76   ; Setting:  newrelic. loglevel
  77   ; Type   :  string
  78   ; Scope  :  system
  79   ; Default:  "info"
  80   ; Info   :  Sets the  level of d etail to i nclude in  the log fi le. You sh ould
  81   ;           rarely ne ed to chan ge this fr om the def ault, and  usually on ly under
  82   ;           the guida nce of tec hnical sup port. This  option ha s changed  meaning
  83   ;           fairly si gnificantl y from age nt version s 1.x and  2.x.
  84   ;
  85   <% if @res ource.logl evel.nil?  %>
  86   ;newrelic. loglevel =  "info"
  87   <% else %>
  88   newrelic.l oglevel =  "<%= @reso urce.logle vel %>"
  89   <% end %>
  90  
  91   ;
  92   ; Setting:  newrelic. appname
  93   ; Type   :  string
  94   ; Scope  :  per-direc tory
  95   ; Default:  "PHP Appl ication"
  96   ; Info   :  Sets the  name of th e applicat ion that m etrics wil l be repor ted into.
  97   ;           This can  in fact be  a list of  up to 3 a pplication  names, ea ch of
  98   ;           which mus t be separ ated by a  semi-colon . The firs t name in  any such
  99   ;           list is c onsidered  the 'prima ry' applic ation name  and must  be unique
  100   ;           for each  account /  license ke y.
  101   ;
  102   <% if @res ource.app_ name.nil?  %>
  103   ;newrelic. appname =  "PHP Appli cation"
  104   <% else %>
  105   newrelic.a ppname = " <%= @resou rce.app_na me %>"
  106   <% end %>
  107  
  108   ;
  109   ; Beginnin g with ver sion 3.0 o f the agen t, the dae mon can be  automatic ally
  110   ; started  by the age nt. There  is no need  to start  the daemon  before st arting
  111   ; Apache o r PHP-FPM.  All of th e newrelic .daemon.*  settings a re options  that
  112   ; control  the behavi our of the  daemon. T hese setti ngs are co nverted in to the
  113   ; appropri ate comman d line opt ions when  the agent  starts the  daemon. T his is
  114   ; now the  preferred  method of  starting t he daemon.  There are  still usa ge cases
  115   ; (such as  using a s ingle daem on for ser ving multi ple Apache  instances ) where
  116   ; you may  want to st art the da emon via i t's init s cript, but  for most  users,
  117   ; this is  the best p lace to co nfigure an d start th e daemon.
  118   ;
  119   ; The agen t will onl y launch t he daemon  if one isn 't already  running.  Also
  120   ; note tha t the agen t will NOT  stop the  daemon onc e it has s tarted. If  you
  121   ; want con trol over  exactly wh en the dae mon starts  and stops  you can s till
  122   ; achieve  that by cr eating a d aemon conf iguration  file (loca ted by def ault at
  123   ; /etc/new relic/newr elic.cfg)  and runnin g the chkc onfig or e quivalent  command.
  124   ; Please s ee the new relic.cfg  template f ile for de tails. Tha t template  file
  125   ; is locat ed at /usr /lib/newre lic-php5/s cripts/new relic.cfg. template.
  126   ;
  127   ; Also ple ase note t hat the op tions here  and in ne wrelic.cfg  are ident ical,
  128   ; except t hat in thi s file the y are prec eded with  "newrelic. daemon.".
  129   ;
  130  
  131   ;
  132   ; Setting:  newrelic. daemon.log file
  133   ; Type   :  string
  134   ; Scope  :  system
  135   ; Default:  none
  136   ; Info   :  Sets the  name of th e file to  send daemo n log mess ages to.
  137   ;
  138   newrelic.d aemon.logf ile = "<%=  @resource .daemon_lo gfile %>"
  139  
  140   ;
  141   ; Setting:  newrelic. daemon.log level
  142   ; Type   :  string
  143   ; Scope  :  system
  144   ; Default:  "info"
  145   ; Info   :  Sets the  level of d etail to i nclude in  the daemon  log. You  should
  146   ;           rarely ne ed to chan ge this fr om the def ault, and  usually on ly under
  147   ;           the guida nce of tec hnical sup port. This  option ha s changed  meaning
  148   ;           fairly si gnificantl y from age nt version s 1.x and  2.x.
  149   ;
  150   <% if @res ource.daem on_logleve l.nil? %>
  151   ;newrelic. daemon.log level = "i nfo"
  152   <% else %>
  153   newrelic.d aemon.logl evel = "<% = @resourc e.daemon_l oglevel %> "
  154   <% end %>
  155  
  156   ;
  157   ; Setting:  newrelic. daemon.por t
  158   ; Type   :  integer
  159   ; Scope  :  system
  160   ; Default:   PORT
  161   ; Info   :  Sets the  TCP port n umber (onl y accessib le on loca lhost) whi ch the
  162   ;           daemon li stens on.  This is us ed for the  worker pr ocesses an d CLI
  163   ;           invocatio ns to comm unicate wi th the dae mon.
  164   ;
  165   <% if @res ource.daem on_port.ni l? %>
  166   ;newrelic. daemon.por t =  PORT
  167   <% else %>
  168   newrelic.d aemon.port  = <%= @re source.dae mon_port % >
  169   <% end %>
  170  
  171   ;
  172   ; Setting:  newrelic. daemon.max _threads
  173   ; Type   :  integer
  174   ; Scope  :  system
  175   ; Default:  8
  176   ; Info   :  Sets the  number of  threads in  the daemo n "worker  pool" that  will be
  177   ;           used for  processing  requests  from each  agent. The  minimum i s 4 and
  178   ;           the maxim um is 128.
  179   ;
  180   <% if @res ource.daem on_max_thr eads.nil?  %>
  181   ;newrelic. daemon.max _threads =  8
  182   <% else %>
  183   newrelic.d aemon.max_ threads =  <%= @resou rce.daemon _max_threa ds %>
  184   <% end %>
  185  
  186   ;
  187   ; Setting:  newrelic. daemon.ssl
  188   ; Type   :  boolean
  189   ; Scope  :  system
  190   ; Default:  false
  191   ; Info   :  Sets whet her or not  communica tion with  New Relic  data colle ctors
  192   ;           should us e a secure  HTTP conn ection or  not. Depen ding on yo ur
  193   ;           operating  system an d how it i s configur ed, in ord er for thi s to
  194   ;           work corr ectly you  may need t o provide  the locati on of eith er a
  195   ;           PEM-encod ed certifi cate file,  or a dire ctory that  contains  a list
  196   ;           of such f iles, usin g the foll owing two  options.
  197   ;
  198   <% if @res ource.daem on_ssl.nil ? %>
  199   ;newrelic. daemon.ssl  = false
  200   <% else %>
  201   newrelic.d aemon.ssl  = <%= @res ource.daem on_ssl %>
  202   <% end %>
  203  
  204   ;
  205   ; Setting:  newrelic. daemon.ssl _ca_path
  206   ; Setting:  newrelic. daemon.ssl _ca_bundle
  207   ; Type   :  string
  208   ; Scope  :  system
  209   ; Default:  system de pendent
  210   ; Info   :  Sets the  name of ei ther a dir ectory or  a file tha t contains  a list
  211   ;           of certif icate auth orities. M ay be requ ired when  you enable  https
  212   ;           support a bove.
  213   ;
  214   <% if @res ource.daem on_ssl_ca_ path.nil?  %>
  215   ;newrelic. daemon.ssl _ca_path =  ""
  216   <% else %>
  217   newrelic.d aemon.ssl_ ca_path =  "<%= @reso urce.daemo n_ssl_ca_p ath %>"
  218   <% end %>
  219   <% if @res ource.daem on_ssl_ca_ bundle.nil ? %>
  220   ;newrelic. daemon.ssl _ca_bundle  = ""
  221   <% else %>
  222   newrelic.d aemon.ssl_ ca_bundle  = "<%= @re source.dae mon_ssl_ca _bundle %> "
  223   <% end %>
  224  
  225   ;
  226   ; Setting:  newrelic. daemon.pro xy
  227   ; Type   :  string
  228   ; Scope  :  system
  229   ; Default:  none
  230   ; Info   :  Sets the  host and u ser creden tials to u se as an e gress prox y. This
  231   ;           is only u sed if you r site req uires a pr oxy in ord er to acce ss
  232   ;           external  servers on  the inter net, in th is case th e New Reli c data
  233   ;           collectio n servers.  This is e xpressed i n one of t he followi ng forms:
  234   ;              hostna me
  235   ;              hostna me:port
  236   ;              user@h ostname
  237   ;              user@h ostname:po rt
  238   ;              user:p assword@ho stname
  239   ;              user:p assword@ho stname:por t
  240   ;
  241   <% if @res ource.daem on_proxy.n il? %>
  242   ;newrelic. daemon.pro xy = ""
  243   <% else %>
  244   newrelic.d aemon.prox y = "<%= @ resource.d aemon_prox y %>"
  245   <% end %>
  246  
  247   ;
  248   ; Setting:  newrelic. daemon.pid file
  249   ; Type   :  string
  250   ; Scope  :  system
  251   ; Default:  OS depend ent
  252   ; Info   :  Sets the  name of th e file to  store the  running da emon's pro cess ID
  253   ;           (PID) in.  This file  is used b y the daem on startup  and shutd own
  254   ;           script to  determine  whether o r not the  daemon is  already ru nning.
  255   ;
  256   <% if @res ource.daem on_pidfile .nil? %>
  257   ;newrelic. daemon.pid file = ""
  258   <% else %>
  259   newrelic.d aemon.pidf ile = "<%=  @resource .daemon_pi dfile %>"
  260   <% end %>
  261  
  262   ;
  263   ; Setting:  newrelic. daemon.loc ation
  264   ; Type   :  string
  265   ; Scope  :  system
  266   ; Default:  /usr/bin/ newrelic-d aemon
  267   ; Info   :  Sets the  name of th e daemon e xecutable  to launch.
  268   ;           Please no te that on  OpenSolar is where / usr is fre quently a  read-only
  269   ;           filesyste m, the def ault daemo n location  is
  270   ;           /opt/newr elic/bin/n ewrelic-da emon.
  271   ;
  272   <% if @res ource.daem on_locatio n.nil? %>
  273   ;newrelic. daemon.loc ation = "/ usr/bin/ne wrelic-dae mon"
  274   <% else %>
  275   newrelic.d aemon.loca tion = "<% = @resourc e.daemon_l ocation %> "
  276   <% end %>
  277  
  278   ;
  279   ; Setting:  newrelic. daemon.col lector_hos t
  280   ; Type   :  string
  281   ; Scope  :  system
  282   ; Default:  collector .newrelic. com
  283   ; Info   :  Sets the  host name  of the New  Relic dat a collecto r host to  use.
  284   ;           Please no te that th is is NOT  any form o f local ho st. It ref ers to
  285   ;           the New R elic provi ded host.  There is v ery little  reason to  ever
  286   ;           change th is from th e default  except in  certain ve ry special
  287   ;           circumsta nces, and  then only  on instruc tion from  a New Reli c sales
  288   ;           person or  support s taff membe r.
  289   ;
  290   <% if @res ource.daem on_collect or_host.ni l? %>
  291   ;newrelic. daemon.col lector_hos t = "colle ctor.newre lic.com"
  292   <% else %>
  293   newrelic.d aemon.coll ector_host  = "<%= @r esource.da emon_colle ctor_host  %>"
  294   <% end %>
  295  
  296   ;
  297   ; Setting:  newrelic. daemon.don t_launch
  298   ; Type   :  integer ( 0, 1, 2 or  3)
  299   ; Scope  :  system
  300   ; Default:  0
  301   ; Info   :  If you pr efer to ha ve the dae mon launch ed externa lly before  the
  302   ;           agent sta rts up, se t this var iable to n on-zero. T he value y ou
  303   ;           choose de termines e xactly whe n the agen t is allow ed to star t the
  304   ;           daemon:
  305   ;           0 - agent  can start  the daemo n any time  it needs  to
  306   ;           1 - non-C LI (i.e Ap ache / php -fpm) agen ts can sta rt the dae mon
  307   ;           2 - only  CLI agents  can start  the daemo n
  308   ;           3 - the a gent will  never star t the daem on
  309   ;
  310   <% if @res ource.daem on_dont_la unch.nil?  %>
  311   ;newrelic. daemon.don t_launch =  0
  312   <% else %>
  313   newrelic.d aemon.dont _launch =  <%= @resou rce.daemon _dont_laun ch %>
  314   <% end %>
  315  
  316   ;
  317   ; Setting:  newrelic. capture_pa rams
  318   ; Type   :  boolean
  319   ; Scope  :  per-direc tory
  320   ; Default:  false
  321   ; Info   :  Enable or  disable t he capturi ng of URL  parameters . If enabl ed, then
  322   ;           any varia bles passe d on the U RL like (f or example  ?id=12345 ) will be
  323   ;           saved wit h the requ est and vi sible in v arious pla ces in the  web UI.
  324   ;           If you te nd to pass  sensitive  informati on around  directly i n the URL
  325   ;           then its  a good ide a to keep  this disab led. Howev er, if you r URL
  326   ;           parameter s are simp ly used fo r paramete rs without  sensitive  data but
  327   ;           that are  meaningful  to each t ransaction  then you  can enable  this.
  328   ;
  329   <% if @res ource.capt ure_params .nil? %>
  330   ;newrelic. capture_pa rams = fal se
  331   <% else %>
  332   newrelic.c apture_par ams = <%=  @resource. capture_pa rams %>
  333   <% end %>
  334  
  335   ; Setting:  newrelic. ignored_pa rams
  336   ; Type   :  string
  337   ; Scope  :  per-direc tory
  338   ; Default:  none
  339   ; Info   :  A comma-s eparated l ist of par ameters to  always ex clude if p arameter
  340   ;           capturing  is enable d above. Y ou can use  this to f ilter out  sensitive
  341   ;           user data  that may  appear as  a URL para meter.
  342   ;
  343   <% if @res ource.igno red_params .nil? %>
  344   ;newrelic. ignored_pa rams = ""
  345   <% else %>
  346   newrelic.i gnored_par ams = "<%=  @resource .ignored_p arams %>"
  347   <% end %>
  348  
  349   ;
  350   ; Setting:  newrelic. error_coll ector.enab le
  351   ; Type   :  boolean
  352   ; Scope  :  per-direc tory
  353   ; Default:  true
  354   ; Info   :  Enable th e New Reli c error co llector. T his will r ecord the  20 most
  355   ;           severe er rors per h arvest cyc le. It is  rare to wa nt to disa ble this.
  356   ;           Please al so note th at your Ne w Relic su bscription  level may  force
  357   ;           this to b e disabled  regardles s of any v alue you s et for it.
  358   ;
  359   <% if @res ource.erro r_collecto r_enable.n il? %>
  360   ;newrelic. error_coll ector.enab le = true
  361   <% else %>
  362   newrelic.e rror_colle ctor.enabl e = <%= @r esource.er ror_collec tor_enable  %>
  363   <% end %>
  364  
  365   ;
  366   ; Setting:  newrelic. error_coll ector.reco rd_databas e_errors
  367   ; Type   :  boolean
  368   ; Scope  :  per-direc tory
  369   ; Default:  false
  370   ; Info   :  Currently  only supp orted for  MySQL data base funct ions. If e nabled,
  371   ;           this will  cause err ors return ed by vari ous MySQL  functions  to be
  372   ;           treated a s if they  were PHP e rrors, and  thus subj ect to err or
  373   ;           collectio n. This is  only obje yed if the  error col lector is  enabled
  374   ;           above and  the accou nt subscri ption leve l permits  error trap ping.
  375   ;
  376   <% if @res ource.erro r_collecto r_record_d atabase_er rors.nil?  %>
  377   ;newrelic. error_coll ector.reco rd_databas e_errors =  false
  378   <% else %>
  379   newrelic.e rror_colle ctor.recor d_database _errors =  <%= @resou rce.error_ collector_ record_dat abase_erro rs %>
  380   <% end %>
  381  
  382   ;
  383   ; Setting:  newrelic. error_coll ector.prio ritize_api _errors
  384   ; Type   :  boolean
  385   ; Scope  :  per-direc tory
  386   ; Default:  false
  387   ; Info   :  If the er ror collec tor is ena bled and y ou use the  New Relic  API to
  388   ;           notice an  error, if  this is s et to true  then assi gn the hig hest
  389   ;           priority  to such er rors.
  390   ;
  391   <% if @res ource.erro r_collecto r_prioriti ze_api_err ors.nil? % >
  392   ;newrelic. error_coll ector.prio ritize_api _errors =  false
  393   <% else %>
  394   newrelic.e rror_colle ctor.prior itize_api_ errors = < %= @resour ce.error_c ollector_p rioritize_ api_errors  %>
  395   <% end %>
  396  
  397   ;
  398   ; Setting:  newrelic. browser_mo nitoring.a uto_instru ment
  399   ; Type   :  boolean
  400   ; Scope  :  per-direc tory
  401   ; Default:  true
  402   ; Info   :  Enables o r disables  automatic  real user  monitorin g ("auto-R UM").
  403   ;           When enab led will c ause the a gent to in sert a hea der and a  footer
  404   ;           in HTML o utput that  will time  the actua l end-user  experienc e.
  405   ;
  406   <% if @res ource.brow ser_monito ring_auto_ instrument .nil? %>
  407   ;newrelic. browser_mo nitoring.a uto_instru ment = tru e
  408   <% else %>
  409   newrelic.b rowser_mon itoring.au to_instrum ent = <%=  @resource. browser_mo nitoring_a uto_instru ment %>
  410   <% end %>
  411  
  412   ;
  413   ; Setting:  newrelic. transactio n_tracer.e nable
  414   ; Type   :  boolean
  415   ; Scope  :  per-direc tory
  416   ; Default:  true
  417   ; Info   :  Enables o r disables  the trans action tra cer. When  enabled th is will
  418   ;           produce a  detailed  call graph  for any t ransaction  that exce eds a
  419   ;           certain t hreshold ( see next e ntry). Onl y one tran saction tr ace per
  420   ;           applicati on per har vest cycle  is stored  and it is  always th e slowest
  421   ;           transacti on during  that cycle . Transact ion traces  are extre mely
  422   ;           useful wh en diagnos ing proble m spots in  your appl ication. P lease
  423   ;           note that  TT's may  be disable d by your  account su bscription  level
  424   ;           regardles s of what  you set he re.
  425   ;
  426   <% if @res ource.tran saction_tr acer_enabl e.nil? %>
  427   ;newrelic. transactio n_tracer.e nable = tr ue
  428   <% else %>
  429   newrelic.t ransaction _tracer.en able = <%=  @resource .transacti on_tracer_ enable %>
  430   <% end %>
  431  
  432   ;
  433   ; Setting:  newrelic. transactio n_tracer.t hreshold
  434   ; Type   :  string wi th a time  specificat ion or the  word "apd ex_f"
  435   ; Scope  :  per-direc tory
  436   ; Default:  "apdex_f"
  437   ; Info   :  Specifies  the thres hold above  which a t ransaction  becomes a
  438   ;           candidate  for the t ransaction  tracer. T his can ei ther be an  absolute
  439   ;           time valu e like "20 0ms" or "1 s250ms" or  "1h30m" o r "750us"  or the
  440   ;           word "apd ex_f". Thi s last val ue, "apdex _f", means  "4 times  apdex_t".
  441   ;           Thus the  threshold  changes ac cording to  your apde x_t settin g. This
  442   ;           is the de fault.
  443   ;
  444   <% if @res ource.tran saction_tr acer_thres hold.nil?  %>
  445   ;newrelic. transactio n_tracer.t hreshold =  "apdex_f"
  446   <% else %>
  447   newrelic.t ransaction _tracer.th reshold =  "<%= @reso urce.trans action_tra cer_thresh old %>"
  448   <% end %>
  449  
  450   ;
  451   ; Setting:  newrelic. transactio n_tracer.d etail
  452   ; Type   :  integer i n the rang e 0-2
  453   ; Scope  :  per-direc tory
  454   ; Default:  1
  455   ; Info   :  Sets the  level of d etail in a  transacti on trace.  Setting th is to 0
  456   ;           will only  show the  relatively  few PHP f unctions t hat New Re lic has
  457   ;           deemed to  be "inter esting", a s well as  any custom  functions  you set
  458   ;           (see belo w). A sett ing of 1 w ill trace  and time a ll user fu nctions,
  459   ;           and a set ting of 2,  which nee ds another  special v ariable to  be set
  460   ;           in order  to take ef fect, will  trace ALL  PHP funct ions, incl uding
  461   ;           internal  ones imple mented in  modules. T his last s etting can  have a
  462   ;           severe im pact on pe rformance  which is w hy you nee d to consu lt New
  463   ;           Relic sup port staff  at suppor t@newrelic .com to ge t the "spe cial"
  464   ;           variable  to set to  enable the  feature.  It is very  rarely ne eded.
  465   ;
  466   ;           In earlie r releases  of the ag ent this w as known a s "top100" .
  467   ;
  468   <% if @res ource.tran saction_tr acer_detai l.nil? %>
  469   ;newrelic. transactio n_tracer.d etail = 1
  470   <% else %>
  471   newrelic.t ransaction _tracer.de tail = <%=  @resource .transacti on_tracer_ detail %>
  472   <% end %>
  473  
  474   ;
  475   ; Setting:  newrelic. transactio n_tracer.s low_sql
  476   ; Type   :  boolean
  477   ; Scope  :  per-direc tory
  478   ; Default:  true
  479   ; Info   :  Enables o r disables  the "slow  SQL" trac er. When e nabled, th is will
  480   ;           record th e top 10 s lowest SQL  calls alo ng with a  stack trac e of
  481   ;           where the  call occu rred in yo ur code.
  482   ;
  483   <% if @res ource.tran saction_tr acer_slow_ sql.nil? % >
  484   ;newrelic. transactio n_tracer.s low_sql =  true
  485   <% else %>
  486   newrelic.t ransaction _tracer.sl ow_sql = < %= @resour ce.transac tion_trace r_slow_sql  %>
  487   <% end %>
  488  
  489   ;
  490   ; Setting:  newrelic. transactio n_tracer.s tack_trace _threshold
  491   ; Type   :  time spec ification  string ("5 00ms", "1s 750ms" etc )
  492   ; Scope  :  per-direc tory
  493   ; Default:  500ms
  494   ; Info   :  Sets the  threshold  above whic h the New  Relic agen t will rec ord a
  495   ;           stack tra ce for a t ransaction  trace.
  496   ;
  497   <% if @res ource.tran saction_tr acer_stack _trace_thr eshold.nil ? %>
  498   ;newrelic. transactio n_tracer.s tack_trace _threshold  = 500
  499   <% else %>
  500   newrelic.t ransaction _tracer.st ack_trace_ threshold  = <%= @res ource.tran saction_tr acer_stack _trace_thr eshold %>
  501   <% end %>
  502  
  503   ;
  504   ; Setting:  newrelic. transactio n_tracer.e xplain_thr eshold
  505   ; Type   :  time spec ification  string ("7 50ms", "1s  500ms" et c)
  506   ; Scope  :  per-direc tory
  507   ; Default:  500ms
  508   ; Info   :  Used by t he slow SQ L tracer t o set the  threshold  above whic h an SQL
  509   ;           statement  is consid ered "slow ", and to  set the th reshold ab ove which
  510   ;           the trans action tra cer will r equest an  "explain p lan" from  the data-
  511   ;           base for  slow SQL.  This latte r feature  may not be  active ye t, please
  512   ;           refer to  the agent  release no tes to see  when it b ecomes ava ilable.
  513   ;
  514   <% if @res ource.tran saction_tr acer_expla in_thresho ld.nil? %>
  515   ;newrelic. transactio n_tracer.e xplain_thr eshold = 5 00
  516   <% else %>
  517   newrelic.t ransaction _tracer.ex plain_thre shold = <% = @resourc e.transact ion_tracer _explain_t hreshold % >
  518   <% end %>
  519  
  520   ;
  521   ; Setting:  newrelic. transactio n_tracer.r ecord_sql
  522   ; Type   :  "off", "r aw" or "ob fuscated"
  523   ; Scope  :  per-direc tory
  524   ; Default:  "obfuscat ed"
  525   ; Info   :  Sets how  SQL statem ents are r ecorded (i f at all).  If this i s set to
  526   ;           "raw" the n no attem pt is made  at obfusc ating SQL  statements . THIS IS
  527   ;           HIGHLY DI SCOURAGED  IN PRODUCT ION ENVIRO NMENTS! Se tting this  to raw
  528   ;           has consi derable se curity imp lications  as it can  expose sen sitive
  529   ;           and priva te custome r data.
  530   ;
  531   <% if @res ource.tran saction_tr acer_recor d_sql.nil?  %>
  532   ;newrelic. transactio n_tracer.r ecord_sql  = "obfusca ted"
  533   <% else %>
  534   newrelic.t ransaction _tracer.re cord_sql =  "<%= @res ource.tran saction_tr acer_recor d_sql %>"
  535   <% end %>
  536  
  537   ; Setting:  newrelic. transactio n_tracer.c ustom
  538   ; Type   :  string
  539   ; Scope  :  per-direc tory
  540   ; Default:  none
  541   ; Info   :  Sets the  name(s) of  additiona l function s you want  to instru ment and
  542   ;           appear in  transacti on traces.  This is o nly meanin gful if yo u have
  543   ;           set newre lic.transa ction_trac er.detail  to 0. This  can be a  comma-
  544   ;           separated  list of f unction or  class met hod names.
  545   ;
  546   <% if @res ource.tran saction_tr acer_custo m.nil? %>
  547   ;newrelic. transactio n_tracer.c ustom = ""
  548   <% else %>
  549   newrelic.t ransaction _tracer.cu stom = "<% = @resourc e.transact ion_tracer _custom %> "
  550   <% end %>
  551  
  552   ;
  553   ; Setting:  newrelic. framework
  554   ; Type   :  string
  555   ; Scope  :  per-direc tory
  556   ; Default:  empty (au to-detect  framework)
  557   ; Info   :  Forces th e framewor k to be on e of the s upported f rameworks.  This
  558   ;           should on ly ever be  used if t he auto-de tection fa ils, in wh ich case
  559   ;           we (suppo rt@newreli c.com) wou ld very mu ch like to  know abou t the
  560   ;           detection  failure.  Must be on e of the f ollowing v alues:
  561   ;
  562   ;           cakephp,  codeignite r, drupal,  joomla, k ohana, mag ento, medi awiki,
  563   ;           symfony,  wordpress,  yii, zend  or no_fra mework.
  564   ;
  565   <% if @res ource.fram ework.nil?  %>
  566   ;newrelic. framework  = ""
  567   <% else %>
  568   newrelic.f ramework =  "<%= @res ource.fram ework %>"
  569   <% end %>
  570  
  571   ;
  572   ; Setting:  newrelic. webtransac tion.name. remove_tra iling_path
  573   ; Type   :  boolean
  574   ; Scope  :  per-direc tory
  575   ; Default:  false
  576   ; Info   :  Used to a id naming  transactio ns correct ly when an  unsupport ed
  577   ;           framework  is being  used. This  option wi ll cause a nything af ter the
  578   ;           script na me to be s tripped fr om a URL.  For exampl e, setting  this
  579   ;           would cau se the "/x yz/zy" to  be strippe d from a U RL such as
  580   ;           "/path/to /foo.php/x yz/zy".
  581   ;
  582   <% if @res ource.webt ransaction _name_remo ve_trailin g_path.nil ? %>
  583   ;newrelic. webtransac tion.name. remove_tra iling_path  = false
  584   <% else %>
  585   newrelic.w ebtransact ion.name.r emove_trai ling_path  = <%= @res ource.webt ransaction _name_remo ve_trailin g_path %>
  586   <% end %>
  587  
  588   ;
  589   ; Setting:  newrelic. webtransac tion.name. functions
  590   ; Type   :  string
  591   ; Scope  :  per-direc tory
  592   ; Default:  none
  593   ; Info   :  Unless a  specific f ramework s uch as Dru pal or Wor dpress has  been
  594   ;           detected,  transacti ons are na med accord ing to the  first scr ipt
  595   ;           encounter ed, such a s login.ph p. However , if you u se a dispa tcher
  596   ;           file such  as index. php this p roduces le ss useful  data. If y ou use
  597   ;           a dispatc her to red irect to a ctions suc h as "logi n", "show" , "edit"
  598   ;           etc, you  can set th is to the  top level  functions  for those  actions,
  599   ;           and the f unction na mes specif ied here w ill be use d to name  the
  600   ;           transacti on.
  601   ;
  602   <% if @res ource.webt ransaction _name_func tions.nil?  %>
  603   ;newrelic. webtransac tion.name. functions  = ""
  604   <% else %>
  605   newrelic.w ebtransact ion.name.f unctions =  "<%= @res ource.webt ransaction _name_func tions %>"
  606   <% end %>
  607  
  608   ;
  609   ; Setting:  newrelic. webtransac tion.name. files
  610   ; Type   :  string
  611   ; Scope  :  per-direc tory
  612   ; Default:  none
  613   ; Info   :  Same as n ewrelic.we btransacti on.name.fu nctions ab ove but us ing file
  614   ;           names ins tead of fu nction nam es. Accept s standard  POSIX reg ular
  615   ;           expressio ns.
  616   ;
  617   <% if @res ource.webt ransaction _name_file s.nil? %>
  618   ;newrelic. webtransac tion.name. files = ""
  619   <% else %>
  620   newrelic.w ebtransact ion.name.f iles = "<% = @resourc e.webtrans action_nam e_files %> "
  621   <% end %>
  622  
  623   ;
  624   ; Setting:  newrelic. cross_appl ication_tr acer.enabl ed
  625   ; Type   :  Boolean
  626   ; Scope  :  per-direc tory
  627   ; Default:  true
  628   ; Info   :  Enable or  disable t he cross a pplication  tracer.
  629   ;           The cross  applicati on tracer  inserts HT TP headers  into outb ound reque sts
  630   ;           and the r esponse in  order to  link toget her web tr ansaction  metrics an d
  631   ;           transacti on traces  between ap plications .
  632   ;
  633   <% if @res ource.cros s_applicat ion_tracer _enable.ni l? %>
  634   ;newrelic. cross_appl ication_tr acer.enabl ed = true
  635   <% else %>
  636   newrelic.c ross_appli cation_tra cer.enable d = <%= @r esource.cr oss_applic ation_trac er_enable  %>
  637   <% end %>
  638  
  639   ;
  640   ; Setting:  newrelic. high_secur ity
  641   ; Type   :  Boolean
  642   ; Scope  :  per-direc tory
  643   ; Default:  flase
  644   ; Info   :  Enables h igh securi ty for all  applicati ons. When  high secur ity is set  to true,  the follow ing behavi ors take e ffect:
  645   ;  * Data  will not b e sent to  New Relic  unless the  newrelic- daemon is  using SSL.  If the PH P process  spawns a n ewrelic-da emon
  646   ;           it will b e configur ed to use  SSL regard less of th e value of  newrelic. daemon.ssl .
  647   ;  * Raw S QL strings  will neve r be gathe red, regar dless of t he value o f newrelic .transacti on_tracer. record_sql .
  648   ;  * Reque st attribu tes will n ever be ca ptured, re gardless o f the newr elic.attri butes conf iguration  settings.
  649   ;  * The n ewrelic_ad d_custom_p arameter a nd newreli c_set_user _attribute s API func tions will  have no e ffect, and  they will  return fa lse.
  650   ;
  651   ; Caution:  If you ch ange this  setting, y ou must al so change  the securi ty setting  in the Ne w Relic AP M user int erface.
  652   ;    If th e two sett ings do no t match, t hen no dat a will be  collected.  For more  informatio n, see htt ps://docs. newrelic.c om/docs/su bscription s/high-sec urity
  653   ;
  654   <% if @res ource.high _security. nil? %>
  655   ;newrelic. high_secur ity = fals e
  656   <% else %>
  657   newrelic.h igh_securi ty = <%= @ resource.h igh_securi ty %>
  658   <% end %>
  659  
  660   <% @resour ce.additio nal_config .each do | config, va lue|%>
  661   <%= config  %> = "<%=  value %>"
  662   <% end %>