Go to primary content
User Data Repository Diameter User's Guide
Release 12.4
E92984-01
Go To Table Of Contents
Contents

Previous
Previous
Next
Next

Diameter Maintenance Egress Throttle Groups

Egress Throttle Groups are used to perform 2 functions: Rate Limiting and Pending Transaction Limiting. Each of the functions is independent of the other and can be optionally configured and controlled separately.

You can perform these tasks on an Active System OAM (SOAM).

Due to Egress Throttle Lists functionality, there is an additional maintenance parameter for Egress Throttle Groups, Control Scope. If the Egress Throttle Group does not belong to an Egress Throttle List, its Control Scope is ETG, which means that egress throttling is controlled by the ETG's configuration data. If the Egress Throttle Group is associated with an Egress Throttle List, its Control Scope can either be ETL, which means that egress throttling is controlled by the configuration data for the ETL that contains the ETG, or ETG, where egress throttling is controlled by the configuration data for the ETG. Under normal conditions the expected control scope for an ETG contained in an ETL would be ETL. A control scope of ETG for an ETG contained by an ETL can be used for maintenance transitions, such as when the ETG is being added or removed from the ETL.

Each function has an individual Control Scope State, as shown in Table 4-6.

Table 4-6 Egress Throttle Groups Control Scope States

Admin State Description
ETL Egress throttling for Rate Limiting and Pending Transaction Limiting is being controlled by the ETL's configuration data.
ETG Egress throttling for Rate Limiting and Pending Transaction Limiting is being controlled by the ETG's configuration data.
Each function has an individual Administration State (Enable/Disable) and Operational Status, as shown in Table 4-7.

Table 4-7 Egress Throttle Groups Admin States

Admin State Description
Enable ETG status monitoring is enabled for the function.
Disable ETG status monitoring is disabled for the function. All monitoring is stopped in this state and alarms are cleared.

The Egress Throttle Group maintenance status is displayed on the Diameter > Maintenance > Egress Throttle Groups GUI page. Egress Throttle Groups use the Leader sourcing method for reporting of maintenance status. The Leader sourcing method is used because each DA-MP has identical status data; only the DA-MP Leader reports the maintenance status to the GUI. Table 4-8 shows the ETG operational status.

Table 4-8 ETG Operational Status

ETG Operational Status Description
Available ETG monitoring is active and Request throttling is not occurring for this ETG.
Degraded

ETG monitoring is active and Request throttling is occurring for this ETG.

Some Requests may be getting throttled based on their Priority

Inactive

ETG monitoring is inactive and Request Throttling is not occurring for this ETG. The Operational Reason indicates why this ETG is Inactive.

When Operational Reason is Disabled the ETG is Inactive due to maintenance actions.

When the Operational Reason is SMS Service Degraded or No DA-MP Leader the ETG is Inactive due to a fault condition.

If either Rate Limiting or Pending Transaction Limiting Operational Status is Degraded, then the Diameter Routing Function throttles the Request messages according to highest severity. For example, if Rate Limiting Operational Status is Congestion Level 1 and Pending Transaction Limiting Operational Status is Congestion Level 2, then the Diameter Routing Function throttles Request messages according to Congestion Level 2 (all Request messages with Priority 0 or 1 are throttled). As shown in Table 4-9.

Table 4-9 ETG Operational Reason

ETG Operational Reason Description
Disabled ETG is Disabled due to maintenance actions.
Normal No Requests are getting throttled for this ETG for the function.
Congestion Level 1 Request throttling is happening for Requests with Priority 0.
Congestion Level 2 Request throttling is happening for Requests with Priority 0 and 1.
Congestion Level 3 Request throttling is happening for Requests with Priority 0, 1, and 1.
SMS Service Degraded

ETG monitoring is Inactive due to "Degraded" status reported to the Diameter Routing Function.

No DA-MP Leader ETG Monitoring is Inactive due to HA reporting No DA-MP Leader condition to the Diameter Routing Function.

The Diameter > Maintenance > Egress Throttle Groups page provides the Operational Status of the Egress Throttle Groups Rate Limiting and Pending Transactions Limiting functions, including an Operational Reason for the status.

Egress Throttle Groups maintenance fields are described in Egress Throttle Groups elements

If the column data is not present in the database, the columns for the Egress Throttle Group Name are displayed as Unk.

On the Diameter > Maintenance > Egress Throttle Groups page, you can perform the following actions:
  • Filter the list of Egress Throttle Groups to display only the Egress Throttle Groups.
  • Sort the list by a column, in ascending or descending order, by clicking the column heading. The default order is by Egress Throttle Groups in ascending ASCII order.
  • Select one or more (up to 20) Egress Throttle Groups records at a time.
  • Enable Rate Limiting for up to 20 selected Egress Throttle Groups.
  • Disable Rate Limiting for up to 20 selected Egress Throttle Groups.
  • Enable Pending Transaction Limiting for up to 20 selected Egress Throttle Groups.
  • Disable Pending Transactions Limiting for up to 20 selected Egress Throttle Groups.
  • Prevent the page from automatically refreshing every 10 seconds by clicking the Pause updates check box.