Add events metricset for kubernetes metricbeat module (#4315)

* Adding events metricset for kubernetes metricbeat module

* Moving k8s client to top level vendor

* Incorporating review comments

CHANGELOG.asciidoc

@@ -66,6 +66,7 @@ https://github.com/elastic/beats/compare/v6.0.0-alpha1...master[Check the HEAD d
 - Add process_summary metricset that records high level metrics about processes. {pull}4231[4231]
 - Add `kube-state-metrics` based metrics to `kubernetes` module {pull}4253[4253]
 - Add debug logging to Jolokia JMX metricset. {pull}4341[4341]
+- Add events metricset for kubernetes metricbeat module {pull}4315[4315]
 
 *Packetbeat*
 

NOTICE

@@ -252,6 +252,12 @@ Copyright 2014-2015 The Prometheus Authors
 This product includes software developed at
 SoundCloud Ltd. (http://soundcloud.com/).
 
+--------------------------------------------------------------------
+github.com/ericchiang/k8s
+--------------------------------------------------------------------
+Apache License
+
+
 --------------------------------------------------------------------
 github.com/garyburd/redigo
 --------------------------------------------------------------------
@@ -1175,12 +1181,6 @@ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
---------------------------------------------------------------------
-github.com/ericchiang/k8s
---------------------------------------------------------------------
-Apache License
-
-
 --------------------------------------------------------------------
 github.com/golang/protobuf
 --------------------------------------------------------------------

metricbeat/docs/fields.asciidoc

@@ -6057,6 +6057,156 @@ type: long
 Used inodes
 
 
+[float]
+== event Fields
+
+The Kubernetes events metricset collects events that are generated by objects running inside of Kubernetes
+
+
+
+[float]
+=== kubernetes.event.count
+
+type: long
+
+Count field records the number of times the particular event has occured
+
+
+[float]
+=== kubernetes.event.message
+
+type: keyword
+
+Message recorded for the given event
+
+
+[float]
+=== kubernetes.event.reason
+
+type: keyword
+
+Reason recorded for the given event
+
+
+[float]
+=== kubernetes.event.type
+
+type: keyword
+
+Type of the given event
+
+
+[float]
+== metadata Fields
+
+Metadata associated with the given event
+
+
+
+
+[float]
+=== kubernetes.event.metadata.timestamp.created
+
+type: date
+
+Timestamp of creation of the given event
+
+
+[float]
+=== kubernetes.event.metadata.timestamp.deleted
+
+type: date
+
+Timestamp of deletion of the given event
+
+
+[float]
+=== kubernetes.event.metadata.name
+
+type: keyword
+
+Name of the event
+
+
+[float]
+=== kubernetes.event.metadata.namespace
+
+type: keyword
+
+Namespace in which event was generated
+
+
+[float]
+=== kubernetes.event.metadata.resource_version
+
+type: keyword
+
+Version of the event resource
+
+
+[float]
+=== kubernetes.event.metadata.uid
+
+type: keyword
+
+Unique identifier to the event object
+
+
+[float]
+=== kubernetes.event.metadata.self_link
+
+type: keyword
+
+URL representing the event
+
+
+[float]
+== involved_object Fields
+
+Metadata associated with the given involved object
+
+
+
+[float]
+=== kubernetes.event.involved_object.api_version
+
+type: keyword
+
+API version of the object
+
+
+[float]
+=== kubernetes.event.involved_object.kind
+
+type: keyword
+
+API kind of the object
+
+
+[float]
+=== kubernetes.event.involved_object.name
+
+type: keyword
+
+name of the object
+
+
+[float]
+=== kubernetes.event.involved_object.resource_version
+
+type: keyword
+
+resource version of the object
+
+
+[float]
+=== kubernetes.event.involved_object.uid
+
+type: keyword
+
+UUID version of the object
+
+
 [float]
 == node Fields