Merge pull request #1 from kelwang/jenkins-gollar-changes

Jenkins gollar changes

Gopkg.toml

@@ -108,6 +108,10 @@
   name = "github.com/kballard/go-shellquote"
   branch = "master"
 
+[[constraint]]
+  name = "github.com/kelwang/gojenkins"
+  version = "=v1.0.1"
+
 [[constraint]]
   name = "github.com/matttproud/golang_protobuf_extensions"
   version = "1.0.1"

plugins/inputs/all/all.go

@@ -42,6 +42,7 @@ import (
 	_ "github.com/influxdata/telegraf/plugins/inputs/ipmi_sensor"
 	_ "github.com/influxdata/telegraf/plugins/inputs/ipset"
 	_ "github.com/influxdata/telegraf/plugins/inputs/iptables"
+	_ "github.com/influxdata/telegraf/plugins/inputs/jenkins"
 	_ "github.com/influxdata/telegraf/plugins/inputs/jolokia"
 	_ "github.com/influxdata/telegraf/plugins/inputs/jolokia2"
 	_ "github.com/influxdata/telegraf/plugins/inputs/jti_openconfig_telemetry"

plugins/inputs/jenkins/README.md

@@ -0,0 +1,79 @@
+# Jenkins Plugin
+
+The jenkins plugin gathers information about the nodes and jobs running in a jenkins instance.
+
+This plugin does not require a plugin on jenkins and it makes use of Jenkins API to retrieve all the information needed.
+
+### Configuration:
+
+```toml
+url = "http://my-jenkins-instance:8080"
+#  username = "admin"
+#  password = "admin"
+## Set response_timeout
+response_timeout = "5s"
+
+## Optional SSL Config
+#  ssl_ca = /path/to/cafile
+#  ssl_cert = /path/to/certfile
+#  ssl_key = /path/to/keyfile
+## Use SSL but skip chain & host verification
+#  insecure_skip_verify = false
+
+## Job & build filter
+#  max_build_age = "1h"
+## jenkins can have unlimited layer of sub jobs
+## this config will limit the layers of pull, default value 0 means
+## unlimited pulling until no more sub jobs
+#  max_subjob_depth = 0
+## in workflow-multibranch-plugin, each branch will be created as a sub job
+## this config will limit to call only the lasted branches
+## sub jobs fetch in each layer
+#  empty will use default value 10
+#  max_subjob_per_layer = 10
+#  job_exclude = [ "job1", "job2/subjob1/subjob2", "job3/*"]
+
+## Node filter
+#  node_exclude = [ "node1", "node2" ]
+
+## Woker pool for jenkins plugin only
+#  empty this field will use default value 30
+#  max_connections = 30
+```
+
+### Measurements & Fields:
+
+- jenkins_node
+    - disk_available
+    - temp_available
+    - memory_available
+    - memory_total
+    - swap_available
+    - swap_total
+    - response_time
+
+- jenkins_job
+    - duration
+    - result_code (0 = SUCCESS, 1 = FAILURE, 2 = NOT_BUILD, 3 = UNSTABLE, 4 = ABORTED)
+
+### Tags:
+
+- jenkins_node
+    - arch
+    - disk_path
+    - temp_path
+    - node_name
+    - status ("online", "offline")
+
+- jenkins_job
+    - job_name
+    - result
+
+### Example Output:
+
+```
+$ ./telegraf --config telegraf.conf --input-filter jenkins --test
+jenkins_node,arch=Linux\ (amd64),disk_path=/var/jenkins_home,temp_path=/tmp,host=myhost,node_name=master swap_total=4294963200,memory_available=586711040,memory_total=6089498624,status=online,response_time=1000i,disk_available=152392036352,temp_available=152392036352,swap_available=3503263744 1516031535000000000
+jenkins_job,host=myhost,job_name=JOB1,result=SUCCESS duration=2831i,result_code=0i 1516026630000000000
+jenkins_job,host=myhost,job_name=JOB2,result=SUCCESS duration=2285i,result_code=0i 1516027230000000000
+```