Add hsperfdata Input Plugin

README.md

@@ -157,6 +157,7 @@ configuration options.
 * [filestat](./plugins/inputs/filestat)
 * [haproxy](./plugins/inputs/haproxy)
 * [hddtemp](./plugins/inputs/hddtemp)
+* [hsperfdata](./plugins/inputs/hsperfdata) (Hostpot JVMs)
 * [http_response](./plugins/inputs/http_response)
 * [httpjson](./plugins/inputs/httpjson) (generic JSON-emitting http service plugin)
 * [internal](./plugins/inputs/internal)

plugins/inputs/all/all.go

@@ -23,6 +23,7 @@ import (
 	_ "github.com/influxdata/telegraf/plugins/inputs/graylog"
 	_ "github.com/influxdata/telegraf/plugins/inputs/haproxy"
 	_ "github.com/influxdata/telegraf/plugins/inputs/hddtemp"
+	_ "github.com/influxdata/telegraf/plugins/inputs/hsperfdata"
 	_ "github.com/influxdata/telegraf/plugins/inputs/http_listener"
 	_ "github.com/influxdata/telegraf/plugins/inputs/http_response"
 	_ "github.com/influxdata/telegraf/plugins/inputs/httpjson"

plugins/inputs/hsperfdata/README.md

@@ -0,0 +1,39 @@
+# hsperfdata Plugin
+
+The plugin gathers data from Hotspot JVMs via the hsperfdata files they expose. This plugin won't work if you've disabled their creation using `-XX:-UsePerfData` or `-XX:+PerfDisableSharedMem`!
+
+### Configuration:
+
+```toml
+[[inputs.hsperfdata]]
+  # Optional: gather data from processes belonging to a different user. By
+  # default, the username in the USER environment variable is used to generate
+  # the hsperfdata directory name (usually "/tmp/hsperfdata_username")
+  user: "root"
+
+  # use the named keys in the hsperfdata file as tags, not fields. By default,
+  # every key is exposed as a field. This example shows how to tag by JVM major
+  # version:
+  tags: ["java.property.java.vm.specification.version"]
+```
+
+### Measurements & Fields:
+
+All metrics are gathered as the "java" measurement.
+
+All keys in the hsperfdata file are exposed as fields; there's no comprehensive list as they vary by Hotspot version.
+
+### Tags:
+
+- All measurements have the following tags:
+    - pid (the process id of the monitored process)
+    - procname (the class name containing the `main` function being run)
+
+### Example Output:
+
+Most fields abbreviated; there's usually 200-300 of them:
+
+```
+$ ./telegraf -config telegraf.conf -input-filter example -test
+java,host=nwhite91-mac,pid=17427,procname=com.sun.javaws.Main java.ci.totalTime="49874911809",...,sun.zip.zipFiles="28" 1479466710000000000
+```