AppDynamics Application Intelligence Platform
This topic provides some guidance and examples of the correct syntax for using getter chains in AppDynamics configurations.
You can use getter chains to:
Note: If a getter chain calls on a method that does a lot of processing, such as making numerous SQL calls, it can degrade the performance of the application and the App Agent for Java. Ideally, use getter chains only with simple MBean gets.
An example of a simple getter would be just getting a property from a bean, such as getName().
The following special characters are used as separators:
For example, in the following getter chain, both the backslash (\) and the dot (.) are escaped.
The value passed in a getter chain is always a string unless cast to another type. The following supported types default to java.lang.String.
Getter chain with integer parameters in the substring method using the forward slash as the type separator:
Getter chain with various non-string parameter types:
Getter chain with forward slash escaped; escape character needed here for the string parameter:
Getter chain with an array element:
Getter chains that return Hashmap values:
Getter chain with multiple array elements separated by commas:
Getter chain retrieves property values, such as the length of an array:
Getter chain using backslash to escape the dot in the string parameter;
the call is getParam (a.b.c).
In the following getter chain, the first dot requires an escape character because it is in a string method parameter (inside the parentheses). The second dot does not require an escape character because it is not in a method parameter (it is outside the parentheses).
The getter chain splits on the API name, so the resulting split transactions are "API.abc", API."xyz" and so on.
The call gets the URI using getRequestURI() and then splits it using the escaped forward slash. From the resulting array it takes the third entry (as the split treats the first slash as a separator) and inserts what before the slash (in this case, nothing) into the first entry. Then it splits this result using the semicolon, getting the first entry of the resulting array, which in this case contains the API name.
Tip: When using string.split(), remember that it takes a regex and you have to escape any special regex characters.
For example, if you want to split on left square bracket ([):
In most cases bracesare not used to enclose getter chains in AppDynamics configurations. An exception is the use of a getter chain in a custom expression on the HTTPRequest object.
Custom expressions on the HTTP request are configurable in the Java Servlet Transaction Naming Configuration window and in the Split Transactions Using Request Data tab of the servlet custom match and exclude rules. In these cases, braces are required to delineate the boundaries of the getter chains.
Getter chains in custom expressions on the HTTP request in diagnostic data collector should also be enclosed in braces: