MQMonitor.properties ファイル
内容
apmdevops104jp
内容
Specific MQ Data セクション
このセクションを使って、WebSphere MQ 設定インスタンスをリスト表示して、WebSphere MQ キュー マネージャを監視します。
重要:
1 つのキュー マネージャ インスタンスは、1 つの MQMonitor エージェントによってのみ監視する必要があります。DNS 名にアンダースコアは使用できません。
mq.monitor.list
監視されるすべての WebSphere MQ キュー マネージャ インスタンスのカンマ区切りリストを指定します。
注:
mq.monitor.list プロパティに「:」または「=」が含まれないことを確認します。デフォルト:
なし例:
キュー マネージャ インスタンスが QM1 である場合は、以下のようにプロパティを設定します。mq.monitor.list=QM1@<hostname>, QM1@<hostname>
<キュー マネージャ> <ホスト>.host
mq.monitor.list にリストされたキュー マネージャの IP アドレスまたは DNS 名(ホスト名)を指定します。
デフォルト:
なし例:
キュー マネージャ インスタンスが QM1 である場合は、以下のようにプロパティを設定します。QM1@<hostname>.host=localhost
<キュー マネージャ> <ホスト>.port
mq.monitor.list にリストされたキュー マネージャ インスタンスのポート番号を指定します。
デフォルト:
1414例:
QM1@<ホスト名>.port=5001
<キュー マネージャ> <ホスト>.channelname
監視対象のキュー マネージャ インスタンスへの接続に使用されるサーバ接続チャネルを指定します。
デフォルト: <パスワード>
- SYSTEM.AUTO.SVRCONN
- SYSTEM.DEF.SVRCONN (デフォルト チャネルが失敗する場合に使用)
例:
QM1@<ホスト名>
.channelname=SYSTEM.AUTO.SVRCONN<キュー マネージャ> <ホスト>.character.set
キュー マネージャが使用する文字セット ID を指定します。
デフォルト:
819例:
QM1@<ホスト名>
.character.set=819<キュー マネージャ>@<ホスト>.modelqueue
このプロパティは、キュー マネージャの監視に使用されるデフォルトのシステム モデル キューではなく、カスタム モデル キューを指定します。カスタム モデル キュー名が失敗する場合、MQ Monitor はデフォルト モデル キュー名を使用します。
デフォルト:
SYSTEM.DEFAULT.MODEL.QUEUE例:
QM1@<ホスト名
>.modelqueue=SYSTEM.DEFAULT.MODEL.QUEUE<キュー マネージャ> <ホスト>.delaytime
WebSphere MQ データの各クエリ間の遅延時間(秒単位)を指定します。
デフォルト:
600 秒例:
QM1@<ホスト名>
.delaytime=60<キュー マネージャ> <ホスト>.report.static.freq
静的メトリックに関するメトリック収集の頻度を指定します。この値は、分数(1/
n
)の分母として使用されます。n
はプロパティに設定されている数です。デフォルト:
20例:
QM1@<ホスト名>
.report.static.freq=20 の場合、MQMonitor エージェントは、20 クエリごとに 1 つの結果のみをレポートします。<キュー マネージャ> <ホスト>.ssl
キュー マネージャ インスタンスと通信するために SSL が有効か無効かを指定します。
デフォルト:
無効例:
キュー マネージャ インスタンス QM1 と通信するために SSL を有効にするには、以下を設定します。QM1@<hostname>.ssl=enable
<キュー マネージャ> <ホスト>.channel.ssl.cipherspec
SSL 経由で特定のキュー マネージャ インスタンスと通信するために使用される CipherSpec を指定します。SSL プロパティが有効なときに限り、MQMonitor エージェントはこのプロパティ値を使用します。
デフォルト:
なし例:
QM1@<ホスト名>
.channel.ssl.cipherspec=NULL_MD5truststore.path
WebSphere MQ キュー マネージャ(WebSphere MQ サーバ)の認証用の証明書が含まれるトラストストアの場所を指定します。絶対パスまたは MQMonitor エージェントの properties ディレクトリを基準にした相対パスのいずれかを指定します。Windows では、円記号をエスケープします。
デフォルト:
<パス名>例:
truststore.path=C:\\MQMonitor\\key\\truststore.jkskeystore.path
MQMonitor エージェントの認証用の証明書が含まれるキーストアの場所を指定します。クライアント認証を必要とする場合は、このプロパティを設定します。
デフォルト:
<パス名>例:
keystore.path=C:\\MQMonitor\\key\\keyststore.jks.keystore.password
キーストアのパスワードを指定します。
デフォルト:
<パスワード
>例:
keystore.password=<パスワード
>MQ Events セクション
WebSphere MQ イベント メッセージを受信するように MQMonitor エージェントを設定するには、このセクションを使用します。WebSphere MQ キュー マネージャ上の MQ イベント メッセージを受信するキュー名を指定します。
MQ イベントには以下のタイプがあります。
- キュー マネージャ イベント
- 権限
- 禁止
- ローカル
- リモート
- 開始
- 停止
- チャネル イベントとブリッジ イベント
- チャネル
- SSL
- チャネル自動定義
- パフォーマンス イベント
- キュー深度
- キュー サービス間隔
注:MQMonitor エージェントは、設定イベントまたはコマンド イベントである z/OS 専用 WebSphere MQ イベントをサポートしません。
<キュー マネージャ> <ホスト>.qmgr.event.queue
指定されたキュー マネージャのキュー マネージャ イベント キューのキュー名を指定します。
デフォルト:
SYSTEM.ADMIN.QMGR.EVENT<キュー マネージャ> <ホスト>.event.destructive.get
MQMonitor エージェントが読み取った後、イベント メッセージをイベント キューから削除するかどうかを指定します。
値:
true または falseデフォルト:
false例:
イベント キューからイベント メッセージを削除するには、以下のようにプロパティを設定します。<Queue Manager>@<hostname>.event.destructive.get=true
<キュー マネージャ> <ホスト>.performance.event.queue
指定されたキュー マネージャのパフォーマンス イベント キューのキュー名を指定します。
デフォルト:
SYSTEM.ADMIN.PERFM.EVENT<キュー マネージャ> <ホスト>.channel.event.queue
指定されたキュー マネージャのチャネル イベント キューのキュー名を指定します。
デフォルト:
SYSTEM.ADMIN.CHANNEL.EVENTSpecial Settings セクション
Investigator ツリーに表示されるメトリックの数に制限を設定するには、このセクションを使用します。
以下のプロパティを使用して、WebSphere MQ コンポーネントの表示レベルを指定できます。
- キュー マネージャプロパティは<キュー マネージャ> @<Host>.monitor.manager
- キュープロパティは<キュー マネージャ>@<Host>.monitor.queue
- Channelsプロパティは<Queue Manager>@<Host>.monitor.channel
- チャネル イニシエータ(z/OS のみ)プロパティは<Queue Manager>@<Host>.monitor.channelinitiator
- ページ セット(z/OS のみ)プロパティは<Queue Manager>@<Host>.monitor.pagesets
- ログ(z/OS のみ)プロパティは<Queue Manager>@<Host>.monitor.log
コンポーネントの表示レベルを設定するには、名前とホスト名を使用してコンポーネントを参照し、表示レベルを指定します。
たとえば、キュー マネージャ QM1 に属するキューの表示レベルを full に設定するには、以下のプロパティを設定します。
QM1@<hostname>.monitor.queue=full
各コンポーネントには以下の値を指定できます。
- Neverクエリされなかった、または Investigator ツリーに表示されなかったコンポーネントのメトリックを表示します。
- 最小メトリックの限定されたセットを表示します。
- Recommendedメトリックのより大きなセットを表示します。
- Fullこのコンポーネントのメトリックをすべて表示します。
各値セットに属するメトリックを確認するには、「キュー マネージャ メトリック」を参照してください。
Advanced Settings セクション
Recommended メトリック セットを再定義するには、このセクションを使用します。Recommended セットを再定義することによって、Minimum セット、および Recommended セットに含まれているメトリックの両方を取得します。
MQMonitor エージェント メトリックの表示設定は、「キュー マネージャ メトリック」に記載されています。
次のプロパティを使用して、Recommended メトリック セットを再定義できます。
- キュー マネージャプロパティはrecommended.metrics.managerです
- キュープロパティはrecommended.metrics.queueです
- Channelsプロパティはrecommended.metrics.channelです
- チャネル イニシエータ(z/OS のみ)プロパティはrecommended.metrics.channelinitiatorです
- ページ セット(z/OS のみ)プロパティはrecommended.metrics.pagesetsです
- ログ(z/OS のみ)プロパティはrecommended.metrics.logです
Recommended メトリック セットを再定義するために、コンポーネント名およびメトリック名を使用してメトリックをリストします。個々のメトリックをカンマで区切ります。
たとえば、以下の通りです。
recommended.metrics.queue: Queue Name, Queue Type, Cluster Queue Type
この例では、Recommended リストは 3 つのメンバのみで再定義されます。ただし、Minimum セットのメトリックおよび Recommended リストで定義された 3 つのメトリックの両方を取得します。
MQ Trace Related Properties セクション
プロセスにまたがるトランザクション追跡には、このセクションを使用します。
trace.dlq.activity.enabled
MQMonitor エージェントの、デッド レター キューからの追跡データの読み取りを、可能にするか無効にするかを指定します。
値:
true または falseデフォルト:
true例:
MQMonitor エージェントがデッド レター キューを読み取れるようにするには、以下を設定します。trace.dlq.activity.enabled=true
trace.polling.enabled
メッセージが処理されるかどうかを確認するために、MQMonitor エージェントが最終の送信先キューを検索するかどうかを指定します。
値:
true または falseデフォルト:
truetrace.polling.interval
メッセージが処理されるかどうかを確認するために MQMonitor エージェントが最終の宛先キューを確認する期間を指定します。
オプション:
- 最小:10 ミリ秒
- 最大:600000 ミリ秒
デフォルト:
1000 ミリ秒trace.polling.retry.count
MQMonitor エージェントが特定のメッセージの最終の宛先キューを確認する回数を指定します。
オプション:
- 最小:1
- 最大:100
デフォルト:
3例:
trace.polling.retry.count=3trace.dlq.flag.time
メッセージがデッド レター キューに到着したときに、MQ 追跡に追加される静的な時間を指定します。
オプション:
- 最小:1 秒
- 最大:1800 秒
デフォルト:
30 秒例:
trace.dlq.flag.time=30handshake.mqagent.id
エージェントの一意の ID を指定します。このプロパティは必須です。
範囲:
1 ~ 999999999デフォルト:
なし例:
handshake.mqagent.id=1handshake.qm.host
共通のキュー マネージャの IP アドレスまたは DNS 名を指定します。
デフォルト:
localhost例:
handshake.qm.host=localhosthandshake.qm.port
共通のキュー マネージャのポートを指定します。
デフォルト:
1414例:
handshake.qm.port=123handshake.qm.channelname
接続に使用される共通のキュー マネージャのチャネル名を指定します。
デフォルト: <パスワード>
- SYSTEM.AUTO.SVRCONN
- SYSTEM.DEF.SVRCONN (デフォルト チャネルが失敗する場合に使用)
例:
handshake.qm.channelname=SYSTEM.AUTO.SVRCONNhandshake.qm.character.set
ハンドシェイクに使用される共通のキュー マネージャの CCSID 文字セットを指定します。
デフォルト:
819例
: handshake.qm.character.set=819handshake.qm.ssl
ハンドシェイクに使用される共通のキュー マネージャが SSL 対応の場合、SSL プロパティを有効にするか無効にするか指定します。
値:
有効、無効デフォルト:
無効例:
キュー マネージャの SSL プロパティをオフにするには、以下を設定します。handshake.qm.ssl=disable
handshake.qm.channel.ssl.cipherspec
ハンドシェイクに使用される共通のキュー マネージャの SSL CipherSpec を指定します。
デフォルト:
なし例:
handshake.qm.channel.ssl.cipherspec=NULL_MD5handshake.queue
すべての WebSphere MQ エージェント間のハンドシェイクで使用されるキューを指定します。
デフォルト:
CA_WILY_HANDSHAKEtrace.hold.maxduration
メッセージ フローで受信されるすべての追跡を保持し、待機する時間を指定します。この値は追跡を保持する最大時間です。CA APM for IBM WebSphere MQ は、すべての追跡がその間隔内に受信されない場合でも、指定された時間に収集される追跡を送信します。
注:
このプロパティを 0 に設定すると、MQ 追跡は保持されず、統合された追跡が MQ 追跡セグメントに表示されません。このシナリオでは、MQ 追跡の順序はありません。オプション:
- 最小:0 秒
- 最大:3600 秒
デフォルト:
30 秒例:
trace.hold.maxduration=
60MQ Auto Discovery Related Properties セクション
mq.monitor.agent.id
MQMonitor エージェントの識別番号を指定します。
デフォルト:
101例:
mq.monitor.agent.id=101mq.autodiscovery.enabled
キュー マネージャの自動検出を有効にするかどうか指定します。このプロパティの変更を有効にするには、アプリケーション再起動を再起動します。
値:
true または falseデフォルト:
true例:
mq.autodiscovery.enabled=truemq.autodiscovery.queue
自動検出のために MQMonitor エージェントが使用するキューを指定します。このキューは、MQ Java エージェントの MQAgent.properties ファイルで指定されているのと同じキューです。
例:
mq.autodiscovery.queue=CA_WILY_AUTODISCOVERYmq.autodiscovery.properties.update
MQMonitor.properties を自動検出されたキュー マネージャで自動更新する必要があるかどうかを指定します。
値:
true または falseデフォルト
: false例:
mq.autodiscovery.properties.update=falseFilters セクション
さらなるメトリック フィルタリングに、このセクションを使用します。たとえば、ユーザ定義のキュー メトリックを優先するためにシステム キュー メトリックをすべて除外できます。
<キュー マネージャ> <ホスト>.filter.exclude.static
指定されたキュー マネージャを監視するときに、静的なメトリックを含むまたは除外する必要があるかどうかを指定します。静的メトリックを除外し、Investigator ツリーの動的メトリックのみをレポートするには、値を true に設定します。
値:
true または falseデフォルト:
false例:
キュー マネージャ QM1 の静的メトリックおよび動的メトリックをレポートするには、以下のプロパティを設定します。QM1@<hostname>.filter.exclude.static=false
<キュー マネージャ> <ホスト>.queue.filter.exclude.system
指定されたキュー マネージャのキューを監視するときに、動的なメトリックを含む必要があるかどうかを指定します。Investigator ツリーのシステム キューを除外するには、この値を true に設定します。デッド レター キューはフィルタしません。
値:
true または falseデフォルト:
true例:
QM1@<ホスト名>
.queue.filter.exclude.system=true<キュー マネージャ> <ホスト>.queue.filter.exclude.dynamic
指定されたキュー マネージャのキューを監視するときに、動的なメトリックを含むまたは除外する必要があるかどうかを指定します。Investigator ツリーの動的キューを除外するには、この値を true に設定します。
値:
true または falseデフォルト:
true例:
QM1@<ホスト名>
.queue.filter.exclude.dynamic=true<キュー マネージャ> <ホスト>.queue.filter.includeonly.regex
キューをフィルタするためにキュー マネージャが使用する正規表現を指定します。
デフォルト:
* (フィルタなし)例:
QM1@<ホスト名>
.queue.filter.includeonly.regex=.*<キュー マネージャ> <ホスト>.channel.filter.includeonly.regex
チャネルをフィルタするためにキュー マネージャが使用する正規表現を指定します。
デフォルト:
* (フィルタなし)例:
test
で始まるチャネルのみを表示する方法QM1@<hostname>.channel.filter.includeonly.regex=test.*
<キュー マネージャ> <ホスト>.pagesets.filter.includeonly.regex
キュー マネージャが、z/OS 内のページ セット ID によってページ セットをフィルタするために使用し、以下のように表示する正規表現を指定します。
Usage|Page Sets|PageSet<PageSet_ID>
デフォルト:
* (フィルタなし)例:
ページ セットをフィルタするには、正規表現でページ セット ID を指定します。QM1@<hostname>.pagesets.filter.includeonly.regex=.*<PageSet_ID>
<キュー マネージャ> <ホスト>.log.filter.includeonly.regex
キュー マネージャが、z/OS 内のログをフィルタするために使用し、以下のように表示する正規表現を指定します。
Logs|Log Copy Records|Log<Log Copy Record No>
デフォルト:
* (フィルタなし)例:
ログをフィルタするには、正規表現でログ コピー レコード番号を指定します。QM1@<hostname>.log.filter.includeonly.regex=*<Log Copy Record No>