Skip to content

Commit d599167

Browse files
1 parent ac5f4f3 commit d599167

File tree

1 file changed

+7
-15
lines changed

1 file changed

+7
-15
lines changed

solutions/observability/apps/monitor-fleet-managed-apm-server.md

+7-15
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,12 @@ applies_to:
66
stack: all
77
---
88

9-
10-
119
# Monitor a Fleet-managed APM Server [apm-monitor-apm-self-install]
1210

13-
1411
::::{note}
1512
This guide assumes you are already ingesting APM data into the {{stack}}.
1613
::::
1714

18-
1915
In 8.0 and later, you can use {{metricbeat}} to collect data about APM Server and ship it to a monitoring cluster. To collect and ship monitoring data:
2016

2117
1. [Configure {{agent}} to send monitoring data](#apm-configure-ea-monitoring-data)
@@ -24,11 +20,13 @@ In 8.0 and later, you can use {{metricbeat}} to collect data about APM Server an
2420

2521
## Configure {{agent}} to send monitoring data [apm-configure-ea-monitoring-data]
2622

27-
::::{admonition}
28-
Before you can monitor APM, you must have monitoring data for the {{es}} production cluster. To learn how, see [Collect {{es}} monitoring data with {{metricbeat}}](../../../deploy-manage/monitor/stack-monitoring/collecting-monitoring-data-with-metricbeat.md). Alternatively, open the **{{stack-monitor-app}}** app in {{kib}} and follow the in-product guide.
29-
23+
::::{note}
24+
Before you can monitor APM, you must have monitoring data for the {{es}} production cluster. To learn how, see [Collect {{es}} monitoring data with {{metricbeat}}](/deploy-manage/monitor/stack-monitoring/collecting-monitoring-data-with-metricbeat.md). Alternatively, open the **{{stack-monitor-app}}** app in {{kib}} and follow the in-product guide.
3025
::::
3126

27+
:::{warning}
28+
Use the Fleet UI to change the agent's HTTP monitoring endpoint using [Advanced agent monitoring settings](/reference/fleet/agent-policy.md#advanced-agent-monitoring-settings-advanced-agent-monitoring-settings).
29+
:::
3230

3331
1. Enable monitoring of {{agent}} by adding the following settings to your `elastic-agent.yml` configuration file:
3432

@@ -99,8 +97,6 @@ See the [{{agent}} command reference](/reference/fleet/agent-command-reference.m
9997
period: 10s
10098
hosts: ["http://localhost:6791"]
10199
basepath: "/processes/apm-server-default"
102-
username: remote_monitoring_user
103-
password: your_password
104100
```
105101

106102
1. Do not change the `module` name or `xpack.enabled` boolean; these are required for stack monitoring. We recommend accepting the default `period` for now.
@@ -115,10 +111,6 @@ See the [{{agent}} command reference](/reference/fleet/agent-command-reference.m
115111
If you configured {{agent}} to use encrypted communications, you must access it via HTTPS. For example, use a `hosts` setting like `https://localhost:5066`.
116112

117113
3. APM Server metrics are exposed at `/processes/apm-server-default`. Add this location as the `basepath`.
118-
4. Set the `username` and `password` settings as required by your environment. If Elastic {{security-features}} are enabled, you must provide a username and password so that {{metricbeat}} can collect metrics successfully:
119-
120-
1. Create a user on the {{es}} cluster that has the `remote_monitoring_collector` [built-in role](../../../deploy-manage/users-roles/cluster-or-deployment-auth/built-in-roles.md). Alternatively, if it’s available in your environment, use the `remote_monitoring_user` [built-in user](../../../deploy-manage/users-roles/cluster-or-deployment-auth/built-in-users.md).
121-
2. Add the `username` and `password` settings to the beat module configuration file.
122114

123115
4. Optional: Disable the system module in the {{metricbeat}}.
124116

@@ -162,10 +154,10 @@ See the [{{agent}} command reference](/reference/fleet/agent-command-reference.m
162154

163155
If the {{es}} {{security-features}} are enabled on the monitoring cluster, you must provide a valid user ID and password so that {{metricbeat}} can send metrics successfully:
164156

165-
1. Create a user on the monitoring cluster that has the `remote_monitoring_agent` [built-in role](../../../deploy-manage/users-roles/cluster-or-deployment-auth/built-in-roles.md). Alternatively, if it’s available in your environment, use the `remote_monitoring_user` [built-in user](../../../deploy-manage/users-roles/cluster-or-deployment-auth/built-in-users.md).
157+
1. Create a user on the monitoring cluster that has the `remote_monitoring_agent` [built-in role](/deploy-manage/users-roles/cluster-or-deployment-auth/built-in-roles.md). Alternatively, if it’s available in your environment, use the `remote_monitoring_user` [built-in user](/deploy-manage/users-roles/cluster-or-deployment-auth/built-in-users.md).
166158
2. Add the `username` and `password` settings to the {{es}} output information in the {{metricbeat}} configuration file.
167159

168160
For more information about these configuration options, see [Configure the {{es}} output](beats://reference/metricbeat/elasticsearch-output.md).
169161

170162
6. [Start {{metricbeat}}](beats://reference/metricbeat/metricbeat-starting.md) to begin collecting APM monitoring data.
171-
7. [View the monitoring data in {{kib}}](../../../deploy-manage/monitor/stack-monitoring/kibana-monitoring-data.md).
163+
7. [View the monitoring data in {{kib}}](/deploy-manage/monitor/stack-monitoring/kibana-monitoring-data.md).

0 commit comments

Comments
 (0)