UtilizationMetric
Describes a utilization metric of a resource, such as an Amazon EC2 instance.
Compare the utilization metric data of your resource against its projected utilization metric data to determine the performance difference between your current resource and the recommended option.
Contents
- name
-
The name of the utilization metric.
The following utilization metrics are available:
-
Cpu
- The percentage of allocated EC2 compute units that are currently in use on the instance. This metric identifies the processing power required to run an application on the instance.Depending on the instance type, tools in your operating system can show a lower percentage than CloudWatch when the instance is not allocated a full processor core.
Units: Percent
-
Memory
- The percentage of memory that is currently in use on the instance. This metric identifies the amount of memory required to run an application on the instance.Units: Percent
Note The
Memory
metric is returned only for resources that have the unified CloudWatch agent installed on them. For more information, see Enabling Memory Utilization with the CloudWatch Agent. -
EBS_READ_OPS_PER_SECOND
- The completed read operations from all EBS volumes attached to the instance in a specified period of time.Unit: Count
-
EBS_WRITE_OPS_PER_SECOND
- The completed write operations to all EBS volumes attached to the instance in a specified period of time.Unit: Count
-
EBS_READ_BYTES_PER_SECOND
- The bytes read from all EBS volumes attached to the instance in a specified period of time.Unit: Bytes
-
EBS_WRITE_BYTES_PER_SECOND
- The bytes written to all EBS volumes attached to the instance in a specified period of time.Unit: Bytes
Type: String
Valid Values:
Cpu | Memory | EBS_READ_OPS_PER_SECOND | EBS_WRITE_OPS_PER_SECOND | EBS_READ_BYTES_PER_SECOND | EBS_WRITE_BYTES_PER_SECOND
Required: No
-
- statistic
-
The statistic of the utilization metric.
The following statistics are available:
-
Average
- This is the value of Sum / SampleCount during the specified period, or the average value observed during the specified period. -
Maximum
- The highest value observed during the specified period. Use this value to determine high volumes of activity for your application.
Type: String
Valid Values:
Maximum | Average
Required: No
-
- value
-
The value of the utilization metric.
Type: Double
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: