L7 Latency Thresholding
The L7 latency thresholding feature in HDX Insight actively detects end-to-end network latency issues at the application level and takes proactive actions. The L7 latency thresholding feature performs live latency monitoring to detect the spikes and sends out notifications to HDX Insight if the latency exceeds the minimum observed latency.
Previously, average client side and server side L7 latency values were sent every 60 sec to HDX Insight. Any spikes seen within this interval were averaged out and hence remained undetected. Also, there was no live latency monitoring to detect these spikes.
How L7 latency is different from L4 latency
Network latencies are captured and displayed at the L4 level as well. These latencies are calculated from the TCP layer and do not require parsing of the ICA traffic. Therefore, they are relatively easy to obtain and are less CPU intensive. However, the major drawback of L4 latency is understanding end-to-end latency. If there are TCP proxies in the path, the L4 latency captures only the latency from the Citrix ADC to the TCP proxy. This might result in incomplete information and hence result in difficulties in debugging the issue.
L7 latency is calculated by parsing ICA traffic. L7 latency calculation is done at the ICA layer, and therefore intermediate proxies do not result in incomplete latency values. Thus, provides end-to-end latency detection.
The following figures display a deployment type with and without TCP proxies.
Difference between ICA RTT and L7 latency calculations
ICA RTT represents the total round trip time from the Citrix Workspace app to Virtual Delivery Agent (VDA). L7 latency provides granular details regarding latencies on the client side and the server side. L7 client latency is the latency between Citrix Workspace app to Citrix Gateway. L7 Server latency is the latency between Citrix Gateway to VDA.
Note: Server side L7 latency calculation for the server is supported only for the Citrix Virtual Apps and Desktops versions 7.13 and later.
Configure L7 latency thresholding using the CLI
Add an ICA latency profile.
add ica latencyprofile
[-l7LatencyMonitoring ( ENABLED | DISABLED )] [-l7LatencyThresholdFactor ] [-l7LatencyWaitTime ] [-l7LatencyNotifyInterval ] [-l7LatencyMaxNotifyCount ] Add an ICA action.
add ica action
[-latencyprofileName ] Add an ICA policy.
add ica policy
-rule -action [-comment ] [-logAction Bind ICA policy to the VPN server or to the ICA global bind point.
bind ica global -policyName
-priority [-gotoPriorityExpression ] [-type ( ICA_REQ_OVERRIDE | ICA_REQ_DEFAULT )] Or
bind vpn vserver
-policy [-priority ] Or
bind cr vserver
-policy [-priority ]
Arguments
Latency Monitoring: Parameter to enable or disable L7 threshold monitoring. When this parameter is enabled, notifications are sent to HDX Insight when the set conditions are met.
Default value: DISABLED
LatencyThresholdFactor: Factor by which the active latency must be greater than the minimum observed latency to conclude that the threshold is exceeded and therefore notification must be sent to HDX Insight.
Default value: 4
Minimum value: 2
Maximum value: 65535
LatencyWaitTime: Time in seconds for the appliance to wait after the latency threshold is exceeded to send notification to HDX Insight.
Default value: 20
Minimum value: 1
Maximum value: 65535
LatencyNotifyInterval: Time interval in seconds for the appliance to send subsequent notifications to HDX Insight after the wait time has passed.
Default value: 20
Minimum value: 1
Maximum value: 65535
LatencyMaxNotifyCount: Maximum number of notifications that can be sent to HDX Insight within an interval where the latency is above the threshold.
Default value: 5
Configure L7 latency thresholding using the GUI
Navigate toConfiguration>NetScaler Gateway>Policies>ICA.
SelectICA Latency Profilestab and clickAdd.
In theCreate ICA Latency Profilepage, perform the following.
- SelectL7 Latency Monitoringto enable L7 Threshold monitoring.
- InL7 Threshold Factor, enter the value by which the active latency must exceed the minimum observed latency to send notification to HDX Insight.
- InL7 Latency Wait Time, enter the time in seconds for the appliance to wait after the threshold is exceeded to send out a notification to HDX Insight.
- InL7 Latency Notification Interval, enter the time in seconds for the appliance to send subsequent notifications to HDX Insight after the wait time has passed.
- InL7 Latency Maximum Notify Count, enter the maximum number of notifications that can be sent to HDX Insight within an interval where the latency is above the threshold.Note:The L7 latency maximum notify count is applicable once the threshold is exceeded and is reset when the active latency falls below the threshold. Periodicity of these notifications is governed by the notification interval.
ClickCreate.
Important:
After configuring the L7 latency threshold parameters, you must configure HDX Insight. For details, seeConfigure Citrix Gateway to support HDX Insight.
View L7 latency parameters in Citrix ADM
To view the L7 latency parameters in Citrix ADM, navigate toAnalytics > HDX Insight > ApplicationsorAnalytics > HDX Insight > Users.
Parameter to specify a time interval for L7 client latency value calculation
From Citrix ADC release 12.1 build 63.20 and later, you can specify a time interval, in seconds, for which the L7 client latency value is to be calculated. This configuration is required if you have enabled L7 latency and the ICA latency of a session is incorrectly recording as 64,000 ms.
To set the latency frequency by using the CLI
At the command prompt, type;
set ica parameter -L7LatencyFrequency
Example:
set ica parameter -L7LatencyFrequency 5
To view the L7 latency frequency, at the command prompt, type;
show ica parameter
To unset or disable the L7 latency frequency, at the command prompt, type:
unset ica parameter -L7LatencyFrequency
Note:By default, the L7 client latency is calculated for every packet. The default value ofL7LatencyFrequency
parameter is 0, minimum value 0, and maximum value is 60.
To set the latency frequency by using the CLI
- Navigate toSystem > Settings > Change ICA Parameters.
- InL7 Latency Frequency, enter the time interval for which the L7 client latency value is to be calculated.
L7 Latency measurement model
In the L7 latency measurement module, average client side and server side L7 latency values are sent to HDX Insight every 60 seconds. As a result, spikes seen within this interval are averaged out and hence remain undetected. Also, the L7 latency measurement module does not have the live latency monitoring capability.
The following figure illustrates a sample L7 latency measurement model.
L7 latency threshold reporting model
The L7 latency threshold reporting model has the live latency monitoring capability to detect spikes. Notifications are sent to HDX Insight if the latency exceeds the minimum observed latency.
Whenever a threshold factor is exceeded, latency increase is detected. After the configured threshold wait time expires, a notification is sent to HDX Insight. A subsequent notification is sent to HDX Insight after the wait time has expired and the threshold factor is still exceeded. In case the latency value falls below the threshold factor before the wait time expires, no notification is sent to HDX Insight.
The following figure illustrates a sample L7 latency threshold reporting model.
以下参数可以在运行配置time:
- Threshold monitoring (ON/OFF)
- Threshold factor
- Threshold wait time
- Notification interval
- Maximum notification count