Configuration used to configure transaction tracing. More...

Data Fields
bool	enabled
	Whether to enable transaction traces. More...

newrelic_transaction_tracer_threshold_t	threshold
	Whether to consider transactions for trace generation based on the apdex configuration or a specific duration. More...

newrelic_time_us_t	duration_us
	If the SDK configuration threshold is set to NEWRELIC_THRESHOLD_IS_OVER_DURATION, this field specifies the minimum transaction time before a trace may be generated, in microseconds. More...

newrelic_time_us_t	stack_trace_threshold_us
	Sets the threshold above which the New Relic SDK will record a stack trace for a transaction trace, in microseconds. More...

struct {
bool enabled
	Controls whether slow datastore queries are recorded. More...

newrelic_tt_recordsql_t record_sql
	Controls the format of the sql put into transaction traces for supported sql-like products. More...

newrelic_time_us_t threshold_us
	Specify the threshold above which a datastore query is considered "slow", in microseconds. More...

}	datastore_reporting
	The datastore_reporting field of newrelic_transaction_tracer_config_t is a collection of configuration values that control how certain characteristics of datastore queries are recorded.

Detailed Description

Configuration used to configure transaction tracing.

Field Documentation

◆ duration_us

newrelic_time_us_t newrelic_transaction_tracer_config_t::duration_us

If the SDK configuration threshold is set to NEWRELIC_THRESHOLD_IS_OVER_DURATION, this field specifies the minimum transaction time before a trace may be generated, in microseconds.

Default: 0.

Examples: ex_custom.c, ex_datastore.c, ex_distributed_tracing_client.c, ex_distributed_tracing_server.c, ex_external.c, ex_segment.c, and ex_timing.c.

◆ enabled

bool newrelic_transaction_tracer_config_t::enabled

Whether to enable transaction traces.

Controls whether slow datastore queries are recorded.

Default: true.

If set to true for a transaction, the transaction tracer records the top-10 slowest queries along with a stack trace of where the call occurred.

Default: true.

◆ record_sql

newrelic_tt_recordsql_t newrelic_transaction_tracer_config_t::record_sql

Controls the format of the sql put into transaction traces for supported sql-like products.

Only relevant if the datastore_reporting.enabled field is set to true.

If set to NEWRELIC_SQL_OFF, transaction traces have no sql in them.
If set to NEWRELIC_SQL_RAW, the sql is added to the transaction trace as-is.
If set to NEWRELIC_SQL_OBFUSCATED, alphanumeric characters are set to '?'. For example 'SELECT * FROM table WHERE foo = 42' is reported as 'SELECT * FROM table WHERE foo = ?'. These obfuscated queries are added to the transaction trace for supported datastore products.

Warning: New Relic highly discourages the use of the NEWRELIC_SQL_RAW setting in production environments.

Default: NEWRELIC_SQL_OBFUSCATED.

◆ stack_trace_threshold_us

newrelic_time_us_t newrelic_transaction_tracer_config_t::stack_trace_threshold_us

Sets the threshold above which the New Relic SDK will record a stack trace for a transaction trace, in microseconds.

Default: 500000, or 0.5 seconds.

◆ threshold

newrelic_transaction_tracer_threshold_t newrelic_transaction_tracer_config_t::threshold

Whether to consider transactions for trace generation based on the apdex configuration or a specific duration.

Default: NEWRELIC_THRESHOLD_IS_APDEX_FAILING.

Examples: ex_custom.c, ex_datastore.c, ex_distributed_tracing_client.c, ex_distributed_tracing_server.c, ex_external.c, ex_segment.c, and ex_timing.c.

◆ threshold_us

newrelic_time_us_t newrelic_transaction_tracer_config_t::threshold_us

Specify the threshold above which a datastore query is considered "slow", in microseconds.