Maintenance outage for upgrade on Sunday, September 22

This site, docs.bmc.com, will be inaccessible for two hours starting at 8 AM CDT, Sunday, September 22, for a platform upgrade.

  • Spaces
  • People
  • Help
    • BMC Support Central BMC Communities BMC.com
    ×
    BMC TrueSight App Visibility Manager 10.7

      Page tree
      Skip to end of metadata
      Go to start of metadata

      This topic describes the configuration parameters to persist transactions that have tags in the headers.

      If you use an external monitoring application that can tag transaction headers, App Visibility can provide a detailed view of specially tagged transactions. Transactions with matching tags are persisted, regardless of sampling or threshold configuration.

      Warning

      To prevent adverse system performance, use tagging on a very limited number of transactions.

      Related topics

      Modifying an App Visibility agent policy

      Configuring an App Visibility agent policy to collect and monitor application information

      Integrating

       

      The following table describes the parameters used to list the tags and persist transactions.

      Parameters that control the persistence of tagged transactions

      ParameterDefault valueDescription

      persisting.tagged.request.instances

      		trueWhen true, the agent persists transactions with headers that match the value or values of the persisting.tag.header.names parameter
      persisting.tag.header.names

      X-BMCFollowTX-1.0.00

      Includes predefined HTTP header tags. Separate more than one tag with a comma.

      The default value is set to capture synthetic transactions from BMC TM ART.

      integration.tag.header.name

      integration.tag.request.parameter.name

      integration.tag.cookie.name

      		 

      Enter a value for one of the integration.tag parameters (header, request parameter, or cookie) to enable the agent to persist transactions with matching tags. The agent provides a mechanism to create a hyperlink directly to the Trace Details page.

      Note: If more than one value is entered, only the first tag with a value is used, per request.

      The value of the integration tag must conform to the following characteristics:

      • The tag value can be up to 255 characters. Longer values are truncated.
      • The tag value cannot contain non-ASCII characters that result in URL encoding.
      • The tag value must be unique. If more than one transaction has the same tag value, you might not see the transaction of interest.

      Access the  tagged request  with a hyperlink built according to the following syntax:

      https://<consoleHost>/console-adops/view/singlerequest/
singlerequestdetails.jsf?tag=<yourTagValue>
      • <consoleHost> is the host name or IP address of the TrueSight console.
      • <yourTagValue> is the value of the header, request name, or cookie integration tag.
      © Copyright 2005-2019 BMC Software, Inc.