@@ -23,6 +23,8 @@ route data from the production cluster to ESMS. Otherwise, it is simplest to use
23
23
24
24
To use {metricbeat}:
25
25
26
+ . If your production cluster is stopped, {ref}/starting-elasticsearch.html[start it].
27
+
26
28
. Configure the following settings on each node in the production cluster:
27
29
+
28
30
--
@@ -31,7 +33,6 @@ To use {metricbeat}:
31
33
PUT _cluster/settings
32
34
{
33
35
"persistent": {
34
- "xpack.monitoring.enabled": true,
35
36
"xpack.monitoring.collection.enabled": true,
36
37
"xpack.monitoring.elasticsearch.collection.enabled": false
37
38
}
@@ -41,6 +42,13 @@ PUT _cluster/settings
41
42
42
43
Alternatively, you can put those settings in the `elasticsearch.yml` file on
43
44
each node. This method, however, requires you to restart each node.
45
+
46
+ The `xpack.monitoring.enabled` setting must also have a value of `true`, which
47
+ is its default value. If you have set it to `false` in the `elasticsearch.yml`
48
+ file on any node, you must change or remove it.
49
+
50
+ For more information about these settings, see
51
+ {ref}/monitoring-settings.html[Monitoring settings in {es}].
44
52
--
45
53
46
54
. {metricbeat-ref}/metricbeat-installation.html[Install {metricbeat}].
@@ -99,18 +107,19 @@ configuration file (`metricbeat.yml`):
99
107
----------------------------------
100
108
output.elasticsearch:
101
109
hosts: ["MONITORING_ELASTICSEARCH_URL"] <1>
102
- username: cloud_monitoring_agent
103
- password: MONITORING_AGENT_PASSWORD <2 >
110
+ username: cloud_monitoring_agent <2>
111
+ password: MONITORING_AGENT_PASSWORD <3 >
104
112
----------------------------------
105
113
<1> Replace `MONITORING_ELASTICSEARCH_URL` with the appropriate URL from the ESMS.
106
- <2> Replace `MONITORING_AGENT_PASSWORD` with the value provided to you by the
114
+ <2> The Elastic support team creates this user in ESMS and grants it the
115
+ {stack-ov}/built-in-roles.html[`remote_monitoring_agent` built-in role].
116
+ <3> Replace `MONITORING_AGENT_PASSWORD` with the value provided to you by the
107
117
Elastic support team.
108
118
--
109
119
110
- . {ref}/starting-elasticsearch.html[Start {es}].
111
-
112
120
. {metricbeat-ref}/metricbeat-starting.html[Start {metricbeat}].
113
121
122
+ ////
114
123
To use collectors and exporters:
115
124
116
125
. Copy the certificates that you obtained from the Elastic support team to the
@@ -131,23 +140,26 @@ PUT _cluster/settings
131
140
"xpack.monitoring.elasticsearch.collection.enabled": true,
132
141
"xpack.monitoring.exporters.cloud_monitoring.type": "http",
133
142
"xpack.monitoring.exporters.cloud_monitoring.host": "MONITORING_ELASTICSEARCH_URL", <1>
134
- "xpack.monitoring.exporters.cloud_monitoring.auth.username": "cloud_monitoring_agent",
135
- "xpack.monitoring.exporters.cloud_monitoring.auth.password": "MONITORING_AGENT_PASSWORD" <2 >
136
- "xpack.monitoring.exporters.cloud_monitoring.ssl.certificate_authorities": "ES_PATH_CONF/ca.crt" <3 >
143
+ "xpack.monitoring.exporters.cloud_monitoring.auth.username": "cloud_monitoring_agent", <2>
144
+ "xpack.monitoring.exporters.cloud_monitoring.auth.password": "MONITORING_AGENT_PASSWORD" <3 >
145
+ "xpack.monitoring.exporters.cloud_monitoring.ssl.certificate_authorities": "ES_PATH_CONF/ca.crt" <4 >
137
146
}
138
147
}
139
148
----------------------------------
140
149
// CONSOLE
141
150
<1> Replace `MONITORING_ELASTICSEARCH_URL` with the appropriate URL from the ESMS.
142
- <2> Replace `MONITORING_AGENT_PASSWORD` with the value provided to you by the
151
+ <2> The Elastic support team creates this user in ESMS and grants it the
152
+ {stack-ov}/built-in-roles.html[`remote_monitoring_agent` built-in role].
153
+ <3> Replace `MONITORING_AGENT_PASSWORD` with the value provided to you by the
143
154
Elastic support team.
144
- <3 > Replace the path and file name with the appropriate information for the file
155
+ <4 > Replace the path and file name with the appropriate information for the file
145
156
provided by the Elastic support team.
146
157
147
158
Alternatively, you can put those settings in the `elasticsearch.yml` file on
148
159
each node. This method, however, requires you to restart each node.
149
160
--
150
-
161
+ ////
162
+ ////
151
163
[discrete]
152
164
[[esms-kibana]]
153
165
=== Collecting monitoring data about {kib}
@@ -257,16 +269,19 @@ configuration file (`metricbeat.yml`):
257
269
----------------------------------
258
270
output.elasticsearch:
259
271
hosts: ["MONITORING_ELASTICSEARCH_URL"] <1>
260
- username: cloud_monitoring_agent
261
- password: MONITORING_AGENT_PASSWORD <2 >
272
+ username: cloud_monitoring_agent <2>
273
+ password: MONITORING_AGENT_PASSWORD <3 >
262
274
----------------------------------
263
275
<1> Replace `MONITORING_ELASTICSEARCH_URL` with the appropriate URL from the ESMS.
264
- <2> Replace `MONITORING_AGENT_PASSWORD` with the value provided to you by the
276
+ <2> The Elastic support team creates this user in ESMS and grants it the
277
+ {stack-ov}/built-in-roles.html[`remote_monitoring_agent` built-in role].
278
+ <3> Replace `MONITORING_AGENT_PASSWORD` with the value provided to you by the
265
279
Elastic support team.
266
280
--
267
281
268
282
. {metricbeat-ref}/metricbeat-starting.html[Start {metricbeat}].
269
283
284
+ ////
270
285
////
271
286
To use HTTP exporters:
272
287
TBD
0 commit comments