fluent-plugin-jvmwatcher 0.1.3 → 0.1.4

data/ChangeLog

@@ -0,0 +1,11 @@
+Release 0.1.4 - 2013/05/16
+
+* a bit edit source code.
+
+Release 0.1.3 - 2013/05/11
+
+* gem install bug fix.
+
+Release 0.1.2 - 2013/05/11
+
+* First release

data/README.md

@@ -1,8 +1,14 @@
 Java VM status input plugin for Fluent
 ====
 fluent-plugin-jvmwatcher is input plugin which collects the CPU usage rate and the memory usage of more than one JavaVM, information on GC to the constant period.
+The collection of the CPU usage rate and the memory usage, the information on GC goes in JVMWatcher from JavaVM.  
+fluent-plugin-jvmwatcher is collecting the condition of JavaVM in summoning JVMWatcher from inside.
 
-fluent-plugin-jvmwatcherは、複数のJavaVMの、CPU使用率やメモリ使用量、GCの情報を、一定周期に収集するinput pluginです。
+fluent-plugin-jvmwatcherは、複数のJavaVMの、CPU使用率やメモリ使用量、GCの情報を、一定周期に収集するinput pluginです。  
+JavaVMから、CPU使用率やメモリ使用量、GCの情報の収集は、JVMWatcherで行っています。  
+fluent-plugin-jvmwatcherは、内部からJVMWatcherを呼び出すことで、JavaVMの状態を収集しています。  
+
+JVMWatcher -> <https://github.com/MasayukiMiyake97/JVMWatcher>
 
 ## Installation
 
@@ -24,7 +30,18 @@ Then fluent automatically loads the plugin installed.
       tag jvmwatcher.log
     </source>
 
-## filtering Configuration
+ 1. log_interval <- It is the interval by which the condition is acquired from JavaVM(The millisecond unit).
+ 2. log_buff_num <- It is the collection number of times of the log which outputs log outside.
+ 3. jvm_refind_interval <- It is the interval which updates JavaVM of the collection object(The millisecond unit).This value doesn't set an extremely short value.Make 10000 ( msec ) a standard even if it is short.
+ 4. filter_config_path <- filtering Configuration file name.The definition with this item isn't indispensable.
+
+## filtering Configuration file
+When wanting to limit the Java process to measure only to the specific process, create the file which defined the process name to limit by the regular expression.
+Create this definition file in the file with the JSON format which is in the following example.
+
+もし、計測するJavaプロセスを、特定のプロセスだけに限定したい場合は、限定するプロセス名称を正規表現で定義したファイルを作成してください。この定義ファイルは、次の例にあるJSONフォーマットのファイルで作成してください。
+
+filter_config.json
 
     {"target" :
       [
@@ -33,6 +50,9 @@ Then fluent automatically loads the plugin installed.
       ]
     }
 
+ 1. shortname <- It sets the simple name of the process.
+ 2. pattern <- It sets the regular expression to limit a process.
+
 There is a sample of the command which outputs the list of the Java process under the directory of fluent-plugin-jvmwatcher which was installed in gem and the definition file of filtering.
 
 gemでインストールした、fluent-plugin-jvmwatcherのディレクトリの下に、Javaプロセスの一覧を出力するコマンドと、フィルタリングの定義ファイルのサンプルがあります。
@@ -52,11 +72,11 @@ gemでインストールした、fluent-plugin-jvmwatcherのディレクトリ
 
 
 ###Java process listup.
-Before creating the definition file of filtering, it executes JvmProcCheck.sh command and it makes output the list of the Java process which is working on the host.
-It finds the character string which suited the key word to use for the regular expression to set to "pattern" from the name of the Java process which is output by [ CommandLine ] of the list.
+Before creating the definition file of filtering, it executes JvmProcCheck.sh command and it makes output the list of the Java process which is working on the host.  
+It finds the character string which suited the key word to use for the regular expression to set to "pattern" from the name of the Java process which is output by [ CommandLine ] of the list.  
 
-フィルタリングの定義ファイルを作成する前に、JvmProcCheck.shコマンドを実行して、ホスト上で動作しているJavaプロセスの一覧を出力させます。
-一覧の[CommandLine]に出力されるJavaプロセスの名称から、"pattern"に設定する正規表現に使用するキーワードに適した文字列を、見つけ出します。
+フィルタリングの定義ファイルを作成する前に、JvmProcCheck.shコマンドを実行して、ホスト上で動作しているJavaプロセスの一覧を出力させます。  
+一覧の[CommandLine]に出力されるJavaプロセスの名称から、"pattern"に設定する正規表現に使用するキーワードに適した文字列を、見つけ出します。  
 
     cd lib/fluent/plugin/jvmwatcher/bin
     ./JvmProcCheck.sh
@@ -72,13 +92,13 @@ Output
     -- process list end   --
 
 ###Java process filtering check.
-Create the definition file of filtering from the found key word and preserve it under config.
-It executes JvmProcCheck.sh command and it confirms that only a Java process for the purpose is done by filtering by the definition file of created filtering.
-The way of confirming set the definition file of created filtering to the argument of the JvmProcCheck.sh command and execute it.
+Create the definition file of filtering from the found key word and preserve it under config.  
+It executes JvmProcCheck.sh command and it confirms that only a Java process for the purpose is done by filtering by the definition file of created filtering.  
+The way of confirming set the definition file of created filtering to the argument of the JvmProcCheck.sh command and execute it.  
 
-見つけ出したキーワードから、フィルタリングの定義ファイルを作成し、configの下に保存して下さい。
-作成したフィルタリングの定義ファイルによって、目的のJavaプロセスだけがフィルタリングされることは、JvmProcCheck.shコマンドを実行して確認します。
-確認方法は、作成したフィルタリングの定義ファイルを、JvmProcCheck.shコマンドの引数に設定して、実行してください。
+見つけ出したキーワードから、フィルタリングの定義ファイルを作成し、configの下に保存して下さい。  
+作成したフィルタリングの定義ファイルによって、目的のJavaプロセスだけがフィルタリングされることは、JvmProcCheck.shコマンドを実行して確認します。  
+確認方法は、作成したフィルタリングの定義ファイルを、JvmProcCheck.shコマンドの引数に設定して、実行してください。  
 
     ./JvmProcCheck.sh ../config/filter_config.json
 
@@ -92,16 +112,16 @@ Output
 
 
 ##JVM status log sample
-It is the sample of the log which was output from jvmwatcher.
-This sample is outputting only a necessary Java process using filter_config_path of the configuration.
-The name to set to "shortname" of the definition file of filtering is output by "name" of the output log.
-When not using filter_config_path of the configuration, the contents which are the same as "display_name" are output by "shortname".
-Also, the log of all Java processes of the node is output.
+It is the sample of the log which was output from jvmwatcher.  
+This sample is outputting only a necessary Java process using filter_config_path of the configuration.  
+The name to set to "shortname" of the definition file of filtering is output by "name" of the output log.  
+When not using filter_config_path of the configuration, the contents which are the same as "display_name" are output by "shortname".  
+Also, the log of all Java processes of the node is output.  
 
-jvmwatcherから出力されたログのサンプルです。
-このサンプルは、コンフィグレーションのfilter_config_pathを使用して、必要なJavaプロセスだけを出力しています。
-出力されているログの"name"には、フィルタリングの定義ファイルの"shortname"に設定している名称が出力されます。
-コンフィグレーションのfilter_config_pathを使用しない場合は、"shortname"に"display_name"と同じ内容が出力されます。また、ノードのすべてのJavaプロセスのログが出力されます。
+jvmwatcherから出力されたログのサンプルです。  
+このサンプルは、コンフィグレーションのfilter_config_pathを使用して、必要なJavaプロセスだけを出力しています。  
+出力されているログの"name"には、フィルタリングの定義ファイルの"shortname"に設定している名称が出力されます。  
+コンフィグレーションのfilter_config_pathを使用しない場合は、"shortname"に"display_name"と同じ内容が出力されます。また、ノードのすべてのJavaプロセスのログが出力されます。  
 
     2013-05-11T13:53:50+09:00       jvmwatcher.log  {"logtime":1368248030423,"host_name":"nanoha","proc_state":"START_PROCESS","pid":2677,"name":"Tomcat","display_name":"org.apache.catalina.startup.Bootstrap start","start_time":1368235715885,"up_time":12314590,"cpu_usage":0.13756041,"compile_time":2280,"c_load_cnt":2110,"c_unload_cnt":0,"c_total_load_cnt":2111,"th_cnt":15,"daemon_th_cnt":14,"peak_th_cnt":15,"heap_init":62766272,"heap_used":14218752,"heap_commit":60227584,"heap_max":892928000,"notheap_init":24313856,"notheap_used":18505232,"notheap_commit":31784960,"notheap_max":224395264,"pending_fin_cnt":0,"total_phy_mem_size":4017041408,"total_swap_mem_size":4160741376,"free_phy_mem_size":1830621184,"free_swap_mem_size":4160741376,"commit_vmem_size":2432827392,"gc_collect":[{"gc_mgr_name":"PS MarkSweep","gc_coll_cnt":4,"gc_coll_time":159},{"gc_mgr_name":"PS Scavenge","gc_coll_cnt":7,"gc_coll_time":44}]}
     2013-05-11T13:53:51+09:00       jvmwatcher.log  {"logtime":1368248031423,"host_name":"nanoha","proc_state":"LIVE_PROCESS","pid":2677,"name":"Tomcat","display_name":"org.apache.catalina.startup.Bootstrap start","start_time":1368235715885,"up_time":12315551,"cpu_usage":4.162331,"compile_time":2334,"c_load_cnt":2153,"c_unload_cnt":0,"c_total_load_cnt":2153,"th_cnt":15,"daemon_th_cnt":14,"peak_th_cnt":15,"heap_init":62766272,"heap_used":15915928,"heap_commit":60227584,"heap_max":892928000,"notheap_init":24313856,"notheap_used":18749552,"notheap_commit":31784960,"notheap_max":224395264,"pending_fin_cnt":0,"total_phy_mem_size":4017041408,"total_swap_mem_size":4160741376,"free_phy_mem_size":1805737984,"free_swap_mem_size":4160741376,"commit_vmem_size":2432827392,"gc_collect":[{"gc_mgr_name":"PS MarkSweep","gc_coll_cnt":4,"gc_coll_time":159},{"gc_mgr_name":"PS Scavenge","gc_coll_cnt":7,"gc_coll_time":44}]}
@@ -113,3 +133,17 @@ jvmwatcherから出力されたログのサンプルです。
 In the date and time which is output at the head of the log, it is generating from "logtime" which is the time by which the information was acquired actually from JavaVM.
 
 ログの先頭に出力されている日時は、実際にJavaVMから情報を取得した時間である"logtime"から生成しています。
+
+log output format <https://github.com/MasayukiMiyake97/fluent-plugin-jvmwatcher/wiki/Log-outout-format>
+
+##Requirements
+  JDK >= 1.6
+  
+  * On the Linux ( CentOS ), it is OpenJDK In 1.6 pieces of environment, it is doing an operations check.The operations check doesn't go but probably, it works on Ubuntu.
+  * fluent-plugin-jvmwatcher is using tools.jar which JDK is providing.Therefore, in the JRE environment which tools.jar isn't contained in, it doesn't work.Certainly, use in the environment which JDK is installed in.
+
+##Copyright
+Copyright (c) 2013 MasayukiMiyake
+
+##License
+Apache License, Version 2.0

data/VERSION

@@ -0,0 +1 @@
+v0.1.4

data/fluent-plugin-jvmwatcher.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-lib = File.expand_path('../lib', __FILE__)
+$:.push File.expand_path('../lib', __FILE__)
 
 Gem::Specification.new do |gem|
   gem.name          = "fluent-plugin-jvmwatcher"
-  gem.version       = "0.1.3"
+  gem.version       = "0.1.4"
   gem.authors       = ["MasayukiMiyake"]
   gem.email         = ["masayukimiyake97@gmail.com"]
   gem.description   = %q{It is the input plugin of fluentd which collects the condition of Java VM.}

data/lib/fluent/plugin/jvmwatcher_util.rb

@@ -15,28 +15,26 @@ module JvmwatcherUtil
 
     java_path = nil
 
+    # find java command path
     $LOAD_PATH.map do |load_path|
       path = File.join(load_path, "fluent/plugin")  # make fluentd plugin path
       if File.directory?(path)
 
-        # find target directory
-        Dir.glob("#{path}/jvmwatcher/#{dir_name}").each do |path_name|
-
-          next unless File.directory?(path_name)  # chech directory
-
-          if file_name
-            # check file
-            java_path = File.join(path_name, file_name)
-            java_path = nil unless File.file?(java_path)
-          else
-            java_path = path_name
-          end
-
-          break if java_path
+        # find target java directory
+        path_name = "#{path}/jvmwatcher/#{dir_name}"
+        
+        next unless File.directory?(path_name)  # chech directory
+
+        if file_name
+          # check file
+          java_path = File.join(path_name, file_name)
+          java_path = nil unless File.file?(java_path)
+        else
+          java_path = path_name
         end
-      end
 
-      break if java_path
+        break if java_path
+      end
     end
 
     return java_path

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fluent-plugin-jvmwatcher
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-11 00:00:00.000000000 Z
+date: 2013-05-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -52,10 +52,12 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- ChangeLog
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
+- VERSION
 - fluent-plugin-jvmwatcher.gemspec
 - lib/fluent/plugin/in_jvmwatcher.rb
 - lib/fluent/plugin/jvmwatcher/bin/JvmProcCheck.sh
@@ -88,7 +90,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -1985848097825128302
+      hash: -1794146933402571690
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -97,7 +99,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -1985848097825128302
+      hash: -1794146933402571690
 requirements: []
 rubyforge_project: fluent-plugin-jvmwatcher
 rubygems_version: 1.8.25