diff --git a/docs/en/ingest-management/commands.asciidoc b/docs/en/ingest-management/commands.asciidoc index d5e829cb1..8e807c0d8 100644 --- a/docs/en/ingest-management/commands.asciidoc +++ b/docs/en/ingest-management/commands.asciidoc @@ -75,6 +75,7 @@ This command is intended for debugging purposes only. The output format and stru ---- elastic-agent diagnostics [--file ] [-p] + [--exclude-events] [--help] [global-flags] ---- @@ -91,6 +92,9 @@ Show help for the `diagnostics` command. `-p`:: Additionally runs a 30-second CPU profile on each running component. This will generate an additional `cpu.pprof` file for each component. +`--exclude-events`:: +Exclude the events log files from the diagnostics archive. + {global-flags-link} [discrete] diff --git a/docs/en/ingest-management/elastic-agent/configuration/elastic-agent-standalone-logging.asciidoc b/docs/en/ingest-management/elastic-agent/configuration/elastic-agent-standalone-logging.asciidoc index f85fa46ef..fbfe68524 100644 --- a/docs/en/ingest-management/elastic-agent/configuration/elastic-agent-standalone-logging.asciidoc +++ b/docs/en/ingest-management/elastic-agent/configuration/elastic-agent-standalone-logging.asciidoc @@ -29,6 +29,21 @@ agent.logging.files: You can specify the following settings in the Logging section of the `elastic-agent.yml` config file. +Some outputs will log raw events on errors like indexing errors in the +Elasticsearch output, to prevent logging raw events (that may contain +sensitive information) together with other log messages, a different +log file, only for log entries containing raw events, is used. It will +use the same level, selectors and all other configurations from the +default logger, but it will have it's own file configuration. + +Having a different log file for raw events also prevents event data +from drowning out the regular log files. Use +`agent.logging.event_data` to configure the events logger. + +The events log file is not collected by the {agent} monitoring. +If the events log files are needed, they can be collected with +the diagnostics or directly copied from the host running {agent}. + [cols="2*