Add ingress_controller docs (#17510) (#17584)

Signed-off-by: chrismark <[email protected]>
(cherry picked from commit c0f1854)

filebeat/docs/modules/nginx.asciidoc

@@ -12,6 +12,10 @@ This file is generated! See scripts/docs_collector.py
 The +{modulename}+ module parses access and error logs created by the
 http://nginx.org/[Nginx] HTTP server.
 
+`ingress_controller` fileset parses access logs created by https://github.com/kubernetes/ingress-nginx[ingress-nginx] controller.
+Log patterns could be found on the controllers'
+https://github.com/kubernetes/ingress-nginx/blob/nginx-0.28.0/docs/user-guide/nginx-configuration/log-format.md[docs].
+
 include::../include/what-happens.asciidoc[]
 
 include::../include/gs-link.asciidoc[]
@@ -24,6 +28,8 @@ The Nginx module was tested with logs from version 1.10.
 On Windows, the module was tested with Nginx installed from the Chocolatey
 repository.
 
+`ingress_controller` fileset was tested with version 0.28.0 of `nginx-ingress-controller`.
+
 include::../include/configuring-intro.asciidoc[]
 
 The following example shows how to set paths in the +modules.d/{modulename}.yml+
@@ -48,8 +54,17 @@ To specify the same settings at the command line, you use:
 -M "nginx.access.var.paths=[/path/to/log/nginx/access.log*]" -M "nginx.error.var.paths=[/path/to/log/nginx/error.log*]"
 -----
 
+The following example shows how to configure `ingress_controller` fileset which can be used in Kubernetes environments
+to parse ingress-nginx logs:
+
+["source","yaml",subs="attributes"]
+-----
+- module: nginx
+  ingress_controller:
+    enabled: true
+    var.paths: ["/path/to/log/nginx/ingress.log"]
+-----
 
-
 
 //set the fileset name used in the included example
 :fileset_ex: access
@@ -66,6 +81,11 @@ include::../include/var-paths.asciidoc[]
 
 include::../include/var-paths.asciidoc[]
 
+[float]
+==== `ingress_controller` log fileset
+
+include::../include/var-paths.asciidoc[]
+
 include::../include/timezone-support.asciidoc[]
 
 [float]

filebeat/module/nginx/_meta/docs.asciidoc

@@ -7,6 +7,10 @@
 The +{modulename}+ module parses access and error logs created by the
 http://nginx.org/[Nginx] HTTP server.
 
+`ingress_controller` fileset parses access logs created by https://github.com/kubernetes/ingress-nginx[ingress-nginx] controller.
+Log patterns could be found on the controllers'
+https://github.com/kubernetes/ingress-nginx/blob/nginx-0.28.0/docs/user-guide/nginx-configuration/log-format.md[docs].
+
 include::../include/what-happens.asciidoc[]
 
 include::../include/gs-link.asciidoc[]
@@ -19,6 +23,8 @@ The Nginx module was tested with logs from version 1.10.
 On Windows, the module was tested with Nginx installed from the Chocolatey
 repository.
 
+`ingress_controller` fileset was tested with version 0.28.0 of `nginx-ingress-controller`.
+
 include::../include/configuring-intro.asciidoc[]
 
 The following example shows how to set paths in the +modules.d/{modulename}.yml+
@@ -43,8 +49,17 @@ To specify the same settings at the command line, you use:
 -M "nginx.access.var.paths=[/path/to/log/nginx/access.log*]" -M "nginx.error.var.paths=[/path/to/log/nginx/error.log*]"
 -----
 
+The following example shows how to configure `ingress_controller` fileset which can be used in Kubernetes environments
+to parse ingress-nginx logs:
+
+["source","yaml",subs="attributes"]
+-----
+- module: nginx
+  ingress_controller:
+    enabled: true
+    var.paths: ["/path/to/log/nginx/ingress.log"]
+-----
 
-
 
 //set the fileset name used in the included example
 :fileset_ex: access
@@ -61,6 +76,11 @@ include::../include/var-paths.asciidoc[]
 
 include::../include/var-paths.asciidoc[]
 
+[float]
+==== `ingress_controller` log fileset
+
+include::../include/var-paths.asciidoc[]
+
 include::../include/timezone-support.asciidoc[]
 
 [float]