For general information on how the Python agent API calls relate to each other, see the API guide.

Prevents the current transaction from generating a transaction trace.


This call prevents the current transaction from producing a transaction trace.

You can use this if you have a recurring long-running transaction from which you rarely want to see a transaction trace. However, New Relic's algorithm for selecting transaction traces already de-prioritizes traces for transactions that have recently generated a trace. Thus, this call is not usually needed.

To un-suppress a previously suppressed transaction, you would use flag=False.

You can also prevent a transaction from producing traces with a WSGI environ dictionary. To do se, set the newrelic.suppress_transaction_trace key for the specific request in the WSGI environ dictionary passed by the WSGI server into the WSGI application being monitored.


Parameter Description



Optional. Default is True. If a transaction has been previously blocked from producing a trace, you can un-suppress it by setting the flag to False.

Return value(s)



Suppress transaction trace

In this example, you have some URLs or views where your customers often upload files. These frequently slow transactions generate transaction traces more often than is useful, and you'd like to disable transaction traces on these so you will receive more relevant traces.

To disable traces for these transactions, run the following where the transaction is being executed:

import newrelic.agent

For more help

If you need more help, check out these support and learning resources: