Skip to content

feat: Add showCustomAttribute filter config setting to include the CUSTOM attribute as tag/label #392

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

dol
Copy link

@dol dol commented Apr 8, 2025

Adds new filters.showCustomAttribute config setting to add the CUSTOM attribute data from a queue manager or queue as metrics tag/label.

Please ensure all items are complete before opening.

What

We have the requirement to annotate queue manager and queue metrics with a custom tag or label. This information helps query the metrics based on this custom label and create alerts based on this information.
The CUSTOM attribute on queue manager and queue level can be utilized for this kind of additional information. As an IBM MQ platform team we will set CUSTOM("APP(A0123)") on a queue manager or on a queue. The new capability in this PR extracts this CUSTOM data and adds it as a tag or label depending on the collector.

How

The query request of the queue manager and queue attributes was extended to include the ibmmq.MQCA_CUSTOM data.

Testing

The change was tested locally for otel, prometheus and JSON exporter.

Issues

Open point

  1. The changes to [mq-golang](https://github.com/ibm-messaging/mq-golang) were commited to the vendor folder as it's not clear how to bring the changes upstream. Should a pull request opened at mq-golang?
  2. Since I don't have any expirience with IBM MQ for z/OS I'm not sure if the custom attribute is supported in that platform. For that reason the showAndSupportsCustomLabel method was created to mark it false if the platform does not support it.

…STOM attribute as tag/label

Adds new `filters.showCustomAttribute` config setting to add the CUSTOM
attribute data from a queue manager or queue as metrics tag/label.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant