クライアントへの接続に使用するポート番号などの構成プロパティーを使用して、
Health Center エージェントの振る舞いを変更することができます。
プロパティーのフォーマットは、プロパティーの指定方法によって異なります。IBM® Bluemix™ を使用している場合、Bluemix ランタイム環境の一部として提供されるエージェントは構成できません。
一部のプロパティーには、Java™ アプリケーションのみ適用のマークが付いています。これらのプロパティーは、非 Java SDK に含まれるエージェント用のデフォルト・プロパティー・ファイルには存在しません。この状況で Java 固有のプロパティーを追加すると、そのプロパティーは無視されます。
Health Center には以下のような構成可能なプロパティーが含まれています。
クライアントとエージェントの間の通信に使用されるテクノロジーは、ユーザーが選択できます。適切なポート番号の設定も必要になる場合があります。
ポート番号をプロパティー・ファイルで指定した場合、ポートは永続的に変更されます。ポートを一時的に変更したい場合は、代わりにコマンド行でポートを指定してください。
クライアント/エージェント接続のセキュリティーのレベルを設定できます。
これらのプロパティーは、エージェントを開始する際の収集モードを定義します。例えば、エージェントがデータ収集を即時に開始するように設定したり、クライアントがエージェントに接続したときにのみ開始するように設定したりすることができます。
エージェントは直ちにデータの収集を開始し、そのデータをクライアントに送信するのではなく、ファイルに格納します。 アプリケーションが終了すると、エージェントは healthcenterpid.hcd という名前のファイルを作成します。pid はエージェントのプロセス ID です。このファイルを後日クライアントに読み込み、データを表示することができます。
ヘッドレス・モードは、クライアントをエージェントに接続できないシステムで役立ちます。例えば、ファイアウォールの制限により接続ができない場合がこれにあたります。
エージェントをヘッドレス・モードで実行する際の制限については、既知の制限を参照してください。
エージェントをプロセス内モードで実行する際の制限については、既知の制限を参照してください。
com.ibm.java.diagnostics.healthcenter.headless.output.directory=/tmp
[Tue 21 Oct 2014 14:24:30 BST] com.ibm.diagnostics.healthcenter.mqtt INFO: Connected to broker localhost:1883
[Tue 21 Oct 2014 14:24:45 BST] com.ibm.diagnostics.healthcenter.mqtt WARNING: Connection to broker localhost:1883 has been lost
[Tue 21 Oct 2014 14:25:12 BST] com.ibm.diagnostics.healthcenter.mqtt INFO: Connected to broker localhost:1883
ibm/healthcenter/agent_ID(host_name:process_ID)
MQTT ブローカーが共有されている場合 (例えば、複数のアプリケーションをモニターする 1 人以上のユーザーによって)、このデフォルト・ストリングは、それぞれのユーザーまたはアプリケーションに対応するエージェントを識別するために十分ではない可能性があります。この問題を回避するために、次のどちらかまたは両方のプロパティーを設定して、エージェントに対して生成されるストリングを変更できます。これにより、生成されるストリングは次のようになります。topic.namespace/ibm/healthcenter/agent_ID(application.id)
リストに多数のエージェントがある場合にも、これらのプロパティーを使用してリストを整理できます。例えば、ユーザーのマシン上で複数のエージェントが実行されていて、ユーザーが他のマシン上のユーザーと MQTT ブローカーを共有している場合は、エージェントごとの com.ibm.diagnostics.healthcenter.mqtt.topic.namespace プロパティーをユーザーのマシン名に設定できます。これにより、ユーザーのエージェントがリスト内で一緒にグループ化されて表示されます。プロパティー | プロパティーの説明 | 値 | Java または Node.js アプリケーションのみに固有か |
---|---|---|---|
com.ibm.diagnostics.healthcenter.data.profiling | メソッド・プロファイル・データを収集するかどうかを指定します。 | off または on。デフォルト値は off です。 | Node.js アプリケーションのみ |
com.ibm.diagnostics.healthcenter.headless | エージェントが、データをクライアントに送信する代わりにファイルに保管できるようにします。 | off または on。デフォルト値は off です。 | Java アプリケーションのみ |
com.ibm.diagnostics.healthcenter.jmx | エージェントが JMX 接続を使用してクライアントと通信できるようにします。 | off または on。デフォルト値は on です。 | Java アプリケーションのみ |
com.ibm.diagnostics.healthcenter.logging.level | エージェントから出力されるメッセージのレベルを変更します。 | none、warning、info、fine、finest、または debug。デフォルトは info です。 | 固有ではない |
com.ibm.diagnostics.healthcenter.mqtt | エージェントが MQTT ブローカーを使用してクライアントと通信できるようにします。 | off または on。デフォルト値は、IBM SDK, Java Technology Edition のエージェントの場合は off、IBM SDK for Node.js のエージェントの場合は on です。 | 固有ではない |
com.ibm.diagnostics.healthcenter.mqtt.application.id | エージェント ID ストリングに表示するアプリケーション ID | ストリング | 固有ではない |
procom.ibm.diagnostics.healthcenter.mqtt.broker.host=value | MQTT ブローカーのホスト名 | MQTT ブローカーが実行されているマシンのホスト名。デフォルトは localhost です。 | 固有ではない |
com.ibm.diagnostics.healthcenter.mqtt.broker.pass | MQTT ユーザー・パスワード | MQTT ブローカーの構成に指定されているユーザー・パスワード。このプロパティーは、デフォルトでは設定されません。 | 固有ではない |
com.ibm.diagnostics.healthcenter.mqtt.broker.port=value | MQTT ブローカーのポート | MQTT ブローカーが使用するように設定されているポート番号。デフォルトは 1883 です。 | 固有ではない |
com.ibm.diagnostics.healthcenter.mqtt.broker.user | MQTT ユーザー名 | MQTT ブローカーの構成に指定されているユーザー名。このプロパティーは、デフォルトでは設定されません。 | 固有ではない |
com.ibm.diagnostics.healthcenter.mqtt.topic.namespace | エージェント ID ストリングに表示する MQTT トピックの名前空間 | ストリング | 固有ではない |
com.ibm.diagnostics.healthcenter.readonly | エージェントが、モニター対象アプリケーションを混乱させる可能性があるクライアントからの要求を無視するかどうか。 | 要求を無視する場合は on に設定します。デフォルト値は off です。 | 固有ではない |
com.ibm.java.diagnostics.healthcenter.agent.authentication.file=value | MBean 認証ファイルの場所 | ファイルの絶対パスまたは相対パス。例: ./authentication.txt | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.agent.authorization.file=value | MBean 許可ファイルの場所 | ファイルの絶対パスまたは相対パス。例: ./authorization.txt | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.agent.iiop.port=value | IIOP ポート番号 | 有効なポート番号。デフォルト値はありません。 | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.agent.port=value (また、-Xhealthcenter と一緒に使用される場合は port=value) |
ポート番号 | 有効なポート番号。デフォルトは 1972 です。 | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.agent.ssl.keyStore=value | SSL 鍵ストアの場所 | 鍵ストア・ファイルの絶対パスまたは相対パス。例: ./HCAgentKeystore | 固有ではない |
com.ibm.java.diagnostics.healthcenter.agent.ssl.keyStoreCertificatePassword=value | SSL 鍵ストア証明書のパスワード | 文字または数のみを含むテキスト・ストリング。 例: password123 | 固有ではない |
com.ibm.java.diagnostics.healthcenter.agent.ssl.keyStorePassword=value | SSL 鍵ストアのパスワード | 文字または数のみを含むテキスト・ストリング。 例: password123 | 固有ではない |
com.ibm.java.diagnostics.healthcenter.agent.transport=value (また、-Xhealthcenter と一緒に使用される場合は transport=value) |
トランスポート・プロトコル | iiop または jrmp。 デフォルトは iiop です。 | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.data.collection.level=value (また、-Xhealthcenter と一緒に使用される場合は level=value) |
収集レベル | full、off、headless、inprocess、または none。デフォルトは full です。 | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.headless.delay.start=value | 遅延開始時間 | 分単位の時間。デフォルト値は 0 です。 | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.headless.files.max.size=value | 出力ファイルの最大サイズ | 5000000 (5 MB) から 2000000000 (2 GB) の範囲内のサイズ (バイト)。デフォルトでは、このプロパティーは設定されず、この場合は最大サイズの 2 GB が指定されます。5 MB より小さい値は 5MB に変更されます。2 GB を超える値は無視されます。 | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.headless.files.to.keep=value | 保持する出力ファイルの数 | 整数。デフォルトは 10 です。すべてのファイルを保持する場合は 0 を使用します。 | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.headless.output.directory=value | 出力ファイルの場所 | ディレクトリーの絶対パスまたは相対パス。デフォルト値は、アプリケーションの作業ディレクトリー、または Health Center がそのディレクトリーに書き込みできない場合、オペレーティング・システムのデフォルト一時ディレクトリーです。 | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.headless.run.duration=value | 実行時間 | 分単位の時間。デフォルト値は 0 です。 | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.headless.run.number.of.runs=value | 実行数 | 整数。デフォルト値は 0 です。 | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.headless.run.pause.duration=value | 休止時間 | 分単位の時間。デフォルト値は 0 です。 | Java アプリケーションのみ |
com.ibm.java.diagnostics.healthcenter.output.folder property=value | ガーベッジ・コレクション・ファイルの場所 | ディレクトリーの絶対パスまたは相対パス。デフォルト値はありません。 | 固有ではない |
![]() ![]() |
![]() ![]() |
![]() ![]() |
![]() ![]() |
com.ibm.java.diagnostics.healthcenter.thread.stack.depth=value | スレッド・スタックの深さ | 整数、または Integer.MAX_VALUE (デフォルト)。 スレッド呼び出しスタックの収集をオフにするには、0 を使用します。 | Java アプリケーションのみ |