Skip to content

Commit 7fabf2e

Browse files
alexsaprancmacknzkilfoyle
authored andcommitted
Update the elastic-agent resource consumption docs (#1414)
Update the installation page of elastic-agent by adding the resource usage consumption we observed in our lab environments. Signed-off-by: Alexandros Sapranidis <[email protected]> Co-authored-by: Craig MacKenzie <[email protected]> Co-authored-by: David Kilfoyle <[email protected]> (cherry picked from commit d7ef138)
1 parent 8db126f commit 7fabf2e

File tree

1 file changed

+21
-13
lines changed

1 file changed

+21
-13
lines changed

docs/en/ingest-management/elastic-agent/install-elastic-agent.asciidoc

Lines changed: 21 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
[[elastic-agent-installation]]
22
= Install {agent}s
33

4-
[IMPORTANT]
4+
[IMPORTANT]
55
.Restrictions
66
====
77
Note the following restrictions when installing {agent} on your system:
@@ -12,7 +12,7 @@ run the commands described here. After the {agent} service is installed and runn
1212
make sure you run these commands without prepending them with `./` to avoid
1313
invoking the wrong binary.
1414
* Running {agent} commands using the Windows PowerShell ISE is not supported.
15-
* See also the <<elastic-agent-installation-minimum-requirements,minimum requirements>> described on this page.
15+
* See also the <<elastic-agent-installation-resource-requirements,resource requirements>> described on this page.
1616
====
1717

1818
You have a few options for installing and managing an {agent}:
@@ -57,32 +57,40 @@ Refer to:
5757
* {eck-ref}/k8s-elastic-agent.html[Run {agent} on ECK] -- for {eck} users
5858
--
5959

60-
[IMPORTANT]
60+
[IMPORTANT]
6161
.Restrictions in {serverless-short}
62-
====
62+
====
6363
If you are using {agent} with link:{serverless-docs}[{serverless-full}], note these differences from use with {ess} and self-managed {es}:
6464
6565
* The number of {agents} that may be connected to an {serverless-full} project is limited to 10 thousand.
6666
* The minimum supported version of {agent} supported for use with {serverless-full} is 8.11.0.
6767
====
6868

6969
[discrete]
70-
[[elastic-agent-installation-minimum-requirements]]
71-
== Minimum requirements
70+
[[elastic-agent-installation-resource-requirements]]
71+
== Resource requirements
72+
73+
The {agent} resources consumption is influenced by the number of integration and the environment its been running on.
74+
75+
Using our lab environment as an example, we can observe the following resource consumption:
7276

73-
The following are the minimum system requirements for installing {agent}.
7477
// lint ignore mem
7578
[discrete]
7679
=== CPU and RSS memory size
7780

78-
// lint ignore 2vcpu 1gb
79-
Minimum requirements have been determined by running the {agent} on a GCP `e2-micro` instance (2vCPU/1GB).
80-
The {agent} used the default policy, running the system integration and self-monitoring.
81-
81+
// lint ignore 2 vCPU 8.0 GiB
82+
We tested using an AWS `m7i.large` instance type with 2 vCPUs, 8.0 GB of memory, and up to 12.5 Gbps of bandwidth. The tests ingested a single log file using both the <<output-elasticsearch-performance-tuning-settings,throughput and scale preset>> with self monitoring enabled.
83+
These tests are representative of use cases that attempt to ingest data as fast as possible. This does not represent the resource overhead when using {integrations-docs}/endpoint[{elastic-defend}].
84+
[options,header]
8285
|===
83-
| **CPU** | Under 2% total, including all monitoring processes
84-
| **RSS memory size** | 400 MB
86+
| **Resource** | **Throughput** | **Scale**
87+
| **CPU*** | ~67% total | ~20%
88+
| **RSS memory size*** | ~280 MB | ~220 MB
89+
| **Write network throughput** | ~3.5 MB/s | 480 KB/s
8590
|===
91+
92+
^*^ including all monitoring processes
93+
8694
Adding integrations will increase the memory used by the agent and its processes.
8795

8896
[discrete]

0 commit comments

Comments
 (0)