Download page Transaction Detection Rules.
Transaction Detection Rules
AppDynamics uses different types of transaction detection rules to define entry points and name business transactions:
- Automatic transaction discovery rules include the default entry point types and naming configuration for each app agent type.
- Custom match rules offer finer control over transaction discovery and naming for a single entry point type.
In many cases, the built-in rules yield a useful set of business transactions. If not, you can create new rules or edit the existing rules to optimize the transaction detection for your environment.
The Configure Transaction Detection permission is needed to customize transaction detection rules.
The View Sensitive Data permission, In combination with the Configure Transaction Detection permission, enables the use of Live Preview and Business Transaction Discovery features to stream live data from your application.
For Java and .NET environments, you can use interactive live preview tools to find business transaction entry points:
Business transaction discovery sessions stream live data from the node to the Controller UI to help you make instrumentation decisions. These sessions display transactions based on all transaction detection rules active for the node.
- For certain types of entry points, custom match rule live preview enables you to preview transactions based on applying a single transaction detection rule on a node.
Business transactions within the context of the Live Preview, called transient transactions, do not persist after the Live Preview ends. Business transaction discovery sessions let you apply or discard rule changes when you end the session. Custom match live preview rules apply after you save the rule.
Some transient transactions may invoke exit calls to the same node where the Live Preview session is running. In certain cases, the agent may discover additional transient transactions and uninstrumented code on the downstream segment:
- The exit call and corresponding entry point are automatically discovered exit and entry points like HTTP or Web Service.
- Rare cases of custom activity in-process calls.
Manage Transaction Detection Rules
To customize transaction detection rules in the Controller UI, go to Configuration > Instrumentation. From the Business Transactions list, you can also click Configure to quickly access Transaction Detection settings.
You apply transaction detection rules to tiers using the flexible scope configuration model. From the Transaction Detection tab, you can manage rules as follows:
- Manage rules for individual scopes on the Transaction Detection tab.
- Manage rules application-wide on the Rules sub-tab. The Rules sub-tab also shows you the tiers where rules are applied and according to which scope.
- View or modify the rules for specific tiers on the Tiers sub-tab.
To modify an existing rule, you can double-click it to display the Rule Editor. Click +/Add to define a new rule.
Use Live Preview button to start a Business Transaction Discovery session for nodes running the Java and .NET Agent.
Transaction Detection Rule Priorities
AppDynamics app agents apply transaction detection rules of the same type in the following order of precedence:
- Rule priority from highest to lowest. A priority of 0 is the lowest priority possible.
- Creation date from oldest to newest.
For example, consider an HTTP request that matches a priority 2 custom match rule and a priority 6 custom match rule. The agent applies the priority 6 rule.
When an incoming request matches more than one type of detection rule, AppDynamics applies the detection rules in the following order of precedence:
- Custom match include rules according to the include rule priority. If the request matches an include rule, the agent names the business transaction based on the rule.
Custom match exclude rules according to the exclude rule priority. If the request matches an exclude rule, the app agent excludes the transaction from discovery.
Default automatic detection rules. If the request matches a default automatic detection rule, it names the transaction according to the auto-detection naming scheme.
If two entry point types have the same priority where either can be used to define or register an entry point, then there is some precedence between them.
For example: If in Java just the Java Automatic Discovery Rule with all types is enabled, and there are entry points which can be considered as Web Services or Servlets - then the Servlets will take priority - a higher priority rule is needed if Web Services are the desired default.
To view the default order of transaction detection rules for a tier:
- Navigate to Configuration > Instrumentation > Transaction Detection > Tiers.
- Click a tier to see the rules ordered by precedence and priority.
For Java and .NET, you can set the
check-bt-excludes-early node property to "true" to configure the app agent to evaluate custom match exclude rules before custom match include rules. This is a node-based configuration and does not affect the display order of rules in the Controller UI.
Export Detection Rules
You can migrate the rules between applications and tiers using the Controller API. See Configuration Import and Export API.