公開プレビュー
この機能は現在、公開プレビューです。
IBM MQ統合は、IBM MQからディメンションメトリックを収集して送信します。
このメトリックデータは、事前に作成されたダッシュボードで表示したり、アラートポリシーを作成したり、カスタムクエリやグラフを作成したりできます。
New Relic IBM MQ Monitorクイックスタートを介してインストールされたダッシュボード。
統合は、Prometheusエクスポーターを介してIBM MQ APIをスクレイピングすることによってデータを取得します。
重要
IBM MQ統合は、ARM64アーキテクチャーをサポートしていません。
IBM MQモニター統合をインストールするには、以下のステップを実行してください。
互換性と要件
IBM MQバージョン
私たちの統合は、IBM MQ 9.0以降と互換性があります。
対応するオペレーティング・システム
- Linux
- ウィンドウズ
特定の Linux および Windows バージョンの包括的なリストについては、 互換性のあるオペレーティング システムの表を確認してください。
重要
ARM64アーキテクチャには対応していません。
システム要求
- インフラストラクチャエージェント、最小バージョン1.24.0をインストールします。
- インフラストラクチャ エージェントと互換性のあるLinux ディストリビューションまたは Windows バージョン。
- エージェントボックス上のIBM MQ再頒布可能クライアントライブラリ。
- Linux の
LD_LIBRARY_PATH
環境変数でライブラリ パスを確認または追加するか、Windows で次の手順に従います。 - MQでキュー統計の監視が有効になっていることを確認します。
- MQで読み取り専用権限を持つユーザーを作成します。
インストールしてアクティブ化する
統合をインストールするには、ご使用の環境の指示に従ってください。
その他の環境
このドキュメントはインストールで役立ちましたか。
統合を構成する
統合を構成するには、統合のYAML構成ファイルibmmq-config.yml
の構成を編集します。統合のYAML形式の構成では、必要なログインクレデンシャルを配置し、データの収集方法を構成できます。どのオプションを変更するかは、設定と設定によって異なります。構成ファイルには、すべての統合に適用できる共通の設定があります。
これらの一般的な設定についてすべて読むには、 構成フォーマットのドキュメントを参照してください。
IBM MQインスタンス設定
次の構成オプションを使用できます。
設定 | 説明 | デフォルト |
---|---|---|
ホスト名 | IBM MQサービスのホスト名 | 該当なし |
port | IBM MQサービスのポート | 該当なし |
queue_manager | キューマネージャー名 | 該当なし |
チャネル | キュー・マネージャーへの接続に使用されるチャネル名。通常、次を使用できます | 該当なし |
username | IBM MQ サービスに対して認証するためのユーザー名。パスワードが指定されていない場合、ユーザー/パスワード認証は無効になり、構成でユーザー名を指定する必要はありません。エクスポーターは、統合を実行するユーザー | 該当なし |
password | IBM MQサービスに対して認証するためのパスワード | 該当なし |
監視されたキュー | 監視するキュー(ワイルドカードと除外する!は受け入れられます) | 該当なし |
monitor_channels | 監視するチャネル(ワイルドカードと除外する!を使用できます) | 該当なし |
monitor_topics | 監視するトピック(ワイルドカードと除外する!を使用できます) | 該当なし |
monitor_subscriptions | 監視するサブスクリプション(ワイルドカードと除外する!は受け入れられます) | 該当なし |
エクスポーター_ポート | スクラップエンドポイントを公開するポート。これが提供されない場合、エクスポーターを起動する際にランダムなポートが使用されます。 | ランダムポート |
scrape_timeout | スクレイプリクエストがタイムアウトするまでの時間 | 5s |
mqsslkeyr | TLS の構成に必要 MQSSLKEYR は、ユーザーまたはサーバーに属するデジタル証明書を保持するキーストアの場所を指定します。 | 該当なし |
ccdt_url | ccdt ファイルへの TLS パスを構成する必要があります。MQCCDTURL と IBMMQ_CONNECTION_CCDTURL の 2 つの異なる環境変数が自動的に設定されます。 | 該当なし |
家 | IBMMQ クライアントには、HOME 環境変数で指定されたディレクトリーに書き込む許可が必要です。 | 該当なし |
ld_library_path | エクスポーターが使用する IBMMQ クライアントの LD_LIBRARY_PATH 環境変数。 | 該当なし |
ibmmq-config.ymlサンプルファイル
データを見つけて使用する
- New Relic IBM MQモニターのクイックスタートは、 Instant Observability(I / O)から利用できます。データを簡単に探索し、コンテキストを理解し、問題をより迅速に解決できるダッシュボードを提供します。
- データを検索して使用する方法の詳細については、統合データについてを参照してください。
- メトリックは、エンティティ
IBMMQ_MANAGER
およびIBMMQ_QUEUE
のメトリックサンプルおよびイベントタイプに添付されます。 - トラブルシューティングの目的で、またはカスタムチャートやダッシュボードを作成するために、 NewRelicのデータをクエリできます。
メトリックデータ
IBMMQ_MANAGER
とIBMMQ_QUEUE
の 2 つのエンティティが作成されます。
次のディメンションメトリックは、エクスポーターをスクレイピングしてキャプチャされ、エンティティIBMMQ_MANAGER
にリンクされます。
名前 | 説明 | ディメンション |
---|---|---|
| バッファrcvd |
|
| 送信されたバッファ |
|
| バイトrcvd |
|
| 送信されたバイト数 |
|
| チャネルインスタンスタイプ |
|
| メッセージ(SVRCONNのAPI呼び出し) |
|
|
| |
| チャネルステータス-簡略化 |
|
| チャネルサブステート |
|
| メッセージからの時間 |
|
| チャネルタイプ |
|
| 永続的なサブスクリプション数を変更する |
|
| チャネルイニシエーターのステータス |
|
| コマンドサーバーのステータス |
|
| コミット数 |
|
| 同時接続-最高水準点 |
|
| 接続数 |
|
| CPU負荷-15分の平均 |
|
| CPU負荷-5分平均 |
|
| CPU負荷-1分間の平均 |
|
| 永続的なサブスクリプションカウントを作成する |
|
| 非永続的なサブスクリプションカウントを作成する |
|
| 永続的なサブスクリプション数を削除する |
|
| 非永続サブスクリプションカウントを削除します |
|
| 耐久性のある加入者-最高水準点 |
|
| 耐久性のある加入者-最低水準点 |
|
| 期限切れのメッセージ数 |
|
| 処理されたリソースパブリケーションの数 |
|
| 失敗した参照カウント |
|
| サブスクリプションカウントの作成/変更/再開に失敗しました |
|
| 失敗したMQCBカウント |
|
| MQCLOSEカウントの失敗 |
|
| 失敗したMQCONN/MQCONNXカウント |
|
| 失敗したMQGET-カウント |
|
| MQINQカウントの失敗 |
|
| MQOPENカウントの失敗 |
|
| MQPUTカウントの失敗 |
|
| MQPUT1カウントの失敗 |
|
| 失敗したMQSETカウント |
|
| 失敗したMQSUBRQカウント |
|
| 失敗したトピックMQPUT/MQPUT1カウント |
|
| 非永続的なメッセージを受け取りました-バイト数 |
|
| 永続的なメッセージを受け取りました-バイト数 |
|
| インターバル合計破壊取得-バイトカウント |
|
| インターバル合計破壊的取得カウント |
|
| 間隔の合計MQPUT/MQPUT1バイト数 |
|
| 間隔の合計MQPUT/MQPUT1カウント |
|
| 間隔合計トピックバイト数 |
|
| ログ-現在使用中のプライマリスペース |
|
| ログファイルシステム-使用中のバイト |
|
| ログファイルシステム-最大バイト数 |
|
| ログ-使用中のバイト |
|
| ログ-書き込まれた論理バイト |
|
| ログ-最大バイト数 |
|
| ログ-書き込まれた物理バイト |
|
| ログ-ワークロードのプライマリスペース使用率 |
|
| ログ-書き込みレイテンシ |
|
| ログ-書き込みサイズ |
|
| MQエラーファイルシステム-空き領域 |
|
| MQエラーファイルシステム-使用中のバイト |
|
| MQFDCファイル数 |
|
| MQトレースファイルシステム-空き領域 |
|
| MQトレースファイルシステム-使用中のバイト |
|
| MQCBカウント |
|
| MQCLOSEカウント |
|
| MQCONN/MQCONNXカウント |
|
| MQCTLカウント |
|
| MQDISCカウント |
|
| MQINQカウント |
|
| MQOPENカウント |
|
| MQSETカウント |
|
| MQSTATカウント |
|
| MQSUBRQカウント |
|
| 非耐久性のサブスクライバー-最高水準点 |
|
| 非耐久性の加入者-最低水準点 |
|
| 非永続的なメッセージの参照-バイトカウント |
|
| 非永続的なメッセージの参照-カウント |
|
| 非永続的なメッセージ破壊的なget-count |
|
| 非永続メッセージMQPUTカウント |
|
| 非永続メッセージMQPUT1カウント |
|
| 非永続的-トピックMQPUT/MQPUT1カウント |
|
| 永続的なメッセージの参照-バイトカウント |
|
| 永続的なメッセージの参照-カウント |
|
| 永続的なメッセージの破壊的なget-count |
|
| 永続メッセージMQPUTカウント |
|
| 永続メッセージMQPUT1カウント |
|
| 永続的-トピックMQPUT/MQPUT1カウント |
|
| サブスクライバーに公開-バイト数 |
|
| サブスクライバーに公開-メッセージ数 |
|
| パージされたキュー数 |
|
| 非永続的なメッセージを入れる-バイト数 |
|
| 永続的なメッセージを入れる-バイト数 |
|
| キューマネージャファイルシステム-空き領域 |
|
| キューマネージャファイルシステム-使用中のバイト |
|
| RAM空き率 |
|
| RAMの合計バイト数 |
|
| RAM合計バイト数-キュー・マネージャーの見積もり |
|
| 永続的なサブスクリプションカウントを再開します |
|
| ロールバックカウント |
|
| キューマネージャーのステータス |
|
| サブスクリプション削除の失敗数 |
|
| システムCPU時間-キューマネージャーの推定パーセンテージ |
|
| システムCPU時間のパーセンテージ |
|
| トピックMQPUT/MQPUT1間隔の合計 |
|
| アップタイム |
|
| ユーザーCPU時間-キューマネージャーの推定パーセンテージ |
|
| ユーザーCPU時間の割合 |
|
| 受信したメッセージ |
|
| メッセージを受信してからの時間 |
|
| サブスクリプションタイプ |
|
| 受信したメッセージ |
|
| 出版社の数 |
|
| 加入者数 |
|
| メッセージからの時間 |
|
次のディメンションメトリックは、エクスポーターをスクレイピングしてキャプチャされ、エンティティIBMMQ_QUEUE
にリンクされます。
名前 | 説明 | ディメンション |
---|---|---|
| キューの最大深度 |
|
| キューの使用 |
|
| 平均キュー時間 |
|
| キュー回避バイト |
|
| キュー回避プット |
|
| キューの深さ |
|
| 破壊的なMQGETが失敗する |
|
| 破壊的なMQGETはMQRC_NO_MSG_AVAILABLEで失敗します |
|
| 破壊的なMQGETはMQRC_TRUNCATED_MSG_FAILEDで失敗します |
|
| 破壊的なMQGET非永続バイトカウント |
|
| 破壊的なMQGET非永続メッセージ数 |
|
| 破壊的なMQGET永続バイト数 |
|
| 破壊的なMQGET永続メッセージ数 |
|
| メッセージの有効期限が切れました |
|
| 入力ハンドル |
|
| ロック競合 |
|
| MQCLOSEカウント |
|
| MQGETブラウズが失敗する |
|
| MQGETブラウズがMQRC_NO_MSG_AVAILABLEで失敗する |
|
| MQGETブラウズがMQRC_TRUNCATED_MSG_FAILEDで失敗する |
|
| MQGETブラウズ非永続バイトカウント |
|
| MQGETブラウズの非永続メッセージ数 |
|
| MQGETブラウズ永続バイト数 |
|
| MQGETブラウズ永続メッセージ数 |
|
| MQGETバイト数 |
|
| MQGETカウント |
|
| MQINQカウント |
|
| MQOPENカウント |
|
| MQPUTバイトカウント |
|
| MQPUT/MQPUT1カウント |
|
| MQPUT非永続メッセージ数 |
|
| MQPUT永続メッセージ数 |
|
| MQPUT1非永続メッセージ数 |
|
| MQPUT1永続メッセージ数 |
|
| MQSETカウント |
|
| 非永続的なバイトカウント |
|
| 最古のメッセージ |
|
| 入力ハンドル |
|
| 永続的なバイト数 |
|
| キューのパージされたカウント |
|
| キューファイルの現在のサイズ |
|
| キューファイルの最大サイズ |
|
| 長いキュー時間 |
|
| キュー時間が短い |
|
| MQGETカウントをロールバックしました |
|
| MQPUTカウントをロールバックしました |
|
| 取得してからの時間 |
|
| 入れてからの時間 |
|
| コミットされていないメッセージ(カウント) |
|
ソースコードを確認してください
この統合はオープン ソース ソフトウェアです。これは、そのソース コードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできることを意味します。
さらに、この統合は、コミュニティによって作成されたオープンソースエクスポーターを活用します。