Skip to content

Commit

Permalink
Merge pull request #13707 from tannalynn/update_ruby_agent_config_930
Browse files Browse the repository at this point in the history
Config updates for Ruby agent release 9.3.0
  • Loading branch information
bradleycamacho committed Jun 26, 2023
2 parents ba8815d + 6e869c9 commit b793415
Showing 1 changed file with 46 additions and 9 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -561,7 +561,6 @@ The [transaction traces](/docs/apm/traces/transaction-traces/transaction-traces)
- If you do not want the agent to capture query information, set this to `none`.
- If you want the agent to capture all query information in its original form, set this to `raw`.
- When you enable [high security mode](/docs/agents/manage-apm-agents/configuration/high-security-mode), this is automatically set to `obfuscated`.

</Collapser>

<Collapser id="transaction_tracer-stack_trace_threshold" title="transaction_tracer.stack_trace_threshold">
Expand Down Expand Up @@ -792,10 +791,9 @@ The browser monitoring [page load timing](/docs/browser/new-relic-browser/page-l

</CollapserGroup>

## Application logging [#app-logging]
## Application Logging


The Ruby agent supports [APM logs in context](/docs/apm/new-relic-apm/getting-started/get-started-logs-context). For some tips on configuring logs for the Ruby agent, see [Configure Ruby logs in context](/docs/logs/logs-context/configure-logs-context-ruby).
Available logging-related config options include:

<CollapserGroup>

Expand Down Expand Up @@ -823,6 +821,45 @@ Available logging-related config options include:
If `true`, the agent captures log records emitted by your application.
</Collapser>

<Collapser id="application_logging-forwarding-log_level" title="application_logging.forwarding.log_level">
<table>
<tbody>
<tr><th>Type</th><td>String</td></tr>
<tr><th>Default</th><td>`"debug"`</td></tr>
<tr><th>Environ variable</th><td>`NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LOG_LEVEL`</td></tr>
</tbody>
</table>

Sets the minimum level a log event must have to be forwarded to New Relic.

This is based on the integer values of Ruby's `Logger::Severity` constants: https://github.com/ruby/ruby/blob/master/lib/logger/severity.rb

The intention is to forward logs with the level given to the configuration, as well as any logs with a higher level of severity.

For example, setting this value to "debug" will forward all log events to New Relic. Setting this value to "error" will only forward log events with the levels "error", "fatal", and "unknown".

Valid values (ordered lowest to highest):
* "debug"
* "info"
* "warn"
* "error"
* "fatal"
* "unknown"

</Collapser>

<Collapser id="application_logging-forwarding-custom_attributes" title="application_logging.forwarding.custom_attributes">
<table>
<tbody>
<tr><th>Type</th><td>Hash</td></tr>
<tr><th>Default</th><td>`{}`</td></tr>
<tr><th>Environ variable</th><td>`NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CUSTOM_ATTRIBUTES`</td></tr>
</tbody>
</table>

A hash with key/value pairs to add as custom attributes to all log events forwarded to New Relic. If sending using an environment variable, the value must be formatted like: "key1=value1,key2=value2"
</Collapser>

<Collapser id="application_logging-forwarding-max_samples_stored" title="application_logging.forwarding.max_samples_stored">
<table>
<tbody>
Expand Down Expand Up @@ -1155,7 +1192,7 @@ Available logging-related config options include:
<table>
<tbody>
<tr><th>Type</th><td>String</td></tr>
<tr><th>Default</th><td>`config/newrelic_audit.log`</td></tr>
<tr><th>Default</th><td>`log/newrelic_audit.log`</td></tr>
<tr><th>Environ variable</th><td>`NEW_RELIC_AUDIT_LOG_PATH`</td></tr>
</tbody>
</table>
Expand Down Expand Up @@ -1245,7 +1282,7 @@ see: https://docs.newrelic.com/docs/apm/agents/ruby-agent/features/ruby-codestre
</tbody>
</table>

<b>DEPRECATED</b> Please see: [distributed_tracing-enabled](/docs/agents/ruby-agent/configuration/ruby-agent-configuration#distributed_tracing-enabled).
<b>DEPRECATED</b> Please see: [distributed_tracing-enabled](docs/agents/ruby-agent/configuration/ruby-agent-configuration#distributed_tracing-enabled).

If `true`, enables [cross-application tracing](/docs/agents/ruby-agent/features/cross-application-tracing-ruby/) when `distributed_tracing.enabled` is set to `false`.
</Collapser>
Expand Down Expand Up @@ -1426,12 +1463,12 @@ Use these settings to toggle instrumentation types during agent startup.
If `true`, disables Active Support instrumentation.
</Collapser>

<Collapser id="disable_activerecord_instrumentation" title="disable_activerecord_instrumentation">
<Collapser id="disable_active_record_instrumentation" title="disable_active_record_instrumentation">
<table>
<tbody>
<tr><th>Type</th><td>Boolean</td></tr>
<tr><th>Default</th><td>`false`</td></tr>
<tr><th>Environ variable</th><td>`NEW_RELIC_DISABLE_ACTIVERECORD_INSTRUMENTATION`</td></tr>
<tr><th>Environ variable</th><td>`NEW_RELIC_DISABLE_ACTIVE_RECORD_INSTRUMENTATION`</td></tr>
</tbody>
</table>

Expand Down Expand Up @@ -2224,7 +2261,7 @@ Use these settings to toggle instrumentation types during agent startup.
</tbody>
</table>

Specify an Array of Rake tasks to automatically instrument. This configuration option converts the Array to a RegEx list. If you'd like to allow all tasks by default, use `rake.tasks: [.+]`. No rake tasks will be instrumented unless they're added to this list. For more information, visit the (New Relic Rake Instrumentation docs)[/docs/apm/agents/ruby-agent/background-jobs/rake-instrumentation].
Specify an Array of Rake tasks to automatically instrument. This configuration option converts the Array to a RegEx list. If you'd like to allow all tasks by default, use `rake.tasks: [.+]`. No rake tasks will be instrumented unless they're added to this list. For more information, visit the [New Relic Rake Instrumentation docs](/docs/apm/agents/ruby-agent/background-jobs/rake-instrumentation).
</Collapser>

<Collapser id="rake-connect_timeout" title="rake.connect_timeout">
Expand Down

0 comments on commit b793415

Please sign in to comment.