1ethextractstat2(8) EFSFFCLIRG (Man Page) ethextractstat2(8)
3
7 ethextractstat2
8 Performs an error analysis of a fabric and provides augmented informa‐
12 tion from a topology_file including all error counters. The output is
13 in a CSV format suitable for importing into a spreadsheet or parsed by
14 other scripts. ethextractstat2 is a front end to the ethreport and
15 ethxmlextract tools.
16
18 ethextractstat2 topology_file [ethreport options]
19
21 --help
22 Produces full help text.
24 topology_file
27 Specifies topology_file to use.
29 ethreport options
32 The following options are passed to ethreport. This subset is
34 considered typical and useful for this command. By design,
35 the tool ignores -o/--output report option.
36 -X/--infile snapshot_input
41 Generates a report using the data in the snap‐
42 shot_input file. snapshot_input must have been gen‐
43 erated during a previous -o snapshot run. '-' may
44 be used as the snapshot_input to specify stdin.
45 -c/--config file
51 Specifies the error thresholds configuration file.
52 Default is /etc/eth-tools/ethmon.conf file.
53 -E/--eth config_file
59 Specifies the Intel Ethernet configuration file.
60 Default is /etc/eth-tools/mgt_config.xml file.
61 -p plane
67 Name of the enabled plane defined in Mgt config
68 file, default is the first enabled plane.
69 -L/--limit
75 Limits operation to exact specified focus with -F
76 for port error counters check (-o errors). Nor‐
77 mally, the neighbor of each selected port is also
78 checked. Does not affect other reports.
79 -F/--focus point
85 Specifies the focus area for report. Used to limit
86 scope of report. Refer to Point Syntax for details.
87
92 ifid:value
93 value is numeric ifid.
95 ifid:value:node
98 value is numeric ifid, selects node with given ifid.
100 ifid:value:port:value2
103 value is numeric ifid of node, value2 is port number.
105 ifid:value:portid:value2
108 value is numeric ifid of node, value2 is port id.
110 mgmtifaddr:value
113 value is numeric port mgmtifaddr.
115 ifaddr:value
118 value is numeric node ifaddr.
120 ifaddr:value1:port:value2
123 value1 is numeric node ifaddr, value2 is port number.
125 ifaddr:value1:portid:value2
128 value1 is numeric node ifaddr, value2 is port id.
130 chassisid:value
133 value is numeric chassisid.
135 chassisid:value1:port:value2
138 value1 is numeric chassisid, value2 is port number.
140 chassisid:value1:portid:value2
143 value1 is numeric chassisid, value2 is port id.
145 node:value
148 value is node description (node name).
150 node:value1:port:value2
153 value1 is node description (node name), value2 is port num‐
155 ber.
156 node:value1:portid:value2
159 value1 is node description (node name), value2 is port id.
161 nodepat:value
164 value is glob pattern for node description (node name).
166 nodepat:value1:port:value2
169 value1 is the glob pattern for the node description (node
171 name), value2 is port number.
172 nodepat:value1:portid:value2
175 value1 is the glob pattern for the node description (node
177 name), value2 is port id.
178 nodedetpat:value
181 value is glob pattern for node details.
183 nodedetpat:value1:port:value2
186 value1 is the glob pattern for the node details, value2 is
188 port number.
189 nodedetpat:value1:portid:value2
192 value1 is the glob pattern for the node details, value2 is
194 port id.
195 nodetype:value
198 value is node type (SW or NIC).
200 nodetype:value1:port:value2
203 value1 is node type (SW or NIC), value2 is port number.
205 nodetype:value1:portid:value2
208 value1 is node type (SW or NIC), value2 is port id.
210 rate:value
213 value is string for rate (25g, 50g, 75g, 100g), omits switch
215 mgmt port 0.
216 portstate:value
219 value is a string for state (up, down, testing, unknown, dor‐
221 mant, notactive).
222 portphysstate:value
225 value is a string for PHYs state (other, unknown, opera‐
227 tional, standby, shutdown, reset)
228 mtucap:value
231 value is MTU size (maximum size 65535), omits switch mgmt
233 port 0.
234 linkdetpat:value
237 value is glob pattern for link details.
239 portdetpat:value
242 value is glob pattern for port details.
244 nodepatfile:FILENAME
247 Specifies the name of file with the list of nodepats or node
249 descriptions.
250 nodepairpatfile:FILENAME
253 Specifies the name of file with the list of node pairs, sepa‐
255 rated by a colon.
256 ldr
259 Specifies the ports with a non-zero link down reason or
261 neighbor link down reason.
262 ldr:value
265 Specifies the ports with a link down reason or neighbor link
267 down reason equal to value.
268 The portion of the script that calls ethreport and ethxmlextract fol‐
272 lows:
273 ethreport -x -d 10 -s -o errors -T $@ | ethxmlextract -d \;
275 -e Rate -e MTU -e Internal -e LinkDetails -e CableLength -e CableLabel
277 -e CableDetails -e Port.NodeGUID -e Port.PortGUID -e Port.PortNum
279 -e Port.PortId
281 -e Port.PortType -e Port.NodeDesc -e Port.PortDetails
282 -e PortXmitData.Value -e PortXmitPkts.Value -e PortRcvData.Value
284 -e PortRcvPkts.Value -e SymbolErrors.Value -e LinkErrorRecovery.Value
286 -e LinkDowned.Value -e PortRcvErrors.Value
288 -e PortRcvRemotePhysicalErrors.Value -e PortRcvSwitchRelayErrors.Value
290 -e PortXmitConstraintErrors.Value -e PortRcvConstraintErrors.Value
292 -e LocalLinkIntegrityErrors.Value -e ExcessiveBufferOverrunErrors.Value
294
298 ethextractstat2 topology_file
299 ethextractstat2 topology_file -c my_ethmon.conf
301Copyright(C) 2020-2022 Intel Corporation ethextractstat2(8)