1- #
21# This file configures the New Relic Agent. New Relic monitors
3- # Java applications with deep visibility and low overhead. For more
4- # information, visit www.newrelic.com.
5- #
2+ # Java applications with deep visibility and low overhead. For more details and additional
3+ # configuration options visit https://docs.newrelic.com/docs/java/java-agent-configuration.
64#
75# This section is for settings common to all environments.
86# Do not add anything above this next line.
97common : &default_settings
10- #
11- # ============================== LICENSE KEY ===============================
128
9+ # ============================== LICENSE KEY ===============================
1310 # You must specify the license key associated with your New Relic
1411 # account. This key binds your Agent's data to your account in the
1512 # New Relic service.
16- license_key : ' '
13+ license_key : ' your license key '
1714
1815 # Agent Enabled
19- # Use this setting to force the agent to run or not run .
16+ # Use this setting to disable the agent instead of removing it from the startup command .
2017 # Default is true.
21- # agent_enabled: true
18+ agent_enabled : true
19+
20+ # Set the name of your application as you'd like it show up in New Relic.
21+ # If enable_auto_app_naming is false, the agent reports all data to this application.
22+ # Otherwise, the agent reports only background tasks (transactions for non-web applications)
23+ # to this application. To report data to more than one application
24+ # (useful for rollup reporting), separate the application names with ";".
25+ # For example, to report data to "My Application" and "My Application 2" use this:
26+ # app_name: My Application;My Application 2
27+ # This setting is required.
28+ app_name : My Application
29+
30+ # To enable high security, set this property to true. When in high
31+ # security mode, the agent will use SSL and obfuscated SQL. Additionally,
32+ # request parameters and message parameters will not be sent to New Relic.
33+ high_security : false
2234
2335 # Set to true to enable support for auto app naming.
2436 # The name of each web app is detected automatically
@@ -33,43 +45,35 @@ common: &default_settings
3345 # Default is true.
3446 enable_auto_transaction_naming : true
3547
36- # Set the name of your application as you'd like it show up in New Relic.
37- # if enable_auto_app_naming is false, the agent reports all data to this application.
38- # Otherwise, the agent reports only background tasks (transactions for non-web applications) to this application.
39- # To report data to more than one application, separate the application names with ";".
40- # For example, to report data to"My Application" and "My Application 2" use this:
41- # app_name: My Application;My Application 2
42- # This setting is required.
43- app_name : My Application
44-
4548 # The agent uses its own log file to keep its logging
4649 # separate from that of your application. Specify the log level here.
4750 # This setting is dynamic, so changes do not require restarting your application.
48- # The levels in increasing order of verboseness are: off, severe, warning, info, fine, finer, finest
51+ # The levels in increasing order of verboseness are:
52+ # off, severe, warning, info, fine, finer, finest
4953 # Default is info.
5054 log_level : info
5155
52- # Log all data to and from New Relic in plain text.
56+ # Log all data sent to and from New Relic in plain text.
5357 # This setting is dynamic, so changes do not require restarting your application.
5458 # Default is false.
55- # audit_mode: true
59+ audit_mode : false
5660
57- # The number of log files to use .
61+ # The number of backup log files to save .
5862 # Default is 1.
59- # log_file_count: 1
63+ log_file_count : 1
6064
6165 # The maximum number of bytes to write to any one log file.
6266 # The log_file_count must be set greater than 1.
6367 # Default is 0 (no limit).
64- # log_limit_in_kbytes: 0
68+ log_limit_in_kbytes : 0
6569
6670 # Override other log rolling configuration and roll the logs daily.
6771 # Default is false.
68- # log_daily: false
72+ log_daily : false
6973
7074 # The name of the log file.
7175 # Default is newrelic_agent.log.
72- # log_file_name: newrelic_agent.log
76+ log_file_name : newrelic_agent.log
7377
7478 # The log file directory.
7579 # Default is the logs directory in the newrelic.jar parent directory.
@@ -84,36 +88,45 @@ common: &default_settings
8488 # Default is true.
8589 ssl : true
8690
87- # Proxy settings for connecting to the New Relic server.
88- #
91+ # Proxy settings for connecting to the New Relic server:
8992 # If a proxy is used, the host setting is required. Other settings
9093 # are optional. Default port is 8080. The username and password
9194 # settings will be used to authenticate to Basic Auth challenges
9295 # from a proxy server.
93- #
94- # proxy_host: hostname
95- # proxy_port: 8080
96- # proxy_user: username
97- # proxy_password: password
98-
99- # Tells transaction tracer and error collector (when enabled)
100- # whether or not to capture HTTP params. When true, frameworks can
101- # exclude HTTP parameters from being captured.
102- # Default is false.
103- capture_params : false
96+ # proxy_host: hostname
97+ # proxy_port: 8080
98+ # proxy_user: username
99+ # proxy_password: password
100+
101+ # Limits the number of lines to capture for each stack trace.
102+ # Default is 30
103+ max_stack_trace_lines : 30
104+
105+ # Provides the ability to configure the attributes sent to New Relic. These
106+ # attributes can be found in transaction traces, traced errors, Insight's
107+ # transaction events, and Insight's page views.
108+ attributes :
109+
110+ # When true, attributes will be sent to New Relic. The default is true.
111+ enabled : true
112+
113+ # A comma separated list of attribute keys whose values should
114+ # be sent to New Relic.
115+ # include:
116+
117+ # A comma separated list of attribute keys whose values should
118+ # not be sent to New Relic.
119+ # exclude:
104120
105- # Tells transaction tracer and error collector to not to collect
106- # specific http request parameters.
107- # ignored_params: credit_card, ssn, password
108121
109122 # Transaction tracer captures deep information about slow
110123 # transactions and sends this to the New Relic service once a
111124 # minute. Included in the transaction is the exact call sequence of
112125 # the transactions including any SQL statements issued.
113126 transaction_tracer :
114127
115- # Transaction tracer is enabled by default. Set this to false to
116- # turn it off. This feature is only available at the higher product levels .
128+ # Transaction tracer is enabled by default. Set this to false to turn it off.
129+ # This feature is not available to Lite accounts and is automatically disabled .
117130 # Default is true.
118131 enabled : true
119132
@@ -133,10 +146,6 @@ common: &default_settings
133146 # Default is obfuscated.
134147 record_sql : obfuscated
135148
136- # Obfuscate only occurrences of specific SQL fields names.
137- # This setting only applies if "record_sql" is set to "raw".
138- # obfuscated_sql_fields: credit_card, ssn, password
139-
140149 # Set this to true to log SQL statements instead of recording them.
141150 # SQL is logged using the record_sql mode.
142151 # Default is false.
@@ -165,64 +174,78 @@ common: &default_settings
165174 # Default is 20.
166175 top_n : 20
167176
168-
169177 # Error collector captures information about uncaught exceptions and
170- # sends them to New Relic for viewing
178+ # sends them to New Relic for viewing.
171179 error_collector :
172180
173- # Error collector is enabled by default. Set this to false to turn
174- # it off. This feature is only available at the higher product levels .
181+ # This property enables the collection of errors. If the property is not
182+ # set or the property is set to false, then errors will not be collected .
175183 # Default is true.
176184 enabled : true
177185
178- # To stop specific exceptions from reporting to New Relic, set this property
179- # to a comma separated list of full class names.
180- #
181- # ignore_errors:
186+ # Use this property to exclude specific exceptions from being reported as errors
187+ # by providing a comma separated list of full class names.
188+ # The default is to exclude akka.actor.ActorKilledException. If you want to override
189+ # this, you must provide any new value as an empty list is ignored.
190+ ignore_errors : akka.actor.ActorKilledException
182191
183- # To stop specific http status codes from being reporting to New Relic as errors,
184- # set this property to a comma separated list of status codes to ignore.
185- # When this property is commented out it defaults to ignoring 404s.
186- #
187- # ignore_status_codes: 404
192+ # Use this property to exclude specific http status codes from being reported as errors
193+ # by providing a comma separated list of status codes.
194+ # The default is to exclude 404s. If you want to override
195+ # this, you must provide any new value as an empty list is ignored.
196+ ignore_status_codes : 404
197+
198+ # Analytics Events are used for Histograms and Percentiles. Unaggregated data is collected
199+ # for each web transaction and sent to the server on harvest.
200+ analytics_events :
201+
202+ # Set to false to disable analytics events.
203+ # Default is true.
204+ enabled : true
205+
206+ # Events are collected up to the configured amount. Afterwards, events are sampled to
207+ # maintain an even distribution across the harvest cycle. Largest value accepted is 10000.
208+ # Default is 2000. Setting to 0 will disable.
209+ max_samples_stored : 2000
188210
189211 # Cross Application Tracing adds request and response headers to
190- # external calls using the Apache HttpClient libraries to provided better
212+ # external calls using supported HTTP libraries to provide better
191213 # performance data when calling applications monitored by other New Relic Agents.
192- #
193214 cross_application_tracer :
194- # Set to true to enable cross application tracing.
215+
216+ # Set to false to disable cross application tracing.
195217 # Default is true.
196218 enabled : true
197219
198220 # Thread profiler measures wall clock time, CPU time, and method call counts
199221 # in your application's threads as they run.
222+ # This feature is not available to Lite accounts and is automatically disabled.
200223 thread_profiler :
201224
202225 # Set to false to disable the thread profiler.
203226 # Default is true.
204227 enabled : true
205228
206- # ============================== Browser Monitoring ===============================
207229 # New Relic Real User Monitoring gives you insight into the performance real users are
208230 # experiencing with your website. This is accomplished by measuring the time it takes for
209231 # your users' browsers to download and render your web pages by injecting a small amount
210232 # of JavaScript code into the header and footer of each page.
211233 browser_monitoring :
234+
212235 # By default the agent automatically inserts API calls in compiled JSPs to
213- # inject the monitoring JavaScript into web pages.
236+ # inject the monitoring JavaScript into web pages. Not all rendering engines are supported.
237+ # See https://docs.newrelic.com/docs/java/real-user-monitoring-in-java#manual_instrumentation
238+ # for instructions to add these manually to your pages.
214239 # Set this attribute to false to turn off this behavior.
215240 auto_instrument : true
216- # Set this attribute to false to prevent injection of the monitoring JavaScript.
217- # Default is true.
218- enabled : true
241+
219242
220243# Application Environments
221244# ------------------------------------------
222245# Environment specific settings are in this section.
223246# You can use the environment to override the default settings.
224247# For example, to change the app_name setting.
225- # Use -Dnewrelic.environment=<environment> on the Java command line
248+ # Use -Dnewrelic.environment=<environment> on the Java startup command line
226249# to set the environment.
227250# The default environment is production.
228251
0 commit comments