Agents › DevTest Java Agent › Java Agent Usage › Java Agent Extensions › Adding Tags to Transaction Frames

Adding Tags to Transaction Frames

You can associate a transaction frame with arbitrary key/value pairs. The key/value pairs are known as tags.

TransactionFrame objects provide a setTag() method. The method has two string arguments: the key and the value.

The following code shows how to add a tag from within the postProcess() method of an agent extension:

// somewhere in postProcess
frame.setTag("tagname", "tagvalue");

For example, you can create an extension that upon login to a web site grabs the value of the request parameter username and calls frame.setTag("username", value).

The tags are stored in the FRAME_TAGS table in the database.

You can filter by tags in the CAI Console. For more information, see Using CA Continuous Application Insight.