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                 -A/--allports
57                           Gets PortInfo for down switch ports.
58
59
60
61
62
63                 -E/--eth config_file
64                           Specifies the Intel  Ethernet  configuration  file.
65                           Default is /etc/eth-tools/mgt_config.xml file.
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       mgmtifaddr:value
95
96                 value is numeric port mgmtifaddr.
97
98
99       ifaddr:value
100
101                 value is numeric node ifaddr.
102
103
104       ifaddr:value1:port:value2
105
106                 value1 is numeric node ifaddr, value2 is port number.
107
108
109       chassisid:value
110
111                 value is numeric chassisid.
112
113
114       chassisid:value1:port:value2
115
116                 value1 is numeric chassisid, value2 is port number.
117
118
119       node:value
120
121                 value is node description (node name).
122
123
124       node:value1:port:value2
125
126                 value1 is node description (node name), value2 is  port  num‐
127                 ber.
128
129
130       nodepat:value
131
132                 value is glob pattern for node description (node name).
133
134
135       nodepat:value1:port:value2
136
137                 value1  is  the  glob  pattern for the node description (node
138                 name), value2 is port number.
139
140
141       nodedetpat:value
142
143                 value is glob pattern for node details.
144
145
146       nodedetpat:value1:port:value2
147
148                 value1 is the glob pattern for the node  details,  value2  is
149                 port number.
150
151
152       nodetype:value
153
154                 value is node type (SW or NIC).
155
156
157       nodetype:value1:port:value2
158
159                 value1 is node type (SW or NIC), value2 is port number.
160
161
162       rate:value
163
164                 value  is string for rate (25g, 50g, 75g, 100g), omits switch
165                 mgmt port 0.
166
167
168       portstate:value
169
170                 value is a string for state (up, down, testing, unknown, dor‐
171                 mant, notactive).
172
173
174       portphysstate:value
175
176                 value  is  a  string  for  PHYs state (other, unknown, opera‐
177                 tional, standby, shutdown, reset)
178
179
180       mtucap:value
181
182                 value is MTU size (maximum size  65535),  omits  switch  mgmt
183                 port 0.
184
185
186       linkdetpat:value
187
188                 value is glob pattern for link details.
189
190
191       portdetpat:value
192
193                 value is glob pattern for port details.
194
195
196       nodepatfile:FILENAME
197
198                 Specifies  the name of file with the list of nodepats or node
199                 descriptions.
200
201
202       nodepairpatfile:FILENAME
203
204                 Specifies the name of file with the list of node pairs, sepa‐
205                 rated by a colon.
206
207
208       ldr
209
210                 Specifies  the  ports  with  a  non-zero  link down reason or
211                 neighbor link down reason.
212
213
214       ldr:value
215
216                 Specifies the ports with a link down reason or neighbor  link
217                 down reason equal to value.
218
219

Example

221       ethextractperf2
222
223

See Also

225       ethmergeperf2
226
227
228
229
230Copyright(C) 2020              Intel Corporation            ethextractperf2(8)