diff --git a/docs/en/ingest-management/agent-policies.asciidoc b/docs/en/ingest-management/agent-policies.asciidoc index 0a22fe4d0..0d906d727 100644 --- a/docs/en/ingest-management/agent-policies.asciidoc +++ b/docs/en/ingest-management/agent-policies.asciidoc @@ -92,6 +92,10 @@ The following table illustrates the {fleet} user actions available to different |{y} |{n} +|<> +|{y} +|{n} + |<> |{y} |{n} @@ -251,6 +255,26 @@ Alternatively, click **Delete policy** to delete the policy. Existing data is not deleted. Any agents assigned to a policy must be unenrolled or assigned to a different policy before a policy can be deleted. + +[discrete] +[[change-policy-enable-agent-monitoring,Enable agent monitoring]] +== Enable agent monitoring + +Use this setting to collect monitoring logs and metrics from {agent}. All monitoring data will be written to the specified **Default namespace**. + +. In {fleet}, click **Agent policies**. +Select the name of the policy you want to edit. + +. Click the **Settings** tab and scroll to **Enable agent monitorings**. + +. Select whether to collect agent logs, agent metrics, or both, from the {agents} that use the policy. + +When this setting is enabled: + +* An {agent} integration is created automatically. +* A `/liveness` endpoint is enabled and available where the server is configured to be exposed. By default, the endpoint +returns a `200` OK status as long as {agent}'s internal main loop is responsive and can process configuration changes. It can be configured to also monitor the component states to return an error if anything is degraded or failed. + [discrete] [[change-policy-output]] == Change the output of a policy diff --git a/docs/en/ingest-management/elastic-agent/configuration/elastic-agent-monitoring.asciidoc b/docs/en/ingest-management/elastic-agent/configuration/elastic-agent-monitoring.asciidoc index be0add9f8..b40dc257f 100644 --- a/docs/en/ingest-management/elastic-agent/configuration/elastic-agent-monitoring.asciidoc +++ b/docs/en/ingest-management/elastic-agent/configuration/elastic-agent-monitoring.asciidoc @@ -38,6 +38,11 @@ To enable monitoring, set `agent.monitoring.enabled` to `true`. Also set the collected. If neither setting is specified, monitoring is turned off. Set `use_output` to specify the output to which monitoring events are sent. +Setting `agent.monitoring.enabled` to `true` also exposes a `/liveness` endpoint. By default, the endpoint +returns a `200` OK status as long as {agent}'s internal main loop is responsive and can +process configuration changes. It can be configured to also monitor the component states +and return an error if anything is degraded or has failed. + The `agent.monitoring.pprof.enabled` option controls whether the {agent} and {beats} expose the `/debug/pprof/` endpoints with the monitoring endpoints. It is set to `false` by default. Data produced by these endpoints can be useful for debugging but present a