Projects_Jmx - Hinemos Tools Wiki - Hinemos Tools

JMX情報取得ツール（JMX Tool）HinemosTools 1.1.0

Outline

• 概要
• 仕様
• インストール
• 使用方法
• 注意事項
• 備考

概要

JMX情報取得ツール（JMX Tool）は、HinemosToolsに統合されました。

JMX情報取得ツール（JMX Tool）は、HinemosマネージャのMBeanの属性値を、JMX経由で取得しCSVファイルに出力するツールです。
本ツールを使うことで、HinemosマネージャのMBeanの属性値の状態を把握することが可能となります。

• 対象Hinemosバージョン
  • 3.0.0
  • 3.0.1
  • 3.0.2
  • 3.0.3
  • 3.0.4
  • 3.0.5
  • 3.0.6
  • 3.1.0
  • 3.1.1
  • 3.1.2
  • 3.1.3
  • 3.1.4
  • 3.1.5
  • 3.2.0
  • 3.2.1
  • 3.2.2

JMX Tool(HinemosTools)は以下の企業の協力のもと作成しております。

• NTTデータ先端技術株式会社
  • Hinemos
• 株式会社コンバージョン

過去バージョンに関してはこちらをご覧ください。

• JMX情報取得ツール(Hinemos Tools 1.0.0)
• JMX情報取得ツール(1.0.0)

仕様

• HinemosマネージャのMBeanの属性値情報を定期的にCSVファイルに出力する。
  • Hinemosマネージャの以下のURLにて参照可能な情報をCSVに出力することが可能です。
    • http://***.***.***.***:8080/jmx_console/
• Hinemosマネージャに配置し使用する。
• 出力対象
  • デフォルト定義
    • MBean.Name：jboss.system:type=ServerInfo
    • MBean.Name：jboss.jca:name=HinemosDS,service=ManagedConnectionPool
    • MBean.Name：jboss.messaging.destination:name=clustercontrolNotifyControl,service=Queue
  • 出力対象の追加は、定義ファイルに追記することで可能。

インストール

1. HinemosToolsのインストールを参照ください。
2. 設定ファイルの変更(JMX Tool 個別)
   1. 「hinemos_tools/lib/config.properties」の以下の項目を環境に合わせて変更する。

      JMX.Dir=./csv/jmx/
      Interval=30000
      
      MBean.Name.1=jboss.system:type=ServerInfo
      MBean.FileName.1=ServerInfo
      MBean.Name.2=jboss.jca:name=HinemosDS,service=ManagedConnectionPool
      MBean.FileName.2=HinemosDS
      MBean.Name.3=jboss.messaging.destination:name=clustercontrolNotifyControl,service=Queue
      MBean.FileName.3=Queue_NotifyControl
      

      • Login.URL：HinemosマネージャのURLを指定。（Hinemosクライアントにて指定しているURLと同じ）
      • Login.USER：Hinemosの全機能の参照アカウントを付与されているアカウントを指定。
      • Login.URL：Login.USERに指定したHinemosアカウントのパスワードを指定。
      • Interval：MBeanの属性値情報の取得間隔を指定。
      • MBean.Name.*：出力対象MBean名を指定。
        • Hinemosマネージャの以下のURLにて参照可能なMBeanを追加定義することが可能。
          • http://***.***.***.***:8080/jmx_console/
      • MBean.FileName.*：出力CSVファイル名プレフィックスを指定。
        • 出力CSVファイル名は、出力CSVファイル名プレフィックスの後に「YYYYMMDD」が付与されたものとなる。

使用方法

• 実行方法
  • 起動
    • 「hinemos_tools」ディレクトリの直下の「jmx_tool_start.sh」を実行する。
    • MBeanの属性値情報が「hinemos_tools/jmx/」ディレクトリに、定期的にCSVファイルとして出力される。
  • 停止
    • 「hinemos_tools」ディレクトリの直下の「jmx_tool_stop.sh」を実行する。
• ログファイル
  • ログファイルは「hinemos_tools/log/」に出力される。

注意事項

• CSVファイルの区切り文字は「タブ」となる。
• CSVファイル定義

  日時,第1属性名,第1属性値,以降、属性名と属性値のセットを繰り返す
  

備考

• バグ報告
  • バグの報告は、 「メーリングリスト」または、「トラッキング情報-Bugs」までお願いいたします。