[DOCS] Move monitoring configuration info (elastic/x-pack-elasticsearch#3674)

Original commit: elastic/x-pack-elasticsearch@eb68a4d3ae

docs/build.gradle

@@ -19,6 +19,7 @@ buildRestTests.expectedUnconvertedCandidates = [
         'en/ml/functions/time.asciidoc',
         'en/ml/aggregations.asciidoc',
         'en/ml/customurl.asciidoc',
+        'en/monitoring/indices.asciidoc',
         'en/rest-api/security/ssl.asciidoc',
         'en/rest-api/security/users.asciidoc',
         'en/rest-api/security/tokens.asciidoc',

docs/en/monitoring/configuring-monitoring.asciidoc

@@ -0,0 +1,16 @@
+[role="xpack"]
+[[configuring-monitoring]]
+== Configuring Monitoring in {es}
+++++
+<titleabbrev>Configuring Monitoring</titleabbrev>
+++++
+
+{monitoring} is enabled by default when you install {xpack}. Advanced monitoring
+settings enable you to control how frequently data is collected, configure
+timeouts, and set the retention period for locally-stored monitoring indices. You
+can also adjust how monitoring data is displayed. For more information, see
+<<es-monitoring>>.
+
+include::indices.asciidoc[]
+include::tribe.asciidoc[]
+include::{xes-repo-dir}/settings/monitoring-settings.asciidoc[]

docs/en/monitoring/http-export.asciidoc

@@ -12,7 +12,7 @@ through the network.
 The `http` exporter supports a number of settings that control how it
 communicates over HTTP to remote clusters. In most cases, it is not
 necessary to explicitly configure these settings. For detailed
-descriptions, see {ref}/monitoring-settings.html[Monitoring Settings].
+descriptions, see <<monitoring-settings,Monitoring Settings>>.
 
 [source,yaml]
 ----------------------------------

docs/en/monitoring/index.asciidoc

@@ -20,4 +20,3 @@ introduction to monitoring your Elastic stack, including Logstash and {kib}, see
 
 include::stats-export.asciidoc[]
 include::http-export.asciidoc[]
-include::tribe.asciidoc[]

docs/en/monitoring/indices.asciidoc

@@ -0,0 +1,42 @@
+[role="xpack"]
+[[config-monitoring-indices]]
+=== Configuring Indices for Monitoring
+
+<<indices-templates,Index templates>> are used to configure the indices
+that store the monitoring data collected from a cluster.
+
+You can retrieve the templates through the `_template` API:
+
+[source,sh]
+----------------------------------
+GET /_template/.monitoring-*
+----------------------------------
+
+By default, the template configures one shard and one replica for the
+monitoring indices. To override the default settings, add your own template:
+
+. Set the `template` pattern to `.monitoring-*`.
+. Set the template `order` to `1`. This ensures your template is
+applied after the default template, which has an order of 0.
+. Specify the `number_of_shards` and/or `number_of_replicas` in the `settings`
+section.
+
+For example, the following template increases the number of shards to five
+and the number of replicas to two.
+
+[source,js]
+----------------------------------
+PUT /_template/custom_monitoring
+{
+    "index_patterns": ".monitoring-*",
+    "order": 1,
+    "settings": {
+        "number_of_shards": 5,
+        "number_of_replicas": 2
+    }
+}
+----------------------------------
+
+IMPORTANT: Only set the `number_of_shards` and `number_of_replicas` in the
+settings section. Overriding other monitoring template settings could cause
+your monitoring dashboards to stop working correctly.

docs/en/monitoring/tribe.asciidoc

@@ -1,6 +1,6 @@
 [role="xpack"]
 [[monitoring-tribe]]
-== Configuring a Tribe Node to Work with Monitoring
+=== Configuring a Tribe Node to Work with Monitoring
 
 If you connect to a cluster through a <<modules-tribe,tribe node>>,
 and you want to monitor the tribe node, then you will need to install {xpack} on

docs/en/settings/configuring-xes.asciidoc

@@ -8,6 +8,4 @@
 include::{asciidoc-dir}/../../shared/settings.asciidoc[]
 include::license-settings.asciidoc[]
 include::ml-settings.asciidoc[]
-include::monitoring-settings.asciidoc[]
-//include::security-settings.asciidoc[]
 include::notification-settings.asciidoc[]

docs/en/setup/setup-xes.asciidoc

@@ -11,6 +11,7 @@ easy-to-install package. To access this functionality, you must
 --
 
 include::installing-xes.asciidoc[]
+include::{xes-repo-dir}/monitoring/configuring-monitoring.asciidoc[]
 include::{xes-repo-dir}/security/configuring-es.asciidoc[]
 include::setup-xclient.asciidoc[]
 include::{xes-repo-dir}/settings/configuring-xes.asciidoc[]