Skip to content

Commit 785b890

Browse files
rgwiltondplore
rgwilton
and
dplore
authored
Add interface-transitions and link-transitions counters (#1264)
* Add interface-transitions and link-transitions counters --------- Co-authored-by: Darren Loher <[email protected]>
1 parent 46bbd6b commit 785b890

File tree

1 file changed

+74
-35
lines changed

1 file changed

+74
-35
lines changed

‎release/models/interfaces/openconfig-interfaces.yang

Lines changed: 74 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,14 @@ module openconfig-interfaces {
5151
Section 4.c of the IETF Trust's Legal Provisions Relating
5252
to IETF Documents (http://trustee.ietf.org/license-info).";
5353

54-
oc-ext:openconfig-version "3.7.2";
54+
oc-ext:openconfig-version "3.8.0";
55+
56+
revision "2024-12-05" {
57+
description
58+
"Add interface-transitions and link-transitions counters";
59+
reference
60+
"3.8.0";
61+
}
5562

5663
revision "2024-12-05" {
5764
description
@@ -759,8 +766,7 @@ module openconfig-interfaces {
759766
760767
Discontinuities in the value of this counter can occur
761768
at re-initialization of the management system, and at
762-
other times as indicated by the value of
763-
'last-clear'.";
769+
other times as indicated by the value of 'last-clear'.";
764770
reference
765771
"RFC 2863: The Interfaces Group MIB - ifHCInOctets.
766772
RFC 4293: Management Information Base for the
@@ -788,8 +794,7 @@ module openconfig-interfaces {
788794
789795
Discontinuities in the value of this counter can occur
790796
at re-initialization of the management system, and at
791-
other times as indicated by the value of
792-
'last-clear'.";
797+
other times as indicated by the value of 'last-clear'.";
793798
reference
794799
"RFC 2863: The Interfaces Group MIB - ifHCInUcastPkts.
795800
RFC 4293: Management Information Base for the
@@ -805,8 +810,7 @@ module openconfig-interfaces {
805810
806811
Discontinuities in the value of this counter can occur
807812
at re-initialization of the management system, and at
808-
other times as indicated by the value of
809-
'last-clear'.";
813+
other times as indicated by the value of 'last-clear'.";
810814
reference
811815
"RFC 2863: The Interfaces Group MIB - ifHCInBroadcastPkts.
812816
RFC 4293: Management Information Base for the
@@ -823,8 +827,7 @@ module openconfig-interfaces {
823827
824828
Discontinuities in the value of this counter can occur
825829
at re-initialization of the management system, and at
826-
other times as indicated by the value of
827-
'last-clear'.";
830+
other times as indicated by the value of 'last-clear'.";
828831
reference
829832
"RFC 2863: The Interfaces Group MIB - ifHCInMulticastPkts.
830833
RFC 4293: Management Information Base for the
@@ -844,8 +847,7 @@ module openconfig-interfaces {
844847
845848
Discontinuities in the value of this counter can occur
846849
at re-initialization of the management system, and at
847-
other times as indicated by the value of
848-
'last-clear'.";
850+
other times as indicated by the value of 'last-clear'.";
849851
reference
850852
"RFC 2863: The Interfaces Group MIB - ifInErrors.
851853
RFC 4293: Management Information Base for the
@@ -863,9 +865,7 @@ module openconfig-interfaces {
863865
864866
Discontinuities in the value of this counter can occur
865867
at re-initialization of the management system, and at
866-
other times as indicated by the value of
867-
'last-clear'.";
868-
868+
other times as indicated by the value of 'last-clear'.";
869869

870870
reference
871871
"RFC 2863: The Interfaces Group MIB - ifInDiscards.
@@ -881,8 +881,7 @@ module openconfig-interfaces {
881881
882882
Discontinuities in the value of this counter can occur
883883
at re-initialization of the management system, and at
884-
other times as indicated by the value of
885-
'last-clear'.";
884+
other times as indicated by the value of 'last-clear'.";
886885
reference
887886
"RFC 2863: The Interfaces Group MIB - ifHCOutOctets.
888887
RFC 4293: Management Information Base for the
@@ -911,8 +910,7 @@ module openconfig-interfaces {
911910
912911
Discontinuities in the value of this counter can occur
913912
at re-initialization of the management system, and at
914-
other times as indicated by the value of
915-
'last-clear'.";
913+
other times as indicated by the value of 'last-clear'.";
916914
reference
917915
"RFC 2863: The Interfaces Group MIB - ifHCOutUcastPkts.
918916
RFC 4293: Management Information Base for the
@@ -929,8 +927,7 @@ module openconfig-interfaces {
929927
930928
Discontinuities in the value of this counter can occur
931929
at re-initialization of the management system, and at
932-
other times as indicated by the value of
933-
'last-clear'.";
930+
other times as indicated by the value of 'last-clear'.";
934931
reference
935932
"RFC 2863: The Interfaces Group MIB - ifHCOutBroadcastPkts.
936933
RFC 4293: Management Information Base for the
@@ -949,8 +946,7 @@ module openconfig-interfaces {
949946
950947
Discontinuities in the value of this counter can occur
951948
at re-initialization of the management system, and at
952-
other times as indicated by the value of
953-
'last-clear'.";
949+
other times as indicated by the value of 'last-clear'.";
954950
reference
955951
"RFC 2863: The Interfaces Group MIB - ifHCOutMulticastPkts.
956952
RFC 4293: Management Information Base for the
@@ -968,8 +964,7 @@ module openconfig-interfaces {
968964
969965
Discontinuities in the value of this counter can occur
970966
at re-initialization of the management system, and at
971-
other times as indicated by the value of
972-
'last-clear'.";
967+
other times as indicated by the value of 'last-clear'.";
973968
reference
974969
"RFC 2863: The Interfaces Group MIB - ifOutDiscards.
975970
RFC 4293: Management Information Base for the
@@ -987,8 +982,7 @@ module openconfig-interfaces {
987982
988983
Discontinuities in the value of this counter can occur
989984
at re-initialization of the management system, and at
990-
other times as indicated by the value of
991-
'last-clear'.";
985+
other times as indicated by the value of 'last-clear'.";
992986
reference
993987
"RFC 2863: The Interfaces Group MIB - ifOutErrors.
994988
RFC 4293: Management Information Base for the
@@ -1029,8 +1023,7 @@ module openconfig-interfaces {
10291023
10301024
Discontinuities in the value of this counter can occur
10311025
at re-initialization of the management system, and at
1032-
other times as indicated by the value of
1033-
'last-clear'.";
1026+
other times as indicated by the value of 'last-clear'.";
10341027
reference
10351028
"RFC 2863: The Interfaces Group MIB - ifInUnknownProtos";
10361029
}
@@ -1042,16 +1035,63 @@ module openconfig-interfaces {
10421035
frame check sequence (FCS), i.e., framing errors.
10431036
10441037
Discontinuities in the value of this counter can occur
1045-
when the device is re-initialization as indicated by the
1046-
value of 'last-clear'.";
1038+
at re-initialization of the management system, and at
1039+
other times as indicated by the value of 'last-clear'.";
10471040
}
10481041

10491042
leaf carrier-transitions {
10501043
type oc-yang:counter64;
1044+
status deprecated;
10511045
description
10521046
"Number of times the interface state has transitioned
10531047
between up and down since the time the device restarted
1054-
or the last-clear time, whichever is most recent.";
1048+
or the last-clear time, whichever is most recent.
1049+
1050+
Please use interface-transitions instead, which has
1051+
similar, but more precisely specified, semantics and a
1052+
clearer name.";
1053+
oc-ext:telemetry-on-change;
1054+
}
1055+
1056+
leaf interface-transitions {
1057+
type oc-yang:counter64;
1058+
description
1059+
"The total number of times the interface state (oper-status)
1060+
has either transitioned to 'UP' state from any other state, or
1061+
from state 'UP' to any other state. I.e., an interface flap
1062+
from UP to DOWN back to UP increments the counter by 2.
1063+
Transitions between any other interface states other than to
1064+
or from 'UP' state are not included in the counter.
1065+
1066+
Discontinuities in the value of this counter can occur
1067+
at re-initialization of the management system, and at
1068+
other times as indicated by the value of 'last-clear'.";
1069+
oc-ext:telemetry-on-change;
1070+
}
1071+
1072+
leaf link-transitions {
1073+
type oc-yang:counter64;
1074+
description
1075+
"This is the number of times that the underlying link state
1076+
(e.g., at the optical receiver) has transitioned to or from
1077+
'UP' state before any holdtime, dampening, or other processing
1078+
has been applied that could suppress an update to the interface
1079+
'oper-status' and corresponding interface-transitions counter.
1080+
1081+
The counter is incremented both when the link transitions
1082+
to 'UP' state from any other link state and also when the link
1083+
transitions from 'UP' state to any other link state, i.e., an
1084+
interface flap from UP to DOWN back to UP increments the
1085+
counter by 2.
1086+
1087+
Implementations are not required to count all transitions,
1088+
e.g., if they are below the level of granularity monitored by
1089+
the system, and hence may not tally with the equivalent counter
1090+
on the remote end of the link.
1091+
1092+
Discontinuities in the value of this counter can occur
1093+
at re-initialization of the management system, and at
1094+
other times as indicated by the value of 'last-clear'.";
10551095
oc-ext:telemetry-on-change;
10561096
}
10571097

@@ -1086,8 +1126,7 @@ module openconfig-interfaces {
10861126
10871127
Discontinuities in the value of this counter can occur
10881128
at re-initialization of the management system, and at
1089-
other times as indicated by the value of
1090-
'last-clear'.";
1129+
other times as indicated by the value of 'last-clear'.";
10911130
reference
10921131
"RFC 2863: The Interfaces Group MIB - ifInUnknownProtos";
10931132
}
@@ -1100,8 +1139,8 @@ module openconfig-interfaces {
11001139
frame check sequence (FCS), i.e., framing errors.
11011140
11021141
Discontinuities in the value of this counter can occur
1103-
when the device is re-initialization as indicated by the
1104-
value of 'last-clear'.";
1142+
at re-initialization of the management system, and at
1143+
other times as indicated by the value of 'last-clear'.";
11051144
}
11061145

11071146
leaf carrier-transitions {

0 commit comments

Comments
 (0)