current_transaction

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

newrelic.agent.current_transaction(active_only=True)
Returns an object corresponding to the current transaction.

Description

Use current_transaction to retrieve the object representing the current transaction. It will return None if there is no active transaction.

Parameters

Parameter Description

active_only

boolean

Optional. Default is True, meaning it will only return active transactions. If set to False, the call is capable of returning a transaction that has ended or stopped (for example, if end_of_transaction was used).

Return value(s)

Returns a transaction object corresponding to current transaction. Returns None if there is no active transaction.

Example(s)

Get the current transaction

import newrelic.agent

@newrelic.agent.background_task()
def main():
    transaction = newrelic.agent.current_transaction()

For more help

Recommendations for learning more: