Attributes are key-value pairs containing information that determines the properties of an event or transaction. These key-value pairs can help you gain greater insight into your application and annotate the data in New Relic. Both default and custom attributes are visible in APM transaction traces, distributed traces, and error analytics; and APM and browser events .
You can customize exactly which attributes will be sent to each of these destinations. Read on to learn about the PHP agent attributes, how to enable or disable them, and the rules the agent follows to determine which attributes to include or exclude for a destination .
PHP agent attributes In addition to the default APM attributes , you can configure the following attributes in the PHP agent. See PHP agent (newrelic.ini) settings and Enabling and disabling attributes for more information.
response.statusCodeThe response status code for a web request.
Defaults:
Transaction traces: Enabled Error collector (traced errors): Enabled Transaction events: Enabled Page views (browser monitoring ): Unavailable newrelic_add_custom_parameter API callAttributes added to an newrelic_add_custom_parameter() call on the New Relic API.
Defaults:
Transaction traces: Enabled Error collector (traced errors): Enabled Transaction events: Enabled Page views (browser monitoring): Enabled The types as read from the HTTP Accept request header.
Defaults:
Transaction traces: Enabled Error collector (traced errors): Enabled Transaction events: Enabled Page views (browser monitoring): Unavailable The incoming request content-type as read from the Content-Type request header.
Defaults:
Transaction traces: Enabled Error collector (traced errors): Enabled Transaction events: Enabled Page views (browser monitoring): Unavailable The incoming request size in bytes as read from the Content-Length request header.
Defaults:
Transaction traces: Enabled Error collector (traced errors): Enabled Transaction events: Enabled Page views (browser monitoring): Unavailable The name from the HTTP host request header.
Defaults:
Transaction traces: Enabled Error collector (traced errors): Enabled Transaction events: Enabled Page views (browser monitoring): Unavailable The incoming request referer as read from the Referer request header.
Defaults:
Transaction traces: Disabled Error collector (traced errors): Enabled Transaction events: Disabled Page views (browser monitoring): Unavailable request.headers.userAgentThe contents of the User-Agent HTTP header.
Defaults:
Transaction traces: Enabled Error collector (traced errors): Enabled Transaction events: Disabled Page views (browser monitoring): Unavailable request.methodThe HTTP method of the incoming request.
Defaults:
Transaction traces: Enabled Error collector (traced errors): Enabled Transaction events: Enabled Page views (browser monitoring): Unavailable request.parameters.\*Request parameters from the transaction.
Tip The capture_params property has been deprecated. However, if set to true, it will enable request parameters for transaction traces and traced errors.
Defaults:
Transaction traces: Disabled Error collector (traced errors): Disabled Transaction events: Disabled Page views (browser monitoring): Unavailable request.uriThe request URI from the transaction.
Defaults
Transaction traces: Enabled Error collector (traced errors): Enabled Transaction events: Enabled Page views (browser monitoring): Unavailable The outgoing response size in bytes as read from the Content-Length response header.
Defaults:
Transaction traces: Enabled Error collector (traced errors): Enabled Transaction events: Enabled Page views (browser monitoring): Unavailable The outgoing response content-type as read from the Content-Type response header.
Defaults:
Transaction traces: Enabled Error collector (traced errors): Enabled Transaction events: Enabled Page views (browser monitoring): Unavailable SERVER_NAMEThe name of the server host under which the current script is executing.
Defaults
Transaction traces: Enabled Error collector (traced errors): Enabled Transaction events: Disabled Page views (browser monitoring): Disabled Change where attributes are sent Tip All destinations are open to attribute collection by default in the PHP agent, except newrelic.browser_monitoring.attributes.enabled.
To change which attributes are sent to New Relic destinations :
Open or close any destination to attribute collection by changing the .enabled destination property
Change the default attribute setting by adding the attribute name to the destination's .include or .exclude properties
See Attribute rules for which settings supersede each other.
Upgrading the PHP agent When upgrading to PHP agent 4.9 or higher, upgrade your configuration file. For more information about deprecated properties, see Enabling and disabling attributes .