Clarify support for ssl options for modules (elastic#7967)

* Clarify support for ssl options for modules

* Change example to show http module

libbeat/docs/shared-ssl-config.asciidoc

@@ -8,6 +8,9 @@ You can specify SSL options when you configure:
 ifeval::["{beatname_lc}"=="heartbeat"]
 * <<configuration-heartbeat-options,{beatname_uc} monitors>> that support SSL
 endif::[]
+ifeval::["{beatname_lc}"=="metricbeat"]
+* <<metricbeat-modules,modules>> that define the host as an HTTP URL
+endif::[]
 
 Example output config with SSL enabled:
 
@@ -51,6 +54,22 @@ heartbeat.monitors:
 -------------------------------------------------------------------------------
 endif::[]
 
+ifeval::["{beatname_lc}"=="metricbeat"]
+Example module with SSL enabled:
+
+[source,yaml]
+----
+- module: http
+  namespace: "myservice"
+  enabled: true
+  period: 10s
+  hosts: ["https://localhost"]
+  path: "/stats"
+  headers:
+    Authorization: "Bearer test123"
+  ssl.verification_mode: "none"
+----
+endif::[]
 
 [float]
 === Configuration options

metricbeat/docs/metricbeat-options.asciidoc

@@ -204,8 +204,8 @@ processors in your config.
 [[module-http-config-options]]
 === Standard HTTP config options
 
-The modules and metricsets for which the host is defined as a HTTP URL, also
-support the following options:
+The following options are available for modules and metricsets that define the
+host as an HTTP URL:
 
 [float]
 ==== `username`
@@ -217,6 +217,14 @@ The username to use for basic authentication.
 
 The password to use for basic authentication.
 
+[float]
+==== `ssl`
+
+Configuration options for SSL parameters like the certificate authority to use
+for HTTPS-based connections.
+
+See <<configuration-ssl>> for more information.
+
 [float]
 ==== `headers`