Browse Source

Document Consul ECS resource usage

Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com>
Co-authored-by: Paul Glass <pglass@hashicorp.com>
pull/12228/head
Eric 3 years ago
parent
commit
c3a0011c3d
  1. 37
      website/content/docs/ecs/task-resource-usage.mdx
  2. 4
      website/data/docs-nav-data.json

37
website/content/docs/ecs/task-resource-usage.mdx

@ -0,0 +1,37 @@
---
layout: docs
page_title: Resource Usage - AWS ECS
description: >-
Resource usage of the Consul Service Mesh on AWS ECS (Elastic Container Service).
---
# Resource Usage
We ran performance tests of Consul on ECS to determine the resource usage of
the sidecar containers Consul on ECS injects along with the ACL controller.
[The architecture page](/docs/ecs/architecture) describes each Consul on ECS
component in depth.
We used the following procedure to measure resource usage:
- Executed performance tests while deploying clusers of various sizes. We
ensured that deployment conditions stressed Consul on ESC components.
- After each performance test session, we recorded resource usage for each
component to determine worst-case scenario resource usage in a production
environment.
- We used Fargate's minimum allowed CPU (256 shares) and memory settings (512
MB) on ECS during performance testing to demonstrate that Consul on ECS along
with application containers can run on the smallest ECS tasks.
Here is the maximum resource usage we observed for each container:
| Container | CPU | Memory |
| -------------- | --- | ------ |
| ACL Controller | 5% | 43 MB |
| Health Sync | 6% | 35 MB |
| Consul Client | 10% | 87 MB |
| Envoy | 18% | 55 MB |
The containers added by Consul on ECS consume resources well below the minimum CPU and
memory limits for an ECS Task. Use the `memory` and `cpu` settings for the task definition
if additional resources are necessary for your application task.

4
website/data/docs-nav-data.json

@ -629,6 +629,10 @@
"title": "Requirements", "title": "Requirements",
"path": "ecs/requirements" "path": "ecs/requirements"
}, },
{
"title": "Task Resource Usage",
"path": "ecs/task-resource-usage"
},
{ {
"title": "Install with Terraform", "title": "Install with Terraform",
"routes": [ "routes": [

Loading…
Cancel
Save