Starting Your Product › Configure the Cross-Enterprise APM Agent › Configure Transaction Sampling

Configure Transaction Sampling

Transaction sampling enables CA Introscope agents to take a transaction trace occasionally without having an explicit transaction trace session running. The sampling does not apply any filtering and wakes up on a timer to take the sample. The samples are visible from the Workstation.

Important! The sampled traces are only visible from the Workstation Investigator metric tree traces tab. The traces do not show in the Transaction Trace Viewer of a transaction trace session.

Trace samples that are taken from a front-end agent automatically attempt to generate correlated cross-process back-end transaction traces. Samples that are generated directly from the agent do not always have correlated front-end traces.

Follow these steps:

1. Configure each front-end agent making the following edits to the IntroscopeAgent.profile file in the <Agent_Home>\wily\core\config directory. This configuration controls the front-end sampling and the generation of correlated back-end traces that go with them.

   introscope.agent.transactiontracer.sampling.enabled

   Enables or disables the transaction sampling. If this parameter is set to false, the other parameters are ignored.

   Default: true

   introscope.agent.transactiontracer.sampling.interval.seconds

   Specifies when the transaction sample is captured.

   Default: Value in IntroscopeEnterpriseManager.properties

   introscope.agent.transactiontracer.sampling.perinterval.count

   Specifies the number of samples that are captured in a transaction sampling interval.

   Default: Value in IntroscopeEnterpriseManager.properties

2. Configure the Cross-Enterprise APM Agent by opening the Introscope_Cross-Enterprise_APM.profile file, at /root/C7C4960/Cross-Enterprise_APM/config. This configuration generates back-end samples independent of any front-end samples being taken. These samples are the only back-end samples that are labeled as the trace type, Sampled.

   introscope.sysview.agent.transactiontracer.sampling.enabled

   Enables or disables the transaction sampling. If this parameter is set to false, the other parameters are ignored.

   Default: true

   introscope.sysview.agent.transactiontracer.sampling.interval.seconds

   Specifies when the transaction sample is captured.

   Default: 120 seconds

   Limits: 1 second up to 300 seconds (5 minutes)

   introscope.sysview.agent.transactiontracer.sampling.perinterval.count

   Specifies the number of samples that are captured in a transaction sampling interval.

   Limits: 1 to 1000

   Default: 15

After you start or restart the Cross-Enterprise APM Agent, the new settings are applied.