Delete or Exclude Business Transactions

Excluding and deleting business transactions reduce the business transaction registration count. You can choose to exclude a short-lived business transaction temporarily or delete a stale business transaction permanently.

Exclude a Business Transaction

In effect, excluding the transaction disables the business transaction for metric processing purposes; it works even if the processing path that the business transaction represents remains active in the monitored application. Both serve to reduce the business transaction count considered against transaction registration limits.

Note: Excluding a business transaction in the business transaction list is not to be confused with using custom exclude rules to control business transaction detection. While the two approaches achieve similar goals, custom exclude rules operate at the transactions detection point and are most useful for preventing discovery and registration of a range or multiple ranges of business transactions at a time. See Custom Match Rules for more information.

To exclude a business transaction:

  1. Select your transaction from the list of business transactions.
  2. Right-click the selection and click Exclude Transactions.
  3. On the Exclude Business Transactions page, select the transaction and click Exclude Transactions.

Restore an Excluded Business Transaction

When you exclude a business transaction, the accumulated metrics for the transaction along with its underlying configuration is retained. You can restore the excluded transaction, if required.

  1. From the Business Transactions page, click Actions > View Excluded Transactions.
  2. From the Excluded Business Transactions page, select your transaction, and click Unexclude Selected.

Delete a Business Transaction

When you delete a business transaction from the list, the accumulated transaction metrics are removed. However, the deleted transaction is rediscovered if the corresponding function in the application is used. To delete a business transaction permanently, modify the discovery rules before deleting a transaction, so that the deleted transaction is not rediscovered.

A business transaction can be considered stale in these scenarios:

  • You have decommissioned an application, and you want to delete the historical data associated with business transactions that made up the application.
  • You have changed business transaction discovery rules to either eliminate or reorganize business transactions and need to remove unwanted or otherwise obsolete business transactions.

To delete a business transaction:

  1. Select your transaction from the list of business transactions.
  2. Right-click the selection and click Delete Transactions.
  3. From the Delete Business Transactions page, select the transaction and click Delete Business Transactions.

Automatic Cleanup of Stale Business Transactions

Automatic cleanup keeps less active transactions from cluttering your business transaction list. Enabling automatic cleanup deletes business transactions that are flagged as stale. You can set the activity threshold for a business transaction after which the transaction is considered stale.

To configure automatic cleanup threshold:

  1. From the left pane, click Configuration > Instrumentation > Transaction Detection > More.
  2. Under Business Transaction Automatic Cleanup, check Enable Business Transaction Automatic Cleanup.
  3. Update the automatic cleanup threshold that qualifies a business transaction as stale:
    1. Specify your threshold time in, Monitor Business transactions for __ minutes since creation.
    2. Specify the number of calls in, Remove Business transactions that have less than or equal to __ calls.

Since creation, a business transaction is monitored for 15 minutes when automatic cleanup is enabled with default settings. If there are no calls reported within the first 15 minutes since the business transaction is registered, the business transaction is qualified as short-lived and the automatic cleanup deletes that business transaction. Automatic cleanup keeps a business transaction intact if it is reporting data for days.

However, automatic cleanup ignores the business transactions that are:

  • Marked as Permanent
  • Older than three days

Business Transaction Purger

There are Controller configurations for the business transaction purger:

  • max.bt.to.purge.per.execution : the number of business transactions that can be purged when the purger executes once. The default is 1000, min is 0, and the max is 100000.
  • max.bt.to.purge.per.transaction : in order to reduce db lock, the purger tries to purge business transactions in multiple transactions if there are too many business transactions to purge in each execution. This configuration specifies the number of business transactions that can be purged in each transaction. The default is 10, min is 0, and the max is 1000.