AIX IBM MQ
AIX IBM MQ input は dspmq と runmqsc を使用して Queue Manager、キュー、チャネル、リスナー、および高度なオブジェクトを収集します。
設定¶
[inputs]
# ミドルウェア input の総スイッチ。
enabled = true
[[inputs.ibm_mq]]
# インスタンス名。instance tag として使用される。
name = "QM1"
# この IBM MQ インスタンスの収集を有効にするかどうか。
enabled = true
# 収集間隔。
interval = "60s"
# 任意。収集前にインスタンス環境変数を読み込む。
env_file = ""
# cluster/topic/subscription などの高度なオブジェクトを収集するかどうか。
collect_advanced = false
# 任意。カスタム指標コマンド。key=value 行を出力する。
deep_metrics_command = ""
# Queue Manager 名。
queue_manager = "QM1"
# キューのフィルタリングルール。
queue_include = []
queue_exclude = ["SYSTEM.*"]
dead_letter_queue = "SYSTEM.DEAD.LETTER.QUEUE"
# IBM MQ コマンドのパス。
dspmq = "dspmq"
runmqsc = "runmqsc"
コマンド依存関係¶
| コマンド | 説明 |
|---|---|
dspmq -m <QM> |
Queue Manager の状態を収集する。 |
runmqsc <QM> |
QMSTATUS、QLOCAL、CHSTATUS、LSSTATUS を収集する。 |
runmqsc <QM> 高度なコマンド |
collect_advanced = true のとき CLUSQMGR、TOPIC、SUB を収集する。 |
deep_metrics_command |
カスタムコマンド。key=value 行を出力し、カスタム指標を収集する。 |
指標¶
すべての指標には host、input=ibm_mq、instance=<name> タグが追加されます。
ibm_mq_qmgr¶
| Tags & Fields | Description |
|---|---|
| queue_manager ( tag) |
Queue Manager 名。 |
| status ( tag) |
Queue Manager の状態。 |
| up | Queue Manager が Running かどうか。 種類: int | (gauge) |
ibm_mq_queue¶
| Tags & Fields | Description |
|---|---|
| queue_manager ( tag) |
Queue Manager 名。 |
| queue ( tag) |
キュー名。 |
| curdepth | 現在のキュー深度。 種類: int | (gauge) 単位: count |
| open_input | 入力オープン数。 種類: int | (gauge) 単位: count |
| open_output | 出力オープン数。 種類: int | (gauge) 単位: count |
| maxdepth | 最大キュー深度。 種類: int | (gauge) 単位: count |
| dead_letter_depth | デッドレターキューの深度。 種類: int | (gauge) 単位: count |
ibm_mq_channel¶
| Tags & Fields | Description |
|---|---|
| channel ( tag) |
チャネル名。 |
| status ( tag) |
チャネルの状態。 |
| substate ( tag) |
チャネルの substate。 |
| running | チャネルが RUNNING かどうか。 種類: int | (gauge) |
| current_sharing_conversations | 現在の共有セッション数。 種類: int | (gauge) 単位: count |
| bytes_sent | 送信済みバイト数。 種類: int | (count) 単位: digital,B |
| bytes_received | 受信済みバイト数。 種類: int | (count) 単位: digital,B |
| messages | メッセージ数。 種類: int | (count) 単位: count |
ibm_mq_listener¶
| Tags & Fields | Description |
|---|---|
| listener ( tag) |
リスナー名。 |
| status ( tag) |
リスナーの状態。 |
| running | リスナーが RUNNING かどうか。 種類: int | (gauge) |
ibm_mq_cluster_qmgr¶
| Tags & Fields | Description |
|---|---|
| queue_manager ( tag) |
Queue Manager 名。 |
| cluster_qmgr ( tag) |
Cluster Queue Manager 名。 |
| status ( tag) |
Cluster Queue Manager の状態。 |
| channel ( tag) |
Cluster Queue Manager に関連付けられたチャネル。 |
| running | Cluster Queue Manager が RUNNING かどうか。 種類: int | (gauge) |
ibm_mq_topic¶
| Tags & Fields | Description |
|---|---|
| queue_manager ( tag) |
Queue Manager 名。 |
| topic ( tag) |
Topic 名。 |
| publishers | publisher 数。 種類: int | (gauge) 単位: count |
| subscribers | subscriber 数。 種類: int | (gauge) 単位: count |
ibm_mq_subscription_summary¶
| Tags & Fields | Description |
|---|---|
| queue_manager ( tag) |
Queue Manager 名。 |
| subscriptions | subscription 総数。 種類: int | (gauge) 単位: count |
| durable_subscriptions | durable subscription 数。 種類: int | (gauge) 単位: count |
| admin_subscriptions | admin subscription 数。 種類: int | (gauge) 単位: count |
カスタム指標¶
カスタム指標のフィールドは deep_metrics_command の出力によって決まります。表に列挙されたフィールドは tag として扱われます。その他の key=value のうち数値は float | (gauge) field として報告され、数値でないものは tag になります。数値 field がない場合は count=1 が補われ、単位は count になります。
| Measurement | Tags | Description |
|---|---|---|
ibm_mq_authority |
object, object_type, principal |
カスタム権限指標。 |
ibm_mq_event |
event_type, reason, object |
カスタムイベント指標。 |
ibm_mq_cluster |
cluster, status |
カスタムクラスタ指標。 |
ibm_mq_deep_metric |
metric, unit |
汎用 IBM MQ カスタム指標。 |