1
2ethextractperf2(8)           EFSFFCLIRG (Man Page)          ethextractperf2(8)
3
4
5

NAME

7       ethextractperf2
8
9
10
11       Provides  a report of all performance counters in a CSV format suitable
12       for importing into a spreadsheet or parsed by other scripts for further
13       analysis.  It  generates  a detailed ethreport component summary report
14       and pipes the result to ethxmlextract, extracting  element  values  for
15       NodeDesc, IfAddr, PortNum, neighbor NodeDesc, neighbor IfAddr, neighbor
16       PortNum and all the performance counters.
17

Syntax

19       ethextractperf2 [ethreport  options]
20

Options

22       --help
23
24                 Produces full help text.
25
26
27       ethreport options
28
29                 The following options are passed to ethreport. This subset is
30                 considered  typical  and  useful for this command. Do not use
31                 the -o/--output report option.
32
33
34
35
36                 -X/--infile snapshot_input
37                           Generates a report using  the  data  in  the  snap‐
38                           shot_input file. snapshot_input must have been gen‐
39                           erated during a previous -o snapshot run.  '-'  may
40                           be used as the snapshot_input to specify stdin.
41
42
43
44
45
46                 -T/--topology topology_input
47                           Uses topology_input file to augment and verify fab‐
48                           ric information. When used, various reports can  be
49                           augmented with information not available electroni‐
50                           cally. '-' may be used to specify stdin.
51
52
53
54
55
56                 -E/--eth config_file
57                           Specifies the Intel  Ethernet  configuration  file.
58                           Default is /etc/eth-tools/mgt_config.xml file.
59
60
61
62
63
64                 -p plane  Name  of  the  enabled  plane defined in Mgt config
65                           file, default is the first enabled plane.
66
67
68
69
70
71                 -F/--focus point
72                           Specifies the focus area for report. Used to  limit
73                           scope of report. Refer to Point Syntax for details.
74
75
76
77

Point Syntax

79       ifid:value
80
81                 value is numeric ifid.
82
83
84       ifid:value:node
85
86                 value is numeric ifid, selects node with given ifid.
87
88
89       ifid:value:port:value2
90
91                 value is numeric ifid of node, value2 is port number.
92
93
94       ifid:value:portid:value2
95
96                 value is numeric ifid of node, value2 is port id.
97
98
99       mgmtifaddr:value
100
101                 value is numeric port mgmtifaddr.
102
103
104       ifaddr:value
105
106                 value is numeric node ifaddr.
107
108
109       ifaddr:value1:port:value2
110
111                 value1 is numeric node ifaddr, value2 is port number.
112
113
114       ifaddr:value1:portid:value2
115
116                 value1 is numeric node ifaddr, value2 is port id.
117
118
119       chassisid:value
120
121                 value is numeric chassisid.
122
123
124       chassisid:value1:port:value2
125
126                 value1 is numeric chassisid, value2 is port number.
127
128
129       chassisid:value1:portid:value2
130
131                 value1 is numeric chassisid, value2 is port id.
132
133
134       node:value
135
136                 value is node description (node name).
137
138
139       node:value1:port:value2
140
141                 value1  is  node description (node name), value2 is port num‐
142                 ber.
143
144
145       node:value1:portid:value2
146
147                 value1 is node description (node name), value2 is port id.
148
149
150       nodepat:value
151
152                 value is glob pattern for node description (node name).
153
154
155       nodepat:value1:port:value2
156
157                 value1 is the glob pattern for  the  node  description  (node
158                 name), value2 is port number.
159
160
161       nodepat:value1:portid:value2
162
163                 value1  is  the  glob  pattern for the node description (node
164                 name), value2 is port id.
165
166
167       nodedetpat:value
168
169                 value is glob pattern for node details.
170
171
172       nodedetpat:value1:port:value2
173
174                 value1 is the glob pattern for the node  details,  value2  is
175                 port number.
176
177
178       nodedetpat:value1:portid:value2
179
180                 value1  is  the  glob pattern for the node details, value2 is
181                 port id.
182
183
184       nodetype:value
185
186                 value is node type (SW or NIC).
187
188
189       nodetype:value1:port:value2
190
191                 value1 is node type (SW or NIC), value2 is port number.
192
193
194       nodetype:value1:portid:value2
195
196                 value1 is node type (SW or NIC), value2 is port id.
197
198
199       rate:value
200
201                 value is string for rate (25g, 50g, 75g, 100g), omits  switch
202                 mgmt port 0.
203
204
205       portstate:value
206
207                 value is a string for state (up, down, testing, unknown, dor‐
208                 mant, notactive).
209
210
211       portphysstate:value
212
213                 value is a string for  PHYs  state  (other,  unknown,  opera‐
214                 tional, standby, shutdown, reset)
215
216
217       mtucap:value
218
219                 value  is  MTU  size  (maximum size 65535), omits switch mgmt
220                 port 0.
221
222
223       linkdetpat:value
224
225                 value is glob pattern for link details.
226
227
228       portdetpat:value
229
230                 value is glob pattern for port details.
231
232
233       nodepatfile:FILENAME
234
235                 Specifies the name of file with the list of nodepats or  node
236                 descriptions.
237
238
239       nodepairpatfile:FILENAME
240
241                 Specifies the name of file with the list of node pairs, sepa‐
242                 rated by a colon.
243
244
245       ldr
246
247                 Specifies the ports with  a  non-zero  link  down  reason  or
248                 neighbor link down reason.
249
250
251       ldr:value
252
253                 Specifies  the ports with a link down reason or neighbor link
254                 down reason equal to value.
255
256

Example

258       ethextractperf2
259
260

See Also

262       ethmergeperf2
263
264
265
266
267Copyright(C) 2020-2021         Intel Corporation            ethextractperf2(8)