You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
show interface command to display the down reasons as shown in the below example:
232
253
```
233
254
sonic# show interface Eth 1/2/2
234
-
Eth1/2/2 is up, line protocol is down, reason phy-link-down
255
+
Eth1/2/2 is up, line protocol is down, reason PHY-link-down
235
256
Remote-fault at 2021-01-06 07:49:45.737024
236
257
Local-fault at 2021-01-06 07:49:45.737024
237
258
Hardware is Eth
@@ -253,6 +274,29 @@ Output statistics:
253
274
6 Multicasts, 0 Broadcasts, 0 Unicast
254
275
```
255
276
277
+
The list of events:
278
+
Admin-down
279
+
Remote-fault
280
+
Local-fault
281
+
Link-training-failed
282
+
Link-training-not-completed
283
+
Link-training-not-started
284
+
Link-tuning-failed
285
+
Link-tuning-not-started
286
+
Link-tuning-not-completed
287
+
Incompatible-transceiver
288
+
Transceiver-not-present
289
+
Port-breakout-in-progress
290
+
High-BER
291
+
PMD-CDR-lock
292
+
PMD-signal-detected
293
+
STP-err-disabled
294
+
Transceiver-err-disabled
295
+
UDLD-err-disabled
296
+
Link-flap-err-disabled
297
+
PHY-link-up
298
+
299
+
256
300
#### Port channel interface
257
301
-*show interface status*
258
302
Along with the physical interfaces, configured portchannel interfaces are displayed in this command output. The new column, "Reason" displays the high level reason for portchannel down. The reasons are
@@ -313,7 +357,32 @@ Output statistics:
313
357
#### 3.6.2.3 Exec Commands
314
358
315
359
### 3.6.3 REST API Support
316
-
*URL-based view*
360
+
361
+
GET /restconf/data/openconfig-interfaces:interfaces/interface={name}/openconfig-if-ethernet:ethernet/state/openconfig-interfaces-ext:status/down-reason
GET /restconf/data/openconfig-interfaces:interfaces/interface={name}/openconfig-if-ethernet:ethernet/state/openconfig-interfaces-ext:reason-events
370
+
371
+
Example response data:
372
+
{
373
+
"openconfig-interfaces-ext:reason-events": {
374
+
"down-reason-event": [
375
+
{
376
+
"reason-event": {
377
+
"reason": "OPER_UP",
378
+
"event": "PHY-link-up",
379
+
"timestamp": "2021-06-06 09:29:55.639018"
380
+
}
381
+
}
382
+
]
383
+
}
384
+
}
385
+
317
386
318
387
### 3.6.4 gNMI Support
319
388
*Generally this is covered by the YANG specification. This section should also cover objects where on-change and interval based telemetry subscriptions can be configured.*
Copy file name to clipboardExpand all lines: system/intf-dampening-HLD.md
+38-17Lines changed: 38 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,37 +38,37 @@ The Port Link Flap Error Disable feature uses an exponential decay mechanism to
38
38
39
39
When Port Link Flap Error Disable is enabled, the system monitors the number of times a port link state toggles from "up to down", and not from "down to up".
40
40
41
-
The sampling time or window (the time during which the specified toggle threshold can occur before the wait period is activated) is triggered when the first "up to down" transition occurs.
41
+
The sampling interval or window (the time during which the specified toggle threshold can occur before the recovery wait period is activated) is triggered when the first "up to down" transition occurs.
42
42
43
-
If the port link state toggles from up to down for a specified number of times within a specified period, the interface is physically disabled for the specified wait period. Once the wait period expires, the port link state is re-enabled. However, if the wait period is set to zero (0) seconds, the port link state will remain disabled until it is manually disabled and re-enabled or Port Link Flap Error Disable is disabled on this port.
43
+
If the port link state toggles from up to down for a specified number of times within a specified period, the interface is physically disabled for the specified recovery wait period. Once the recovery wait period expires, the port link state is re-enabled. However, if the recovery wait period is set to zero (0) seconds, the port link state will remain disabled until it is manually disabled and re-enabled or Port Link Flap Error Disable is disabled on this port.
44
44
45
45
46
46
## 1.1 Requirements
47
47
System shall be able to suppress interfaces state change events to protect system resources.
48
48
User shall be able to enable or disable the feature on individual interfaces and globally.
49
49
The feature must be disabled on all interfaces by default.
50
50
The feature shall be supported on physical interfaces.
51
-
There must be two sets of configuration parameters (sample-interval, recovery-interval, and flap-threshold) a per-interface set and a global set. If both global and per-interface are configured, the per-interface values are used only for given interfaces. Global values are used for all other physical interfaces.
51
+
There must be two sets of configuration parameters (sampling-interval, recovery-interval, and flap-threshold) a per-interface set and a global set. If both global and per-interface are configured, the per-interface values are used only for given interfaces. Global values are used for all other physical interfaces.
52
52
If no values are specified by user, a default set of parameters are applied to all interfaces.
53
53
User shall be able to save configuration parameters (both global and per-interface).
54
54
The configuration parameters (both global and per-interface) must be preserved across device reboot.
55
55
56
56
### 1.1.1 Functional Requirements
57
57
Port Link Flap Error Disable shall use below parameters to supress and protect system.
58
58
- flap-threshold
59
-
Specifies the number of times a port link state goes from up to down before the wait period is activated. The value ranges from 1 through 50.
60
-
-sample-interval
61
-
Specifies the amount of time, in seconds, during which the specified toggle threshold can occur before the wait period is activated. The value ranges from 1 through 65535.
59
+
Specifies the number of times a port link state goes from up to down before the recovery wait period is activated. The value ranges from 1 through 50.
60
+
-sampling-interval
61
+
Specifies the amount of time, in seconds, during which the specified toggle threshold can occur before the recovery wait period is activated. The value ranges from 1 through 65535.
62
62
- recovery-interval
63
63
Specifies the amount of time in seconds, for which the port remains disabled (down) before it becomes enabled. The value ranges from 0 through 65534. A value of 0 indicates that the port will stay down until an administrative override occurs.
64
64
65
65
### 1.1.2 Configuration and Management Requirements
66
66
- Port Link Flap Error Disable feature default is OFF on all physical interfaces and port-channels
67
67
- When Port Link Flap Error Disable is enabled, use below default values:
68
68
flap-threshold: 3
69
-
sample-interval: 10
69
+
sampling-interval: 10
70
70
recovery-interval: 300
71
-
- User shall be able to specify different sample-interval, flap-threshold and recovery-interval on a physical interface
71
+
- User shall be able to specify different sampling-interval, flap-threshold and recovery-interval on a physical interface
72
72
- User shall be able to display current Port Link Flap Error Disable confiuration values.
73
73
- User shall be able to display current interface status if it was surpresed by Port Link Flap Error Disable
74
74
- User shall be able to display Link-Down-Reason if a port is disabled by Port Link Flap Error Disable feature
@@ -101,23 +101,37 @@ The Interface Error Disable feature exist in below modules and containers:
In this example, the values for the parameters are as follows:
107
107
108
-
The flap-threshold is set at 10 times. This interval is the number of times that the port's link state goes from up to down and down to up before the recovery-timeout is activated. Enter a valid value range from 1-50. Default is 3.
108
+
The flap-threshold is set at 10 times. This interval is the number of times that the port's link state goes from up to down and down to up before the recovery-interval is activated. Enter a valid value range from 1-50. Default is 3.
109
109
110
110
111
-
The sampling-time is set to 3 seconds. This time period is the amount of time during which the specified flap-threshold can be crossed. If the flap-threshold is crossed during this sampling-time, port will be error-disabled. Enter a value between 1 and 65535 seconds. Default is 10.
111
+
The sampling-interval is set to 3 seconds. This time period is the amount of time during which the specified flap-threshold can be crossed. If the flap-threshold is crossed during this sampling-interval, port will be error-disabled. Enter a value between 1 and 65535 seconds. Default is 10.
112
112
113
113
114
-
The recovery-timeout is set to 10 seconds. This period of time is the amount of time the port remains disabled (down) before it becomes enabled. Entering 0 indicates that the port will stay down until an administrative override occurs. Enter a value between 0 and 65534 seconds. Default is 300.
114
+
The recovery-interval is set to 10 seconds. This period of time is the amount of time the port remains disabled (down) before it becomes enabled. Entering 0 indicates that the port will stay down until an administrative override occurs. Enter a value between 0 and 65534 seconds. Default is 300.
115
115
116
116
117
117
This config command can be executed on a range of interfaces as well. Example:
0 commit comments