Before you configure the session agent, you must acquire the maximum available memory in the
Short Term Canister. This value is displayed as the
Max Ctree Bytes setting in the
Services Controls tab of the Canister configuration in TMS. Write this value down for later use.
To properly throttle the session agent, you must configure the appropriate data outflow to avoid the following problems:
- Canister unable to process hits to meet the incoming rate
- Running out of memory address space in the Short Term Canister
- ctree memory limit configured too close to the maximum address space
- For 32-bit systems, Experience Analytics does not support the use of the
/3GBoperating system switch.
- Using a 64-bit operating system enables access to more memory for the Short Term Canister.
Use the steps below to configure the outflow rate.
- In the Short Term Canister Thresholds section of the Extended Decouple session agent configuration, review the value for
Canister Max % Memory Used.Write this value down.
- In the Globals section of the Extended Decouple session agent configuration, set
ON. When set to
ON, basic throttling of hits to the canisters is enabled.
- Configure the
Outflow Control Modesetting, which manages how the session agent manages the maximum outflow rate. Set this figure to
Bytes, which pegs the outflow rate to the
Max Outflow Bytes Per Secondsetting.
Max Outflow Hits Per Secondto
Max Outflow Bytes Per Secondto the following formula:
Max Ctree Bytes * Canister Max % Memory Used + (Max Outflow Hits Per Second *60)
Canister Max % Memory Used, convert the value to a decimal. For example, a figure of 85% is inserted into the formula as
- If this value is greater than
Max Ctree Bytesvalue, then set the value to
Max Ctree Bytes- 1.