An Egress Throttle Group is a collection of Diameter Connections or Peers, or both, that are logically grouped together to monitor Egress Message Rate and Pending Transactions for multiple Peers and Connections across multiple DA-MPs on a Network Element. If a Peer is assigned to the Egress Throttle Group, then all Diameter Connections to that Peer are implicitly part of the Egress Throttle Group.
ETG Rate Limiting and Pending Transaction Limiting throttling are done for Request Messages only.
Note:
The Per Connection Egress Message Throttling and User-Configurable Connection Pending Transaction Limiting features for Egress Message Throttling are defined at a single Diameter Connection level and are local to each DA-MP. These features are described in Per Connection Egress Message Throttling and User Configurable Connection Pending Transaction Limiting.Egress Message Rate controls are used to throttle traffic levels to a set of Diameter Nodes so that the cumulative rate of traffic is controlled. EMR controls are across a set of configured connections and/or peers.
Egress Pending Transactions controls are used to control the maximum number of Pending Requests that can be sent to a set of Diameter Nodes. This can be used for load-balancing when a network element is not responding at expected rates, and limits the total number of Requests that can be pending to a set of Diameter Nodes. EPT controls are across a set of connections and/or peers, and are cumulative across all DA-MPs.
Egress Throttle Groups Description
Egress Throttle Groups are implemented as part of the Diameter Routing Function.
An Egress Throttle Group is independent of a Route Group (Connection Route Group or Peer Route Group). The members of an Egress Throttle Group may or may not be same as defined in a Route Group; there is no defined relationship between Egress Throttle Groups and Route Groups.
The Egress Message Rate throttling is controlled by the configured maximum Egress Message Rate (EMR) on an aggregated basis and the Egress Throttle Group - Rate Limiting Congestion Level (ETG-RCL) (range: CL-0- CL-3) for the ETG.
The Egress Pending Transaction Limiting throttling is controlled by the configured maximum Egress Pending Transactions (EPT) on an aggregated basis and the Egress Throttle Group - Pending Transaction Limiting Congestion Level (ETG-PCL) (range: CL-0- CL-3) for the ETG.
A maximum of 5 congestion levels (CL-0 to CL-3 and CL-98) is supported, which indicates the Congestion Level of a resource. CL0 indicates the resource has no congestion, and CL-98 indicates the resource is completely blocked. CL-1, CL-2, and CL-3 indicate increasing levels of congestion.
Egress Throttle Groups (ETG) can be configured in Diameter Configuration; each Egress Throttle Group has its own Congestion Level states based on its configuration.
As the Egress Throttle Group's Congestion Level increases, Message Priority becomes a factor in determining if a message can be routed to a member of the Egress Throttle Group, or is throttled. Requests with Message Priority less than Congestion Level is not routed to any member of the Egress Throttle Group.
Diameter Request messages are assigned a Message Priority 0, 1, or 2; Answers always have Priority 3. The Priority of the Request message controls when an ETG performs throttling is shown in Table 14-7.
Table 14-7 Message Priority and ETG Congestion Level
Request Message Priority | When Permitted to route to Member of ETG |
---|---|
0 | Congestion Level 0 |
1 | Congestion Level 0, 1 |
2 | Congestion Level 0, 1, 2 |
4 NGN-PS as Request Message Priority | Congestion Level 0, 1, 2, and 3 |
When the EMR for an Egress Throttle Group reaches the Egress Throttle Group Maximum Egress Request Rate or the Egress Throttle Group's Pending Transactions reaches the Egress Throttle Group's Maximum Egress Pending Requests, no Requests are routed to any members of the Egress Throttle Group.
Egress Throttle Group Rate Limiting
The ETG Message Rate Controls are optional, but if defined and enabled, then ETG Message Rate Congestion level is updated as indicated in Table 14-8.
Table 14-8 ETG Message Rate Congestion Levels Based on Threshold
Onset and Abatement Thresholds | ETG Rate Congestion Level (ETG-RCL) Impact |
---|---|
Onset Threshold-3 (OT-3) | When ETG rate exceeds Threshold, set ETG-RCL = CL-3 |
Abatement Threshold-3 (AT-3) | When ETG rate falls below Threshold, set ETG-RCL = CL-2 |
Onset Threshold-2 (OT-2) | When ETG rate exceeds Threshold, set ETG-RCL = CL-2 |
Abatement Threshold-2 (AT-2) | When ETG rate falls below Threshold, set ETG-RCL = CL-1 |
Onset Threshold-1 (OT-1) | When ETG rate exceeds Threshold, set ETG-RCL = CL-1 |
Abatement Threshold-1 (AT-1) | When ETG rate falls below Threshold, set ETG-RCL = CL-0 |
In an Egress Throttling Group, if Maximum Egress Request Rate is configured, then OT-1 and AT-1 thresholds must be configured. OT-2, AT-2, OT-3 and AT-3 are optional but must be configured in pairs; for example, if OT-2 is configured, AT-2 must also be configured. Finally, AT-3 must be configured if OT-3 is expected to be configured.
The EMR is calculated every 15ms by subtracting the difference between current traffic count and traffic count convergence time ago.
EMR onset requires only one EMR sample to exceed an onset threshold to advance the ETG-RCL. Multi-step throttling is supported. For example, the EMR Congestion Level can be increased from CL-0 to CL-1, CL-2, or CL-3 after one EMR sample period. This allows for a rapid response to traffic load increases while taking a more conservative approach to traffic load decreases.
Only single step abatement is supported. For example CL-3 - CL-2 abatement is supported but not CL-3 - CL-1.
Rate Limiting must be enabled on the
GUI page before Egress Message Rate throttling can be started for Egress Throttle Groups. If Rate Limiting is enabled, then any routable Request message sent to a Peer or Connection on any DA-MP on that NE contained in the ETG is used for rate calculation purposes. (Diameter management messages such as CER/CEA, DWR/DWA, and DPR/DPA are not counted in the egress message rate.)Egress Throttle Group Pending Transaction Limiting
Table 14-9 ETG Pending Transaction Congestion Levels Based on Threshold
Onset and Abatement Thresholds | ETG Pending Transaction Congestion Level (ETG-PCL) Impact |
---|---|
Onset Threshold-3 (OT-3) | When ETG Pending Transactions exceeds Threshold, set ETG-PCL = CL-3 |
Abatement Threshold-3 (AT-3) | When ETG Pending Transactions falls below Threshold, set ETG-PCL = CL-2 |
Onset Threshold-2 (OT-2) | When ETG Pending Transactions exceeds Threshold, set ETG-PCL = CL-2 |
Abatement Threshold-2 (AT-2) | When ETG Pending Transactions falls below Threshold, set ETG-PCL = CL-1 |
Onset Threshold-1 (OT-1) | When ETG Pending Transactions exceeds Threshold, set ETG-PCL = CL-1 |
Abatement Threshold-1 (AT-1) | When ETG Pending Transactions falls below Threshold, set ETG-PCL = CL-0 |
In an Egress Throttling Group, if Maximum Egress Pending Transactions is configured, then OT-1 and AT-1 thresholds must be configured. OT-2, AT-2, OT-3 and AT-3 are optional but must be configured in pairs; for example, if OT-2 is configured, AT-2 must also be configured. Finally, AT-3 must be configured if OT-3 is expected to be configured.
The local sample of number of pending Transactions to an ETG is periodically collected and sent to the DA-MP Leader for aggregation. The aggregated value is then sent back to each DA-MP for threshold and abatement calculation.
The EPT Abatement Time is the amount of time that egress Pending Transactions must remain below an abatement level before allowing it to abate to a lower Congestion Level.
Pending Transaction Limiting must be enabled Maintenance GUI before Egress Pending Transaction Limiting can be started for Egress Throttle Groups. If Egress Pending Transaction Limiting is enabled, then any pending Request sent to a Peer or Connection on any DA-MP on that NE contained in the Egress Throttle Group is used for Pending Transaction Limiting calculation.
Diameter Configuration for Egress Throttle Groups
Egress Throttle Groups are used to perform 2 functions: Rate limiting and Pending Transaction Limiting. Each of the functions are independent of each other and can be optionally configured and controlled separately.
The
GUI pages provide fields for configuring each function. Each function, if configured in the system, must have its Admin State changed to Enabled on the GUI page.Egress Throttle Groups configuration procedures are provided in Diameter Egress Throttle Groups.
Egress Throttle Groups maintenance information and procedures are provided in Diameter Maintenance Egress Throttle Groups.