You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: ibm_mq/README.md
+20-17Lines changed: 20 additions & 17 deletions
Original file line number
Diff line number
Diff line change
@@ -141,10 +141,10 @@ There are many ways to set up permissions in IBM MQ. Depending on how your setup
141
141
142
142
The example below sets the required permissions on the queue manager `QM1` for the `mqclient` group, the group the `datadog` user is using to execute commands. You can use wildcards to grant permissions to many queues at once.
**Note**: "Queue Monitoring" must be enabled on the MQ server and set to at least "Medium". This can be done using the MQ UI or with an `mqsc` command in the server's host:
150
150
@@ -184,15 +184,15 @@ To configure this check for an Agent running on a host:
184
184
-`port`: The port that IBM MQ has exposed
185
185
-`convert_endianness`: You need to enable this if your MQ server is running on AIX or IBM i
186
186
187
-
If you are using a username and password setup, you can set the `username` and `password`. If no username is set, the Agent process owner (`dd-agent`) is used.
187
+
If you are using a username and password setup, you can set the `username` and `password`. If no username is set, the Agent process owner (`dd-agent`) is used.
188
188
189
-
**Note**: The check only monitors the queues you have set with the `queues` parameter
189
+
**Note**: The check only monitors the queues you have set with the `queues` parameter
190
190
191
-
```yaml
192
-
queues:
193
-
- APP.QUEUE.1
194
-
- ADMIN.QUEUE.1
195
-
```
191
+
```yaml
192
+
queues:
193
+
- APP.QUEUE.1
194
+
- ADMIN.QUEUE.1
195
+
```
196
196
197
197
2. [Restart the Agent][6].
198
198
@@ -271,40 +271,43 @@ See [service_checks.json][11] for a list of service checks provided by this inte
This is due to the `datadog` user not having the `+chg` permission to collect reset queue metrics. To fix this, you can either give `+chg` permissions to the `datadog` user [using `setmqaut`][15] and collect queue reset metrics, or you can disable the `collect_reset_queue_metrics`:
282
+
281
283
```yaml
282
-
collect_reset_queue_metrics: false
284
+
collect_reset_queue_metrics: false
283
285
```
284
286
285
287
### High resource utilization
288
+
286
289
The IBM MQ check performs queries on the server, sometimes these queries can be expensive and cause a degradation on the check.
287
290
288
291
If you observe that the check is taking a long time to execute or that is consuming many resources on your host,
289
292
you can potentially reduce the scope of the check by trying the following:
290
293
291
-
* If you are using `auto_discover_queues`, try using `queue_patterns` or `queue_regex` instead to only discover certain queues. This is particularly relevant if your system creates dynamic queues.
292
-
* If you are autodiscovering queues with `queue_patterns` or `queue_regex`, try tightening the pattern or regex so it matches _less_ queues.
293
-
* Disable `auto_discover_channels` if you have too many channels.
294
-
* Disable `collect_statistics_metrics`.
294
+
-If you are using `auto_discover_queues`, try using `queue_patterns` or `queue_regex` instead to only discover certain queues. This is particularly relevant if your system creates dynamic queues.
295
+
-If you are autodiscovering queues with `queue_patterns` or `queue_regex`, try tightening the pattern or regex so it matches _less_ queues.
296
+
-Disable `auto_discover_channels` if you have too many channels.
297
+
-Disable `collect_statistics_metrics`.
295
298
296
299
### Errors in the logs
297
-
* `Unpack for type ((67108864,)) not implemented`: If you're seeing errors like this, and your MQ server is running on a IBM OS, enable `convert_endianness` and restart your Agent.
300
+
301
+
- `Unpack for type ((67108864,)) not implemented`: If you're seeing errors like this, and your MQ server is running on a IBM OS, enable `convert_endianness` and restart your Agent.
298
302
299
303
### Warnings in the logs
300
-
* `Error getting [...]: MQI Error. Comp: 2, Reason 2085: FAILED: MQRC_UNKNOWN_OBJECT_NAME`: If you're seeing messages like this, it is because the integration is trying to collect metrics from a queue that doesn't exist. This can be either due to misconfiguration or, if you're using `auto_discover_queues`, the integration can discover a [dynamic queue][16] and then, when it tries to gather its metrics, the queue no longer exists. In this case you can mitigate the issue by providing a stricter `queue_patterns` or `queue_regex`, or just ignore the warning.
301
304
305
+
- `Error getting [...]: MQI Error. Comp: 2, Reason 2085: FAILED: MQRC_UNKNOWN_OBJECT_NAME`: If you're seeing messages like this, it is because the integration is trying to collect metrics from a queue that doesn't exist. This can be either due to misconfiguration or, if you're using `auto_discover_queues`, the integration can discover a [dynamic queue][16] and then, when it tries to gather its metrics, the queue no longer exists. In this case you can mitigate the issue by providing a stricter `queue_patterns` or `queue_regex`, or just ignore the warning.
302
306
303
307
### Other
304
308
305
309
Need help? Contact [Datadog support][12].
306
310
307
-
308
311
## Further Reading
309
312
310
313
Additional helpful documentation, links, and articles:
These configurations trigger the Agent to make a request to the `kubernetes` service in the `default` namespace at its defined Endpoint IP Addresses and defined port.
0 commit comments