From 1ff1cc314bc9751e78fe1efb4d1469af3dd22b24 Mon Sep 17 00:00:00 2001 From: "mergify[bot]" <37929162+mergify[bot]@users.noreply.github.com> Date: Wed, 30 Mar 2022 12:18:54 -0700 Subject: [PATCH] Document loading inputs configuration from external files in standalone mode (#1515) (#1732) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Add a few sections about loading inputs from external configuration files * reword sentence * Update docs/en/ingest-management/elastic-agent/configuration/elastic-agent-configuration.asciidoc Co-authored-by: DeDe Morton Co-authored-by: Brandon Morelli Co-authored-by: DeDe Morton (cherry picked from commit c7cf6561464bcf5d7cd19b3568efaa646161b1e8) Co-authored-by: Noémi Ványi --- .../elastic-agent-configuration.asciidoc | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/en/ingest-management/elastic-agent/configuration/elastic-agent-configuration.asciidoc b/docs/en/ingest-management/elastic-agent/configuration/elastic-agent-configuration.asciidoc index 17f433a022..e7f3350dc5 100644 --- a/docs/en/ingest-management/elastic-agent/configuration/elastic-agent-configuration.asciidoc +++ b/docs/en/ingest-management/elastic-agent/configuration/elastic-agent-configuration.asciidoc @@ -21,6 +21,32 @@ changes after installation, you must modify the installed file. For installation details, refer to <>. +Alternatively, you can put input configurations in YAML files into the +folder `{path.config}/inputs.d` to separate your configuration into +multiple smaller files. +The YAML files in the `inputs.d` folder should contain input configurations only. +Any other configurations are ignored. +The files are reloaded at the same time as the standalone configuration. + +TIP: The first line of the configuration must be `inputs`. Then you can list the +inputs you would like to run. + +[source,yaml] +---- +inputs: + - type: logfile + data_stream.namespace: default + paths: [/path/to/file] + use_output: default + + - type: system/metrics + data_stream.namespace: default + use_output: default + streams: + - metricset: cpu + data_stream.dataset: system.cpu +---- + The following sections describe some settings you might need to configure to run an {agent} standalone. For a full reference example, refer to the <> file.