An Amazon ECS cluster is a logical grouping of tasks or services.
- If tasks or services are being run that use the EC2 launch type, a cluster is also a grouping of container instances.
- If capacity providers are being used, a cluster is also a logical grouping of capacity providers.
When Amazon ECS is first used, a default cluster is created. Multiple clusters can be created in an account and help to keep resources separate.
An Amazon ECS service runs and maintains the requested number of tasks and associated load balancers.
External reference
Setup
To set up the AWS integration and discover the VPN resources, do the following:
- Create an AWS Integration if not available in your installed integrations.
- Create a discovery profile.
- Select
ECS Clustersin the AWS Integration Discovery Profile. - Save the discovery profile to make them available in the list of Discovery Profiles.
- Scan to discover the resources at any time independent of the predefined schedule.
- Once the scan is completed, you can view the
ECS Clustersresources under Infrastructure > Resources > AWS category.
Event support
CloudTrail event support
- Not Supported
CloudWatch alarm support
- Supported
- Configurable in OpsRamp AWS Integration Discovery Profile.
Supported metrics
AWS ECS Cluster Metrics
| OpsRamp Metric | AWS Metric | Metric Display Name | Unit | Aggregation Type | Description |
|---|---|---|---|---|---|
| aws_ecs_CPUReservation | CPUReservation | CPU Reservation | Percent | Average | The percentage of CPU units that are reserved in the cluster or service. |
| aws_ecs_CPUUtilization | CPUUtilization | CPU Utilization | Percent | Average | The percentage of CPU units that is used by the cluster or service. |
| aws_ecs_MemoryReservation | MemoryReservation | Memory Reservation | Percent | Average | The percentage of memory that is reserved by running tasks in the cluster. |
| aws_ecs_MemoryUtilization | MemoryUtilization | Memory Utilization | Percent | Average | The percentage of memory in use by the cluster or service. |
| aws_ecs_GPUReservation | GPUReservation | GPU Reservation | Percent | Average | The percentage of total available GPUs that are reserved by running tasks in the cluster. |
| aws_ecs_container_insights_ContainerInstanceCount | ContainerInstanceCount | Container Instance Count | Count | Average | The number of EC2 instances running the Amazon ECS agent that are registered with a cluster. |
| aws_ecs_container_insights_CpuUtilized | CpuUtilized | Cpu Utilized | None | Average | The CPU units used by tasks in the resource that is specified by the dimension set that you're using. |
| aws_ecs_container_insights_CpuReserved | CpuReserved | Cpu Reserved | None | Average | The CPU units reserved by tasks in the resource that is specified by the dimension set that you're using. |
| aws_ecs_container_insights_EphemeralStorageReserved | EphemeralStorageReserved | Ephemeral Storage Reserved | Gigabytes | Average | The number of bytes reserved from ephemeral storage in the resource that is specified by the dimensions that you're using. |
| aws_ecs_container_insights_EphemeralStorageUtilized | EphemeralStorageUtilized | Ephemeral Storage Utilized | Gigabytes | Average | The number of bytes used from ephemeral storage in the resource that is specified by the dimensions that you're using. |
| aws_ecs_container_insights_InstanceOSFilesystemUtilization | InstanceOSFilesystemUtilization | Instance OS Filesystem Utilization | Percent | Average | The percentage of total disk space that is used for OS volume. |
| aws_ecs_container_insights_InstanceDataFilesystemUtilization | InstanceDataFilesystemUtilization | Instance Data Filesystem Utilization | Percent | Average | The percentage of total disk space that is used for data volume. |
| aws_ecs_container_insights_MemoryUtilized | MemoryUtilized | Memory Utilized | Megabytes | Average | The memory being used by tasks in the resource that is specified by the dimension set that you're using. |
| aws_ecs_container_insights_MemoryReserved | MemoryReserved | Memory Reserved | Megabytes | Average | The memory that is reserved by tasks in the resource that is specified by the dimension set that you're using. |
| aws_ecs_container_insights_NetworkRxBytes | NetworkRxBytes | Network Rx Bytes | Bytes/Second | Average | The number of bytes received by the resource that is specified by the dimensions that you're using. |
| aws_ecs_container_insights_NetworkTxBytes | NetworkTxBytes | Network Tx Bytes | Bytes/Second | Average | The number of bytes transmitted by the resource that is specified by the dimensions that you're using. |
| aws_ecs_container_insights_RestartCount | RestartCount | Restart Count | Count | Average | The number of times a container in an Amazon ECS task has been restarted. |
| aws_ecs_container_insights_ServiceCount | ServiceCount | Service Count | Count | Average | The number of services in the cluster. |
| aws_ecs_container_insights_StorageReadBytes | StorageReadBytes | Storage Read Bytes | Bytes | Average | The number of bytes read from storage on the instance in the resource that is specified by the dimensions that you're using. |
| aws_ecs_container_insights_StorageWriteBytes | StorageWriteBytes | Storage Write Bytes | Bytes | Average | The number of bytes written to storage in the resource that is specified by the dimensions that you're using. |
| aws_ecs_TaskCount | TaskCount | Task Count | Count | Average | The number of tasks running in the cluster. |
| aws_ecs_container_insights_instance_cpu_limit | instance_cpu_limit | instance cpu limit | None | Average | The maximum number of CPU units that can be assigned to a single EC2 Instance in the cluster. |
| aws_ecs_container_insights_instance_cpu_reserved_capacity | instance_cpu_reserved_capacity | instance cpu reserved capacity | Percent | Average | The percentage of CPU currently being reserved on a single EC2 instance in the cluster. |
| aws_ecs_container_insights_instance_cpu_usage_total | instance_cpu_usage_total | instance cpu usage total | None | Average | The number of CPU units being used on a single EC2 instance in the cluster. |
| aws_ecs_container_insights_instance_cpu_utilization | instance_cpu_utilization | instance cpu utilization | Percent | Average | The total percentage of CPU units being used on a single EC2 instance in the cluster. |
| aws_ecs_container_insights_instance_filesystem_utilization | instance_filesystem_utilization | instance filesystem utilization | Percent | Average | The total percentage of file system capacity being used on a single EC2 instance in the cluster. |
| aws_ecs_container_insights_instance_memory_limit | instance_memory_limit | instance memory limit | Bytes | Average | The maximum amount of memory, in bytes, that can be assigned to a single EC2 Instance in this cluster. |
| aws_ecs_container_insights_instance_memory_reserved_capacity | instance_memory_reserved_capacity | instance memory reserved capacity | Percent | Average | The percentage of Memory currently being reserved on a single EC2 Instance in the cluster. |
| aws_ecs_container_insights_instance_memory_utilization | instance_memory_utilization | instance memory utilization | Percent | Average | The total percentage of memory being used on a single EC2 Instance in the cluster. |
| aws_ecs_container_insights_instance_memory_working_set | instance_memory_working_set | instance memory working set | Bytes | Average | The amount of memory, in bytes, being used on a single EC2 Instance in the cluster. |
| aws_ecs_container_insights_instance_network_total_bytes | instance_network_total_bytes | instance network total bytes | Bytes/Second | Average | The total number of bytes per second transmitted and received over the network on a single EC2 Instance in the cluster. |
| aws_ecs_container_insights_instance_number_of_running_tasks | instance_number_of_running_tasks | instance number of running tasks | Count | Average | The number of running tasks on a single EC2 Instance in the cluster. |
AWS ECS Service Metrics
| OpsRamp Metric | AWS Metric | Metric Display Name | Unit | Aggregation Type | Description |
|---|---|---|---|---|---|
| aws_ecs_CPUUtilization | CPUUtilization | CPU Utilization | Percent | Average | The percentage of CPU units that is used by the cluster or service. |
| aws_ecs_MemoryUtilization | MemoryUtilization | Memory Utilization | Percent | Average | The percentage of memory in use by the cluster or service. |
| aws_ecs_EBSFilesystemUtilization | EBSFilesystemUtilization | EBS Filesystem Utilization | Percent | Average | The percentage of the Amazon EBS filesystem that is used by tasks in a service. |
| aws_ecs_ActiveConnectionCount | ActiveConnectionCount | Active Connection Count | Count | Average | The total number of concurrent connections active from clients to the Amazon ECS Service Connect proxies that run in tasks that share the selected DiscoveryName. |
| aws_ecs_NewConnectionCount | NewConnectionCount | New Connection Count | Count | Average | The total number of new connections established from clients to the Amazon ECS Service Connect proxies that run in tasks that share the selected DiscoveryName. |
| aws_ecs_ProcessedBytes | ProcessedBytes | Processed Bytes | Bytes | Average | The total number of bytes of inbound traffic processed by the Service Connect proxies. |
| aws_ecs_RequestCount | RequestCount | Request Count | Count | Average | The number of inbound traffic requests processed by the Service Connect proxies. |
| aws_ecs_GrpcRequestCount | GrpcRequestCount | Grpc Request Count | Count | Average | The number of gRPC inbound traffic requests processed by the Service Connect proxies. |
| aws_ecs_HTTPCode_Target_2XX_Count | HTTPCode_Target_2XX_Count | HTTP Code Target 2XX Count | Count | Average | The number of HTTP response codes with numbers 200 to 299 generated by the applications in these tasks. |
| aws_ecs_HTTPCode_Target_3XX_Count | HTTPCode_Target_3XX_Count | HTTP Code Target 3XX Count | Count | Average | The number of HTTP response codes with numbers 300 to 399 generated by the applications in these tasks. |
| aws_ecs_HTTPCode_Target_4XX_Count | HTTPCode_Target_4XX_Count | HTTP Code Target 4XX Count | Count | Average | The number of HTTP response codes with numbers 400 to 499 generated by the applications in these tasks. |
| aws_ecs_HTTPCode_Target_5XX_Count | HTTPCode_Target_5XX_Count | HTTP Code Target 5XX Count | Count | Average | The number of HTTP response codes with numbers 500 to 599 generated by the applications in these tasks. |
| aws_ecs_RequestCountPerTarget | RequestCountPerTarget | Request Count Per Target | Count | Average | The average number of requests received by each target that share the selected DiscoveryName. |
| aws_ecs_TargetProcessedBytes | TargetProcessedBytes | Target Processed Bytes | Bytes | Average | The total number of bytes processed by the Service Connect proxies. |
| aws_ecs_TargetResponseTime | TargetResponseTime | Target Response Time | Milliseconds | Average | The latency of the application request processing. The time elapsed, in milliseconds, after the request reached the Service Connect proxy in the target task until a response from the target application is received back to the proxy. |
| aws_ecs_ClientTLSNegotiationErrorCount | ClientTLSNegotiationErrorCount | Client TLS Negotiation Error Count | Count | Average | The total number of times the TLS connection failed. This metric is only used when TLS is enabled. |
| aws_ecs_TargetTLSNegotiationErrorCount | TargetTLSNegotiationErrorCount | Target TLS Negotiation Error Count | Count | Average | The total number of times the TLS connection failed due to missing client certificates, failed AWS Private CA verifications, or failed SAN verifications. This metric is only used when TLS is enabled. |
| aws_ecs_container_insights_CpuUtilized | CpuUtilized | Cpu Utilized | None | Average | The CPU units used by tasks in the resource that is specified by the dimension set that you're using. |
| aws_ecs_container_insights_CpuReserved | CpuReserved | Cpu Reserved | None | Average | The CPU units reserved by tasks in the resource that is specified by the dimension set that you're using. |
| aws_ecs_container_insights_DeploymentCount | DeploymentCount | Deployment Count | Count | Average | The number of deployments in an Amazon ECS service. |
| aws_ecs_DesiredTaskCount | DesiredTaskCount | Desired Task Count | Count | Average | The desired number of tasks for an Amazon ECS service. |
| aws_ecs_container_insights_EBSFilesystemSize | EBSFilesystemSize | EBS Filesystem Size | Gigabytes | Average | The total amount, in gigabytes (GB), of Amazon EBS filesystem storage that is allocated to the resources specified by the dimensions you're using. |
| aws_ecs_container_insights_EBSFilesystemUtilized | EBSFilesystemUtilized | EBS Filesystem Utilized | Gigabytes | Average | The total amount, in gigabytes (GB), of Amazon EBS filesystem storage that is being used by the resources specified by the dimensions that you're using. |
| aws_ecs_container_insights_EphemeralStorageReserved | EphemeralStorageReserved | Ephemeral Storage Reserved | Gigabytes | Average | The number of bytes reserved from ephemeral storage in the resource that is specified by the dimensions that you're using. |
| aws_ecs_container_insights_EphemeralStorageUtilized | EphemeralStorageUtilized | Ephemeral Storage Utilized | Gigabytes | Average | The number of bytes used from ephemeral storage in the resource that is specified by the dimensions that you're using. |
| aws_ecs_container_insights_MemoryUtilized | MemoryUtilized | Memory Utilized | Megabytes | Average | The memory being used by tasks in the resource that is specified by the dimension set that you're using. |
| aws_ecs_container_insights_MemoryReserved | MemoryReserved | Memory Reserved | Megabytes | Average | The memory that is reserved by tasks in the resource that is specified by the dimension set that you're using. |
| aws_ecs_container_insights_NetworkRxBytes | NetworkRxBytes | Network Rx Bytes | Bytes/Second | Average | The number of bytes received by the resource that is specified by the dimensions that you're using. |
| aws_ecs_container_insights_NetworkTxBytes | NetworkTxBytes | Network Tx Bytes | Bytes/Second | Average | The number of bytes transmitted by the resource that is specified by the dimensions that you're using. |
| aws_ecs_PendingTaskCount | PendingTaskCount | Pending Task Count | Count | Average | The number of tasks currently in the PENDING state. |
| aws_ecs_RunningTaskCount | RunningTaskCount | Running Task Count | Count | Average | The number of tasks currently in the RUNNING state. |
| aws_ecs_container_insights_RestartCount | RestartCount | Restart Count | Count | Average | The number of times a container in an Amazon ECS task has been restarted. |
| aws_ecs_container_insights_StorageReadBytes | StorageReadBytes | Storage Read Bytes | Bytes | Average | The number of bytes read from storage on the instance in the resource that is specified by the dimensions that you're using. |
| aws_ecs_container_insights_StorageWriteBytes | StorageWriteBytes | Storage Write Bytes | Bytes | Average | The number of bytes written to storage in the resource that is specified by the dimensions that you're using. |
| aws_ecs_container_insights_TaskSetCount | TaskSetCount | Task Set Count | Count | Average | The number of task sets in the service. |