Skip to content

Commit

Permalink
Document loading inputs configuration from external files in standalo…
Browse files Browse the repository at this point in the history
…ne mode (elastic#1515)

* 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 <dede.morton@elastic.co>

Co-authored-by: Brandon Morelli <bmorelli25@gmail.com>
Co-authored-by: DeDe Morton <dede.morton@elastic.co>
  • Loading branch information
3 people authored Mar 30, 2022
1 parent 61955a4 commit c4ac54f
Showing 1 changed file with 26 additions and 0 deletions.
26 changes: 26 additions & 0 deletions elastic-agent/configuration/elastic-agent-configuration.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,32 @@ changes after installation, you must modify the installed file.

For installation details, refer to <<install-standalone-elastic-agent>>.

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
<<elastic-agent-reference-yaml,elastic-agent.reference.yml>> file.
Expand Down

0 comments on commit c4ac54f

Please sign in to comment.