forked from ibm-messaging/mq-metric-samples
-
Notifications
You must be signed in to change notification settings - Fork 0
/
metrics.txt
312 lines (286 loc) · 11.7 KB
/
metrics.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
Available Metrics
=================
Note that the actual name of produced metrics may vary for each different collector, but
they are derived from these basic names and object classes. The available metrics may also
vary by queue manager platform and version.
If you are using the Prometheus collector, one way to display all of the available metrics
including the resource publication metrics, showing the real names, is to disable
the actual collection process within Prometheus and call the collector directly. For example,
curl <hostname>:9157/metrics | grep "^ibmmq"
Alternatively, you can look directly at the database. For example, go to "http://<prometheus_server>:9090"
and type "ibmmq_" into the expression bar. That should provide a complete list of available metrics.
Similar approaches can be used for the other databases.
Metrics published on system topics
----------------------------------
The metrics published by the queue manager under the $SYS topic tree are listed here as extracted from
the product documentation at https://www.ibm.com/docs/en/ibm-mq/latest?topic=trace-metrics-published-system-topics.
Access to these metrics requires the "usePublications" configuration attribute to be set for the collector.
Class and Type values match what you would see in the amqsrua sample program.
The actual names of these metrics as seen in a database will vary, but they
are usually a combination of the product name and the metric description:
Class: CPU
Type: SystemSummary
User CPU time percentage
System CPU time percentage
CPU load - one minute average
CPU load - five minute average
CPU load - fifteen minute average
RAM free percentage
RAM total bytes
Type: QMgrSummary
User CPU time - percentage estimate for queue manager
System CPU time - percentage estimate for queue manager
RAM total bytes - estimate for queue manager
Class: DISK
Type: SystemSummary
MQ errors file system - bytes in use
MQ errors file system - free space
MQ FDC file count
MQ trace file system - bytes in use
MQ trace file system - free space
Type: QMgrSummary
Queue Manager file system - bytes in use
Queue Manager file system - free space
Type: Log
Log - bytes in use
Log - bytes max
Log file system - bytes in use
Log file system - bytes max
Log - physical bytes written for the current interval X
Log - logical bytes written for the current interval
Log - write latency uSec
Log - write size X, also rolling average
Log - occupied by extents waiting to be archived X
Log - space in MB required for media recovery X
Log - space in MB occupied by reusable extents
Log - current primary space in use
Log - workload primary space utilization
Class: STATMQI
Type: CONNDISC
MQCONN/MQCONNX count
Failed MQCONN/MQCONNX count
Concurrent connections - high water mark
MQDISC count
Type: OPENCLOSE
MQOPEN count
Failed MQOPEN count
MQCLOSE count
Failed MQCLOSE count
Type: INQSET
MQINQ count
Failed MQINQ count
MQSET count
Failed MQSET count
Type: PUT
Interval total MQPUT/MQPUT1 count
Interval total MQPUT/MQPUT1 byte count
Non-persistent message MQPUT count
Persistent message MQPUT count
Failed MQPUT count
Non-persistent message MQPUT1 count
Persistent message MQPUT1 count
Failed MQPUT1 count
Put non-persistent messages - byte count
Put persistent messages - byte count
MQSTAT count
Type: GET
Interval total destructive get- count
Interval total destructive get - byte count
Non-persistent message destructive get - count
Persistent message destructive get - count
Failed MQGET - count
Got non-persistent messages - byte count
Got persistent messages - byte count
Non-persistent message browse - count
Persistent message browse - count
Failed browse count
Non-persistent message browse - byte count
Persistent message browse - byte count
Expired message count
Purged queue count
MQCB count
Failed MQCB count
MQCTL count
Type: SYNCPOINT
Commit count
Rollback count
Type: SUBSCRIBE
Create durable subscription count
Alter durable subscription count
Resume durable subscription count
Create non-durable subscription count
Failed create/alter/resume subscription count
Delete durable subscription count
Delete non-durable subscription count
Subscription delete failure count
MQSUBRQ count
Failed MQSUBRQ count
Durable subscriber - high water mark
Durable subscriber - low water mark
Non-durable subscriber - high water mark
Non-durable subscriber - low water mark
Type: PUBLISH
Topic MQPUT/MQPUT1 interval total
Interval total topic bytes put
Published to subscribers - message count
Published to subscribers - byte count
Non-persistent - topic MQPUT/MQPUT1 count
Persistent - topic MQPUT/MQPUT1 count
Failed topic MQPUT/MQPUT1 count
Class: STATQ
Type: GENERAL
messages expired
queue purged count
average queue time uSec
Queue depth
Type: OPENCLOSE
MQOPEN count
MQCLOSE count
Type: INQSET
MQINQ count
MQSET count
Type: PUT
MQPUT/MQPUT1 count
MQPUT byte count
MQPUT non-persistent message count
MQPUT persistent message count
rolled back MQPUT count
MQPUT1 non-persistent message count
MQPUT1 persistent message count
non-persistent byte count
persistent byte count
lock contention
queue avoided puts
queue avoided bytes
Type: GET
MQGET count
MQGET byte count
destructive MQGET non-persistent message count
destructive MQGET persistent message count
rolled back MQGET count
destructive MQGET non-persistent byte count
destructive MQGET persistent byte count
MQGET browse non-persistent message count
MQGET browse persistent message count
MQGET browse non-persistent byte count
MQGET browse persistent byte count
destructive MQGET fails
destructive MQGET fails with MQRC_NO_MSG_AVAILABLE
destructive MQGET fails with MQRC_TRUNCATED_MSG_FAILED
MQGET browse fails
MQGET browse fails with MQRC_NO_MSG_AVAILABLE
MQGET browse fails with MQRC_TRUNCATED_MSG_FAILED
Class: NHAREPLICA
Type: REPLICATION
Synchronous log bytes sent
Catch-up log bytes sent
Log write average acknowledgement latency uSec
Log write average acknowledgement size
Backlog bytes
Backlog average bytes
Other metrics and attributes
----------------------------
There are other metrics extracted or calculated by this package, or used as tags. Most of
these values come from "DISPLAY xxSTATUS" or "DISPLAY xx" commands for the relevant object type and name.
Each line here shows the variable in the mqmetric package source code (so you can see how it is derived)
and the basic associated metric name.
As an example, one of the metrics available in Prometheus might be "ibmmq_channel_bytes_sent" with
the full name created by combining the product name, the class, and the individual metric.
Access to these metrics requires the "useObjectStatus" (or "-ibmmq.useStatus" as command line flag) configuration
attribute to be set for the collector.
Class: amqp
ATTR_CHL_AMQP_CLIENT_ID : clientid
ATTR_CHL_AMQP_CONNECTIONS : connection_count
ATTR_CHL_AMQP_MESSAGES_RECEIVED : messages_rcvd
ATTR_CHL_AMQP_MESSAGES_SENT : messages_sent
Class: channel
ATTR_CHL_BATCHES : batches
ATTR_CHL_BATCHSZ_LONG : batchsz_long
ATTR_CHL_BATCHSZ_SHORT : batchsz_short
ATTR_CHL_BUFFERS_RCVD : buffers_rcvd
ATTR_CHL_BUFFERS_SENT : buffers_sent
ATTR_CHL_BYTES_RCVD : bytes_rcvd
ATTR_CHL_BYTES_SENT : bytes_sent
ATTR_CHL_CONNNAME : connname
ATTR_CHL_CUR_INST : cur_inst
ATTR_CHL_INSTANCE_TYPE : instance_type
ATTR_CHL_JOBNAME : jobname
ATTR_CHL_MAX_INST : attribute_max_inst
ATTR_CHL_MAX_INSTC : attribute_max_instc
ATTR_CHL_MESSAGES : messages
ATTR_CHL_NETTIME_LONG : nettime_long
ATTR_CHL_NETTIME_SHORT : nettime_short
ATTR_CHL_RQMNAME : rqmname
ATTR_CHL_SINCE_MSG : time_since_msg
ATTR_CHL_STATUS : status
ATTR_CHL_SUBSTATE : substate
ATTR_CHL_TYPE : type
ATTR_CHL_XQTIME_LONG : xmitq_time_long
ATTR_CHL_XQTIME_SHORT : xmitq_time_short
Class: cluster
ATTR_CLUSTER_QMTYPE : qmtype
ATTR_CLUSTER_STATUS : status
ATTR_CLUSTER_SUSPEND : suspend
Class: qmgr
ATTR_QMGR_ACTIVE_LISTENERS : active_listeners
ATTR_QMGR_CHINIT_STATUS : channel_initiator_status
ATTR_QMGR_CMD_SERVER_STATUS : command_server_status
ATTR_QMGR_CONNECTION_COUNT : connection_count
ATTR_QMGR_LOG_ARCHIVE_EXTENT : log_extent_archive
ATTR_QMGR_LOG_ARCHIVE_SIZE : log_size_archive
ATTR_QMGR_LOG_CURRENT_EXTENT : log_extent_current
ATTR_QMGR_LOG_MEDIA_EXTENT : log_extent_media
ATTR_QMGR_LOG_MEDIA_SIZE : log_size_media
ATTR_QMGR_LOG_RESTART_EXTENT : log_extent_restart
ATTR_QMGR_LOG_RESTART_SIZE : log_size_restart
ATTR_QMGR_LOG_REUSABLE_SIZE : log_size_reusable
ATTR_QMGR_MAX_ACTIVE_CHANNELS : max_active_channels
ATTR_QMGR_MAX_CHANNELS : max_channels
ATTR_QMGR_MAX_TCP_CHANNELS : max_tcp_channels
ATTR_QMGR_STATUS : status
ATTR_QMGR_UPTIME : uptime
Class: queue
ATTR_Q_CURFSIZE : qfile_current_size
ATTR_Q_CURMAXFSIZE : qfile_max_size
ATTR_Q_DEPTH : depth
ATTR_Q_INTERVAL_GET : mqget_count
ATTR_Q_INTERVAL_HI_DEPTH : hi_depth
ATTR_Q_INTERVAL_PUT : mqput_mqput1_count
ATTR_Q_IPPROCS : input_handles
ATTR_Q_MAX_DEPTH : attribute_max_depth
ATTR_Q_MSGAGE : oldest_message_age
ATTR_Q_OPPROCS : output_handles
ATTR_Q_QTIME_LONG : qtime_long
ATTR_Q_QTIME_SHORT : qtime_short
ATTR_Q_SINCE_GET : time_since_get
ATTR_Q_SINCE_PUT : time_since_put
ATTR_Q_UNCOM : uncommitted_messages
ATTR_Q_USAGE : attribute_usage
Class: sub
ATTR_SUB_ID : subid
ATTR_SUB_MESSAGES : messsages_received
ATTR_SUB_SINCE_PUB_MSG : time_since_message_published
ATTR_SUB_TOPIC_STRING : topic
ATTR_SUB_TYPE : type
Class: topic
ATTR_TOPIC_PUBLISHER_COUNT : publisher_count
ATTR_TOPIC_PUB_MESSAGES : messages_published
ATTR_TOPIC_SINCE_PUB_MSG : time_since_msg_published
ATTR_TOPIC_SINCE_SUB_MSG : time_since_msg_received
ATTR_TOPIC_STATUS_TYPE : type
ATTR_TOPIC_SUB_MESSAGES : messages_received
ATTR_TOPIC_SUBSCRIBER_COUNT : subscriber_count
Class: bufferpool/pageset
ATTR_BP_CLASS : pageclass
ATTR_BP_FREE : buffers_free
ATTR_BP_FREE_PERCENT : buffers_free_percent
ATTR_BP_LOCATION : location
ATTR_BP_TOTAL : buffers_total
ATTR_PS_BPID : bufferpool
ATTR_PS_EXPAND_COUNT : expansion_count
ATTR_PS_NP_PAGES : pages_nonpersistent
ATTR_PS_P_PAGES : pages_persistent
ATTR_PS_STATUS : status
ATTR_PS_TOTAL : pages_total
ATTR_PS_UNUSED : pages_unused
This page was automatically generated from the source tree on 2024-02-22 11:01:40