Organize and manage registered business transactions on the business transaction list to ensure that you are monitoring the most critical transactions. You can rename transactions, delete transactions, exclude transactions, or create custom transaction detection rules.

Especially for busy applications with lots of transactions, identify the best strategy for maximizing visibility into business-critical operations. Consider these strategies:

  • Set transaction detection priorities and delete old transactions to ensure that AppDynamics instruments your most important transactions.
  • Combine multiple transactions into rules and exclude unimportant transactions to ensure that you stay within the business transaction limits.
  • Rename transactions to informative names and group together similar transactions so that your metrics are easier to read.

Rename Business Transactions

The default BT name is based on the first two segments of a URI. See Business Transactions.

You can change the name for the business transaction by selecting the business transaction and choosing Rename from the More Actions menu. This change only affects the label for the business transaction in the user interface. You can also modify the default naming scheme for subsequently discovered business transactions, as described in the discussion on naming in Transaction Detection Rules. 

By default, AppDynamics uniquely names business transactions according to the tier name and entry point type, along with an internal name. When you rename a business transaction, ensure its new name is unique; otherwise, there will be multiple business transactions reporting metrics under the same name.

Group Business Transactions

A transaction group lets you collect multiple related transactions into a single organizational unit in the AppDynamics model of your environment. For example, you may wish to group business transactions all of which have entry points in a specific WAR file. Groups could also be used to collect transactions of a specific organization, region, or category.

After grouping transactions, you can see aggregate metrics for the group. Metrics for individual transactions that make up the group remain available.  

Grouping transactions does not affect the overall count of registered business transactions. To manage your transaction count, see Custom Match Rules.

To create a business transaction group:

  1. Select the transactions you want to group from the Business Transactions list. Use the control or shift keys to multi-select business transactions.
  2. Right-click the selected transactions and choose Create Group. 
  3. Give the group a name, verify the transactions you selected, and click Create Group. 
    Create Group

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.

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.