Skip to content

[ibmmq_otel] IBM MQ Opentelemetry Assets#17896

Merged
ritalwar merged 6 commits intoelastic:mainfrom
ritalwar:ibmmq_otel_content_pack
Apr 9, 2026
Merged

[ibmmq_otel] IBM MQ Opentelemetry Assets#17896
ritalwar merged 6 commits intoelastic:mainfrom
ritalwar:ibmmq_otel_content_pack

Conversation

@ritalwar
Copy link
Copy Markdown
Contributor

Proposed commit message

This PR adds IBM MQ Otel content pack which include assets like dashboards, alert_rule_templates and slo_template.

Checklist

  • I have reviewed tips for building integrations and this pull request is aligned with them.
  • I have verified that all data streams collect metrics or logs.
  • I have added an entry to my package's changelog.yml file.
  • I have verified that Kibana version constraints are current according to guidelines.
  • I have verified that any added dashboard complies with Kibana's Dashboard good practices

Author's Checklist

  • [ ]

How to test this PR locally

Related issues

Screenshots

resources_and_performance error_analysis message_traffic overview

@ritalwar ritalwar requested a review from a team as a code owner March 19, 2026 09:47
@ritalwar ritalwar requested a review from a team March 19, 2026 09:48
@ritalwar ritalwar self-assigned this Mar 19, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 19, 2026

Vale Linting Results

Summary: 4 warnings found

⚠️ Warnings (4)
File Line Rule Message
packages/ibmmq_otel/docs/README.md 5 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'using' instead of 'via'.
packages/ibmmq_otel/docs/README.md 34 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.
packages/ibmmq_otel/docs/README.md 36 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.
packages/ibmmq_otel/docs/README.md 37 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.

The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

@ritalwar ritalwar added documentation Improvements or additions to documentation. Applied to PRs that modify *.md files. integration Label used for meta issues tracking each integration dashboard Relates to a Kibana dashboard bug, enhancement, or modification. New Integration Issue or pull request for creating a new integration package. Team:Obs-InfraObs Observability Infrastructure Monitoring team [elastic/obs-infraobs-integrations] and removed integration Label used for meta issues tracking each integration labels Mar 19, 2026
The IBM MQ OpenTelemetry assets have been tested with:

- OpenTelemetry `prometheusreceiver` v0.146.0 from OpenTelemetry Collector Contrib.
- IBMMQ v9.4.5.0
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- IBMMQ v9.4.5.0
- IBM MQ v9.4.5.0

description: "IBM MQ Assets from OpenTelemetry Collector"
type: content
categories:
- message_queue
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add observability category

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces a new ibmmq_otel content package that ships Kibana assets (dashboards, alerting rule templates, and SLO templates) for monitoring IBM MQ metrics ingested via OpenTelemetry.

Changes:

  • Add ibmmq_otel package scaffold (manifest.yml, changelog.yml, docs, icons).
  • Add Kibana assets: 4 dashboards, 9 alerting rule templates, and 2 SLO templates.
  • Add _dev/shared dashboard definitions and update CODEOWNERS.

Reviewed changes

Copilot reviewed 19 out of 28 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
packages/ibmmq_otel/manifest.yml Defines the content package metadata, constraints, discovery dataset, screenshots, and icon.
packages/ibmmq_otel/changelog.yml Adds initial changelog entry for version 0.1.0.
packages/ibmmq_otel/docs/README.md Documents what the content pack provides and how to collect/export IBM MQ metrics via OTel.
packages/ibmmq_otel/img/ibmmq_otel_logo.svg Adds the package icon.
packages/ibmmq_otel/img/ibmmq_overview.png Adds screenshot referenced by the manifest.
packages/ibmmq_otel/img/ibmmq_resources.png Adds screenshot referenced by the manifest.
packages/ibmmq_otel/img/ibmmq_message_traffic.png Adds screenshot referenced by the manifest.
packages/ibmmq_otel/img/ibmmq_error_analysis.png Adds screenshot referenced by the manifest.
packages/ibmmq_otel/kibana/dashboard/ibmmq_otel-overview.json Adds the “[IBM MQ OTel] Overview” dashboard saved object.
packages/ibmmq_otel/kibana/dashboard/ibmmq_otel-message-traffic.json Adds the “[IBM MQ OTel] Message Traffic” dashboard saved object.
packages/ibmmq_otel/kibana/dashboard/ibmmq_otel-error-analysis.json Adds the “[IBM MQ OTel] Error Analysis” dashboard saved object.
packages/ibmmq_otel/kibana/dashboard/ibmmq_otel-resources.json Adds the “[IBM MQ OTel] Resources & Performance” dashboard saved object.
packages/ibmmq_otel/kibana/alerting_rule_template/ibmmq_otel-cpu-load-high.json Adds an ES
packages/ibmmq_otel/kibana/alerting_rule_template/ibmmq_otel-expired-messages.json Adds an ES
packages/ibmmq_otel/kibana/alerting_rule_template/ibmmq_otel-failed-connections.json Adds an ES
packages/ibmmq_otel/kibana/alerting_rule_template/ibmmq_otel-failed-message-operations.json Adds an ES
packages/ibmmq_otel/kibana/alerting_rule_template/ibmmq_otel-fdc-files-increasing.json Adds an ES
packages/ibmmq_otel/kibana/alerting_rule_template/ibmmq_otel-high-log-write-latency.json Adds an ES
packages/ibmmq_otel/kibana/alerting_rule_template/ibmmq_otel-high-rollback-ratio.json Adds an ES
packages/ibmmq_otel/kibana/alerting_rule_template/ibmmq_otel-log-filesystem-critically-low.json Adds an ES
packages/ibmmq_otel/kibana/alerting_rule_template/ibmmq_otel-queue-manager-filesystem-low.json Adds an ES
packages/ibmmq_otel/kibana/slo_template/ibmmq_otel-log-write-latency-99.5-Rolling30Days.json Adds SLO template for log write latency objective.
packages/ibmmq_otel/kibana/slo_template/ibmmq_otel-message-put-availability-99.5-Rolling30Days.json Adds SLO template for MQPUT/MQPUT1 availability objective.
packages/ibmmq_otel/_dev/shared/ibmmq-overview.yaml Adds source YAML used to generate/maintain the Overview dashboard.
packages/ibmmq_otel/_dev/shared/ibmmq-message-traffic.yaml Adds source YAML used to generate/maintain the Message Traffic dashboard.
packages/ibmmq_otel/_dev/shared/ibmmq-error-analysis.yaml Adds source YAML used to generate/maintain the Error Analysis dashboard.
packages/ibmmq_otel/_dev/shared/ibmmq-resources.yaml Adds source YAML used to generate/maintain the Resources & Performance dashboard.
.github/CODEOWNERS Adds CODEOWNERS entry for the new package directory.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +2220 to +2221
"type": "number",
"esType": "long"
Copy link

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The attributes.qmgr column is a string (queue manager name), but this Lens/ES|QL column definition marks it as a numeric (meta.type: number, meta.esType: long). This can cause the datatable to mis-render or error at runtime. Remove the numeric meta for this column (as done for other string dimensions) or set it to a string/keyword type.

Suggested change
"type": "number",
"esType": "long"
"type": "string",
"esType": "keyword"

Copilot uses AI. Check for mistakes.
Comment on lines +2588 to +2589
"type": "number",
"esType": "long"
Copy link

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The attributes.qmgr column is used as a dimension (queue manager name), but it is annotated as a numeric (meta.type: number, meta.esType: long). This likely conflicts with the ES|QL result type and can break the datatable. Remove the numeric meta for this column or change it to a string/keyword type.

Suggested change
"type": "number",
"esType": "long"
"type": "string",
"esType": "keyword"

Copilot uses AI. Check for mistakes.
Comment on lines +2333 to +2336
"meta": {
"type": "number",
"esType": "long"
},
Copy link

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

attributes.qmgr represents the queue manager name (string), but this column is declared as numeric (meta.type: number, meta.esType: long). This mismatch can cause the Lens datatable to fail type validation. Remove the meta block for this column (or set it to string/keyword).

Suggested change
"meta": {
"type": "number",
"esType": "long"
},

Copilot uses AI. Check for mistakes.
Comment on lines +3433 to +3434
"type": "number",
"esType": "long"
Copy link

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The datatable defines attributes.qmgr (queue manager name) with numeric metadata (meta.type: number, meta.esType: long). Since ES|QL will return this as a string, this metadata should be removed or corrected to a string/keyword type to avoid rendering/runtime issues.

Suggested change
"type": "number",
"esType": "long"
"type": "string",
"esType": "keyword"

Copilot uses AI. Check for mistakes.
The IBM MQ OpenTelemetry assets have been tested with:

- OpenTelemetry `prometheusreceiver` v0.146.0 from OpenTelemetry Collector Contrib.
- IBMMQ v9.4.5.0
Copy link

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling/branding: the compatibility list uses "IBMMQ"; this should be "IBM MQ" for consistency with the rest of the document.

Suggested change
- IBMMQ v9.4.5.0
- IBM MQ v9.4.5.0

Copilot uses AI. Check for mistakes.
description: "IBM MQ Assets from OpenTelemetry Collector"
type: content
categories:
- message_queue
Copy link

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For consistency with other OpenTelemetry content packs, consider adding the observability category (e.g. packages/rabbitmq_otel/manifest.yml includes message_queue, observability, opentelemetry). This improves discoverability in the Integrations UI.

Suggested change
- message_queue
- message_queue
- observability

Copilot uses AI. Check for mistakes.
@elasticmachine
Copy link
Copy Markdown

💚 Build Succeeded

History

cc @ritalwar

@muthu-mps muthu-mps requested a review from ishleenk17 April 9, 2026 10:46
@ritalwar ritalwar merged commit d332051 into elastic:main Apr 9, 2026
11 checks passed
@elastic-vault-github-plugin-prod
Copy link
Copy Markdown

Package ibmmq_otel - 0.1.0 containing this change is available at https://epr.elastic.co/package/ibmmq_otel/0.1.0/

@andrewkroh andrewkroh added the Integration:ibmmq_otel IBM MQ OpenTelemetry Assets label Apr 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dashboard Relates to a Kibana dashboard bug, enhancement, or modification. documentation Improvements or additions to documentation. Applied to PRs that modify *.md files. Integration:ibmmq_otel IBM MQ OpenTelemetry Assets New Integration Issue or pull request for creating a new integration package. Team:Obs-InfraObs Observability Infrastructure Monitoring team [elastic/obs-infraobs-integrations]

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants