Skip to content

Commit 18d0ecc

Browse files
fix invalid code blocks (#20401)
* fix invalid code blocks * fix invalid tag blocks * Fix tabs --------- Co-authored-by: hestonhoffman <hestonhoffman@gmail.com>
1 parent 306681b commit 18d0ecc

File tree

2 files changed

+41
-31
lines changed

2 files changed

+41
-31
lines changed

ibm_mq/README.md

Lines changed: 20 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -141,10 +141,10 @@ There are many ways to set up permissions in IBM MQ. Depending on how your setup
141141

142142
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.
143143

144-
{{< code-block lang="shell" >}}
144+
```shell
145145
setmqaut -m QM1 -n SYSTEM.ADMIN.COMMAND.QUEUE -t queue -g mqclient +dsp +inq +get +put
146146
setmqaut -m QM1 -n SYSTEM.MQEXPLORER.REPLY.MODEL -t queue -g mqclient +dsp +inq +get +put
147-
{{< /code-block >}}
147+
```
148148

149149
**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:
150150

@@ -184,15 +184,15 @@ To configure this check for an Agent running on a host:
184184
- `port`: The port that IBM MQ has exposed
185185
- `convert_endianness`: You need to enable this if your MQ server is running on AIX or IBM i
186186

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.
188188

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
190190

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+
```
196196
197197
2. [Restart the Agent][6].
198198
@@ -271,40 +271,43 @@ See [service_checks.json][11] for a list of service checks provided by this inte
271271
## Troubleshooting
272272

273273
### Reset queue statistics MQRC_NOT_AUTHORIZED permission warning
274+
274275
If you are getting the following warning:
275276

276277
```
277278
Warning: Error getting pcf queue reset metrics for SAMPLE.QUEUE.1: MQI Error. Comp: 2, Reason 2035: FAILED: MQRC_NOT_AUTHORIZED
278279
```
279280

280281
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+
281283
```yaml
282-
collect_reset_queue_metrics: false
284+
collect_reset_queue_metrics: false
283285
```
284286

285287
### High resource utilization
288+
286289
The IBM MQ check performs queries on the server, sometimes these queries can be expensive and cause a degradation on the check.
287290

288291
If you observe that the check is taking a long time to execute or that is consuming many resources on your host,
289292
you can potentially reduce the scope of the check by trying the following:
290293

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`.
295298

296299
### 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.
298302

299303
### 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.
301304

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.
302306

303307
### Other
304308

305309
Need help? Contact [Datadog support][12].
306310

307-
308311
## Further Reading
309312

310313
Additional helpful documentation, links, and articles:

kube_apiserver_metrics/README.md

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -36,8 +36,8 @@ You can review all available configuration options in the [kube_apiserver_metric
3636

3737
You can annotate the kubernetes service in your `default` namespace with the following:
3838

39-
{{< tabs >}}
40-
{{% tab "Annotations v2 (for Datadog Agent v7.36+)" %}}
39+
<!-- xxx tabs xxx -->
40+
<!-- xxx tab "Annotations v2 (for Datadog Agent v7.36)" xxx -->
4141

4242
```yaml
4343
ad.datadoghq.com/endpoints.checks: |
@@ -49,11 +49,12 @@ ad.datadoghq.com/endpoints.checks: |
4949
}
5050
]
5151
}
52-
}
53-
52+
}
5453
```
55-
{{% /tab %}}
56-
{{% tab "Annotations v1 (for Datadog Agent < v7.36)" %}}
54+
55+
<!-- xxz tab xxx -->
56+
57+
<!-- xxx tab "Annotations v1 (for Datadog Agent < v7.36)" xxx -->
5758
5859
```yaml
5960
annotations:
@@ -62,8 +63,9 @@ annotations:
6263
ad.datadoghq.com/endpoints.instances:
6364
'[{ "prometheus_url": "https://%%host%%:%%port%%/metrics"}]'
6465
```
65-
{{% /tab %}}
66-
{{< /tabs >}}
66+
67+
<!-- xxz tab xxx -->
68+
<!-- xxz tabs xxx -->
6769

6870
Then the Datadog Cluster Agent schedules the check(s) for each endpoint onto Datadog Agent(s).
6971

@@ -75,8 +77,10 @@ You can also run the check by configuring the endpoints directly in the `kube_ap
7577

7678
Provide a [configuration][13] to your Cluster Agent to setup a Cluster Check:
7779

78-
{{< tabs >}}
79-
{{% tab "Helm" %}}
80+
<!-- xxx tabs xxx -->
81+
82+
<!-- xxx tab "Helm" xxx -->
83+
8084
```yaml
8185
clusterAgent:
8286
confd:
@@ -90,9 +94,10 @@ clusterAgent:
9094
instances:
9195
- prometheus_url: "https://%%host%%:%%port%%/metrics"
9296
```
93-
{{% /tab %}}
9497
95-
{{% tab "Operator" %}}
98+
<!-- xxz tab xxx -->
99+
100+
<!-- xxx tab "Operator" xxx -->
96101
97102
```yaml
98103
spec:
@@ -111,8 +116,10 @@ spec:
111116
instances:
112117
- prometheus_url: "https://%%host%%:%%port%%/metrics"
113118
```
114-
{{% /tab %}}
115-
{{< /tabs >}}
119+
120+
<!-- xxz tab xxx -->
121+
122+
<!-- xxz tabs xxx -->
116123
117124
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.
118125

0 commit comments

Comments
 (0)