Cherry-pick #15059 to 7.x: Add metricbeat iis module

metricbeat/docs/fields.asciidoc

@@ -42,6 +42,7 @@ grouped in the following categories:
 * <<exported-fields-host-processor>>
 * <<exported-fields-http>>
 * <<exported-fields-ibmmq>>
+* <<exported-fields-iis>>
 * <<exported-fields-istio>>
 * <<exported-fields-jolokia>>
 * <<exported-fields-jolokia-autodiscover>>
@@ -16950,6 +16951,63 @@ IBM MQ module
 
 
 
+[[exported-fields-iis]]
+== iis fields
+
+iis module
+
+
+
+[float]
+=== iis
+
+
+
+
+[float]
+=== application_pool
+
+application_pool
+
+
+
+*`iis.application_pool.name`*::
++
+--
+application pool name
+
+
+type: keyword
+
+--
+
+*`iis.webserver.*.*`*::
++
+--
+webserver
+
+
+type: object
+
+--
+
+[float]
+=== website
+
+website
+
+
+
+*`iis.website.name`*::
++
+--
+website name
+
+
+type: keyword
+
+--
+
 [[exported-fields-istio]]
 == istio fields
 

metricbeat/docs/modules/iis.asciidoc

@@ -0,0 +1,99 @@
+////
+This file is generated! See scripts/mage/docs_collector.go
+////
+
+[[metricbeat-module-iis]]
+== iis module
+
+beta[]
+
+This is the iis module.
+
+IIS (Internet Information Services) is a secure, reliable, and scalable Web server that provides an easy to manage platform for developing and hosting Web applications and services.
+
+The `iis` module will periodically retrieve IIS related metrics using performance counters such as:
+
+ - System/Process counters like the the overall server and CPU usage for the IIS Worker Process and memory (currently used and available memory for the IIS Worker Process).
+ - IIS performance counters like Web Service: Bytes Received/Sec, Web Service: Bytes Sent/Sec, etc, which are helpful to track to identify potential spikes in traffic.
+ - Web Service Cache counters in order to monitor user mode cache and output cache.
+
+
+The `iis` module mericsets are `webserver`, `website` and `application_pool`.
+
+[source,yaml]
+----
+- module: iis
+  metricsets:
+    - webserver
+    - website
+    - application_pool
+  enabled: true
+  period: 10s
+
+ # filter on application pool names
+ # application_pool.name: []
+----
+
+[float]
+== Metricsets
+
+[float]
+=== `webserver`
+A light metricset using the windows perfmon metricset as the base metricset.
+This metricset allows users to retrieve aggregated metrics for the entire webserver,
+
+[float]
+=== `website`
+A light metricset using the windows perfmon metricset as the base metricset.
+This metricset will collect metrics of specific sites, users can configure which websites they want to monitor, else, all are considered.
+
+[float]
+=== `application_pool`
+This metricset will collect metrics of specific application pools, users can configure which websites they want to monitor, else, all are considered.
+
+
+[float]
+=== Module-specific configuration notes
+
+`application_pool.name`:: []string, users can specify the application pools they would like to monitor.
+
+
+
+[float]
+=== Example configuration
+
+The iis module supports the standard configuration options that are described
+in <<configuration-metricbeat>>. Here is an example configuration:
+
+[source,yaml]
+----
+metricbeat.modules:
+- module: iis
+  metricsets:
+    - webserver
+    - website
+    - application_pool
+  enabled: true
+  period: 10s
+
+ # filter on application pool names
+ # application_pool.name: []
+----
+
+[float]
+=== Metricsets
+
+The following metricsets are available:
+
+* <<metricbeat-metricset-iis-application_pool,application_pool>>
+
+* <<metricbeat-metricset-iis-webserver,webserver>>
+
+* <<metricbeat-metricset-iis-website,website>>
+
+include::iis/application_pool.asciidoc[]
+
+include::iis/webserver.asciidoc[]
+
+include::iis/website.asciidoc[]
+

metricbeat/docs/modules/iis/application_pool.asciidoc

@@ -0,0 +1,23 @@
+////
+This file is generated! See scripts/mage/docs_collector.go
+////
+
+[[metricbeat-metricset-iis-application_pool]]
+=== iis application_pool metricset
+
+beta[]
+
+include::../../../module/iis/application_pool/_meta/docs.asciidoc[]
+
+
+==== Fields
+
+For a description of each field in the metricset, see the
+<<exported-fields-iis,exported fields>> section.
+
+Here is an example document generated by this metricset:
+
+[source,json]
+----
+include::../../../module/iis/application_pool/_meta/data.json[]
+----

metricbeat/docs/modules/iis/webserver.asciidoc

@@ -0,0 +1,24 @@
+////
+This file is generated! See scripts/mage/docs_collector.go
+////
+
+[[metricbeat-metricset-iis-webserver]]
+=== iis webserver metricset
+
+beta[]
+
+include::../../../module/iis/webserver/_meta/docs.asciidoc[]
+
+This is a default metricset. If the host module is unconfigured, this metricset is enabled by default.
+
+==== Fields
+
+For a description of each field in the metricset, see the
+<<exported-fields-iis,exported fields>> section.
+
+Here is an example document generated by this metricset:
+
+[source,json]
+----
+include::../../../module/iis/webserver/_meta/data.json[]
+----

metricbeat/docs/modules/iis/website.asciidoc

@@ -0,0 +1,24 @@
+////
+This file is generated! See scripts/mage/docs_collector.go
+////
+
+[[metricbeat-metricset-iis-website]]
+=== iis website metricset
+
+beta[]
+
+include::../../../module/iis/website/_meta/docs.asciidoc[]
+
+This is a default metricset. If the host module is unconfigured, this metricset is enabled by default.
+
+==== Fields
+
+For a description of each field in the metricset, see the
+<<exported-fields-iis,exported fields>> section.
+
+Here is an example document generated by this metricset:
+
+[source,json]
+----
+include::../../../module/iis/website/_meta/data.json[]
+----

metricbeat/docs/modules_list.asciidoc

@@ -112,6 +112,10 @@ This file is generated! See scripts/mage/docs_collector.go
 |<<metricbeat-metricset-http-server,server>>   
 |<<metricbeat-module-ibmmq,IBM MQ>>  beta[]   |image:./images/icon-yes.png[Prebuilt dashboards are available]    |  
 .1+| .1+|  |<<metricbeat-metricset-ibmmq-qmgr,qmgr>> beta[]  
+|<<metricbeat-module-iis,iis>>  beta[]   |image:./images/icon-no.png[No prebuilt dashboards]    |  
+.3+| .3+|  |<<metricbeat-metricset-iis-application_pool,application_pool>> beta[]  
+|<<metricbeat-metricset-iis-webserver,webserver>> beta[]  
+|<<metricbeat-metricset-iis-website,website>> beta[]  
 |<<metricbeat-module-istio,istio>>  beta[]   |image:./images/icon-no.png[No prebuilt dashboards]    |  
 .5+| .5+|  |<<metricbeat-metricset-istio-citadel,citadel>> beta[]  
 |<<metricbeat-metricset-istio-galley,galley>> beta[]  
@@ -275,6 +279,7 @@ include::modules/graphite.asciidoc[]
 include::modules/haproxy.asciidoc[]
 include::modules/http.asciidoc[]
 include::modules/ibmmq.asciidoc[]
+include::modules/iis.asciidoc[]
 include::modules/istio.asciidoc[]
 include::modules/jolokia.asciidoc[]
 include::modules/kafka.asciidoc[]

metricbeat/metricbeat.reference.yml

@@ -346,6 +346,18 @@ metricbeat.modules:
   #    fields: # added to the the response in root. overwrites existing fields
   #      key: "value"
 
+#--------------------------------- Iis Module ---------------------------------
+- module: iis
+  metricsets:
+    - webserver
+    - website
+    - application_pool
+  enabled: true
+  period: 10s
+
+ # filter on application pool names
+ # application_pool.name: []
+
 #------------------------------- Jolokia Module -------------------------------
 - module: jolokia
   #metricsets: ["jmx"]

metricbeat/module/iis/_meta/config.yml

@@ -0,0 +1,10 @@
+- module: iis
+  metricsets:
+    - webserver
+    - website
+    - application_pool
+  enabled: true
+  period: 10s
+
+ # filter on application pool names
+ # application_pool.name: []

metricbeat/module/iis/_meta/docs.asciidoc

@@ -0,0 +1,50 @@
+This is the iis module.
+
+IIS (Internet Information Services) is a secure, reliable, and scalable Web server that provides an easy to manage platform for developing and hosting Web applications and services.
+
+The `iis` module will periodically retrieve IIS related metrics using performance counters such as:
+
+ - System/Process counters like the the overall server and CPU usage for the IIS Worker Process and memory (currently used and available memory for the IIS Worker Process).
+ - IIS performance counters like Web Service: Bytes Received/Sec, Web Service: Bytes Sent/Sec, etc, which are helpful to track to identify potential spikes in traffic.
+ - Web Service Cache counters in order to monitor user mode cache and output cache.
+
+
+The `iis` module mericsets are `webserver`, `website` and `application_pool`.
+
+[source,yaml]
+----
+- module: iis
+  metricsets:
+    - webserver
+    - website
+    - application_pool
+  enabled: true
+  period: 10s
+
+ # filter on application pool names
+ # application_pool.name: []
+----
+
+[float]
+== Metricsets
+
+[float]
+=== `webserver`
+A light metricset using the windows perfmon metricset as the base metricset.
+This metricset allows users to retrieve aggregated metrics for the entire webserver,
+
+[float]
+=== `website`
+A light metricset using the windows perfmon metricset as the base metricset.
+This metricset will collect metrics of specific sites, users can configure which websites they want to monitor, else, all are considered.
+
+[float]
+=== `application_pool`
+This metricset will collect metrics of specific application pools, users can configure which websites they want to monitor, else, all are considered.
+
+
+[float]
+=== Module-specific configuration notes
+
+`application_pool.name`:: []string, users can specify the application pools they would like to monitor.
+

metricbeat/module/iis/_meta/fields.yml

@@ -0,0 +1,11 @@
+- key: iis
+  title: "iis"
+  description: >
+    iis module
+  release: beta
+
+  fields:
+    - name: iis
+      type: group
+      description: >
+      fields:

metricbeat/module/iis/application_pool/_meta/data.json

@@ -0,0 +1,28 @@
+{
+    "@timestamp" : "2020-02-13T14:55:27.000Z",
+    "metricset" : {
+        "name" : "application_pool",
+        "period" : 10000
+    },
+    "service" : {
+        "type" : "iis"
+    },
+    "process" : {
+        "pid" : 7664
+    },
+    "iis" : {
+        "application_pool" : {
+            "net_clr" : {
+                "total_exceptions_thrown" : 0
+            },
+            "name" : "test.local",
+            "process" : {
+                "thread_count" : 32,
+                "private_byte" : 3.4684928E7,
+                "handle_count" : 743,
+                "virtual_bytes" : 6.49535488E8,
+                "working_set" : 4.2012672E7
+            }
+        }
+    }
+}