Attributes are key-value pairs containing information that determines the properties of an event or transaction. These key-value pairs can be viewed within transaction traces in APM, traced errors in APM, transaction events in dashboards, and page views in dashboards. You can customize exactly which attributes will be sent to each of these destinations.
These attribute settings apply to version 3.12.0 or higher of the Ruby agent.
The following table lists the attributes that can be automatically captured by the Ruby agent:
To capture additional custom attributes from your application, use
NewRelic::Agent.add_custom_attributes. For full reference see Collecting custom attributes. Defaults:
- Transaction traces: Enabled
- Error collector (traced errors): Enabled
- Transaction events: Enabled
- Page views (browser monitoring): Disabled
If you want to use your custom parameters or attributes in Insights, avoid using any of the reserved terms used by NRQL for naming them.
When upgrading to Ruby agent 3.12.0 or higher, upgrade your newrelic.yml configuration.
Additional documentation resources include:
- Agent attributes (types, destinations, and limits for attributes used by New Relic agents)
- Enabling and disabling attributes (properties, rules, and backwards compatibility information for Ruby agent attributes)
- Attribute examples (scenarios and results of enabling and disabling different Ruby agent attributes)