software.amazon.awssdk.services.computeoptimizer.model.UtilizationMetric Maven / Gradle / Ivy
Show all versions of computeoptimizer Show documentation
/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package software.amazon.awssdk.services.computeoptimizer.model;
import java.io.Serializable;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;
import java.util.Objects;
import java.util.Optional;
import java.util.function.BiConsumer;
import java.util.function.Function;
import software.amazon.awssdk.annotations.Generated;
import software.amazon.awssdk.core.SdkField;
import software.amazon.awssdk.core.SdkPojo;
import software.amazon.awssdk.core.protocol.MarshallLocation;
import software.amazon.awssdk.core.protocol.MarshallingType;
import software.amazon.awssdk.core.traits.LocationTrait;
import software.amazon.awssdk.utils.ToString;
import software.amazon.awssdk.utils.builder.CopyableBuilder;
import software.amazon.awssdk.utils.builder.ToCopyableBuilder;
/**
*
* 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.
*
*/
@Generated("software.amazon.awssdk:codegen")
public final class UtilizationMetric implements SdkPojo, Serializable,
ToCopyableBuilder {
private static final SdkField NAME_FIELD = SdkField. builder(MarshallingType.STRING).memberName("name")
.getter(getter(UtilizationMetric::nameAsString)).setter(setter(Builder::name))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("name").build()).build();
private static final SdkField STATISTIC_FIELD = SdkField. builder(MarshallingType.STRING)
.memberName("statistic").getter(getter(UtilizationMetric::statisticAsString)).setter(setter(Builder::statistic))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("statistic").build()).build();
private static final SdkField VALUE_FIELD = SdkField. builder(MarshallingType.DOUBLE).memberName("value")
.getter(getter(UtilizationMetric::value)).setter(setter(Builder::value))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("value").build()).build();
private static final List> SDK_FIELDS = Collections.unmodifiableList(Arrays.asList(NAME_FIELD, STATISTIC_FIELD,
VALUE_FIELD));
private static final long serialVersionUID = 1L;
private final String name;
private final String statistic;
private final Double value;
private UtilizationMetric(BuilderImpl builder) {
this.name = builder.name;
this.statistic = builder.statistic;
this.value = builder.value;
}
/**
*
* 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
*
*
*
* 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.
*
*
* -
*
* GPU - The percentage of allocated GPUs that currently run on the instance.
*
*
* -
*
* GPU_MEMORY - The percentage of total GPU memory that currently runs on the instance.
*
*
*
* The GPU and GPU_MEMORY metrics are only returned for resources with the unified
* CloudWatch Agent installed on them. For more information, see Enabling NVIDIA GPU
* 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
*
*
* -
*
* DISK_READ_OPS_PER_SECOND - The completed read operations from all instance store volumes available
* to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_WRITE_OPS_PER_SECOND - The completed write operations from all instance store volumes available
* to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_READ_BYTES_PER_SECOND - The bytes read from all instance store volumes available to the
* instance. This metric is used to determine the volume of the data the application reads from the disk of the
* instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_WRITE_BYTES_PER_SECOND - The bytes written to all instance store volumes available to the
* instance. This metric is used to determine the volume of the data the application writes onto the disk of the
* instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* NETWORK_IN_BYTES_PER_SECOND - The number of bytes received by the instance on all network
* interfaces. This metric identifies the volume of incoming network traffic to a single instance.
*
*
* -
*
* NETWORK_OUT_BYTES_PER_SECOND - The number of bytes sent out by the instance on all network
* interfaces. This metric identifies the volume of outgoing network traffic from a single instance.
*
*
* -
*
* NETWORK_PACKETS_IN_PER_SECOND - The number of packets received by the instance on all network
* interfaces. This metric identifies the volume of incoming traffic in terms of the number of packets on a single
* instance.
*
*
* -
*
* NETWORK_PACKETS_OUT_PER_SECOND - The number of packets sent out by the instance on all network
* interfaces. This metric identifies the volume of outgoing traffic in terms of the number of packets on a single
* instance.
*
*
*
*
* If the service returns an enum value that is not available in the current SDK version, {@link #name} will return
* {@link MetricName#UNKNOWN_TO_SDK_VERSION}. The raw value returned by the service is available from
* {@link #nameAsString}.
*
*
* @return 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
*
*
*
* 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.
*
*
* -
*
* GPU - The percentage of allocated GPUs that currently run on the instance.
*
*
* -
*
* GPU_MEMORY - The percentage of total GPU memory that currently runs on the instance.
*
*
*
* The GPU and GPU_MEMORY metrics are only returned for resources with the unified
* CloudWatch Agent installed on them. For more information, see Enabling
* NVIDIA GPU 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
*
*
* -
*
* DISK_READ_OPS_PER_SECOND - The completed read operations from all instance store volumes
* available to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_WRITE_OPS_PER_SECOND - The completed write operations from all instance store volumes
* available to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_READ_BYTES_PER_SECOND - The bytes read from all instance store volumes available to the
* instance. This metric is used to determine the volume of the data the application reads from the disk of
* the instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_WRITE_BYTES_PER_SECOND - The bytes written to all instance store volumes available to
* the instance. This metric is used to determine the volume of the data the application writes onto the
* disk of the instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* NETWORK_IN_BYTES_PER_SECOND - The number of bytes received by the instance on all network
* interfaces. This metric identifies the volume of incoming network traffic to a single instance.
*
*
* -
*
* NETWORK_OUT_BYTES_PER_SECOND - The number of bytes sent out by the instance on all network
* interfaces. This metric identifies the volume of outgoing network traffic from a single instance.
*
*
* -
*
* NETWORK_PACKETS_IN_PER_SECOND - The number of packets received by the instance on all
* network interfaces. This metric identifies the volume of incoming traffic in terms of the number of
* packets on a single instance.
*
*
* -
*
* NETWORK_PACKETS_OUT_PER_SECOND - The number of packets sent out by the instance on all
* network interfaces. This metric identifies the volume of outgoing traffic in terms of the number of
* packets on a single instance.
*
*
* @see MetricName
*/
public final MetricName name() {
return MetricName.fromValue(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
*
*
*
* 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.
*
*
* -
*
* GPU - The percentage of allocated GPUs that currently run on the instance.
*
*
* -
*
* GPU_MEMORY - The percentage of total GPU memory that currently runs on the instance.
*
*
*
* The GPU and GPU_MEMORY metrics are only returned for resources with the unified
* CloudWatch Agent installed on them. For more information, see Enabling NVIDIA GPU
* 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
*
*
* -
*
* DISK_READ_OPS_PER_SECOND - The completed read operations from all instance store volumes available
* to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_WRITE_OPS_PER_SECOND - The completed write operations from all instance store volumes available
* to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_READ_BYTES_PER_SECOND - The bytes read from all instance store volumes available to the
* instance. This metric is used to determine the volume of the data the application reads from the disk of the
* instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_WRITE_BYTES_PER_SECOND - The bytes written to all instance store volumes available to the
* instance. This metric is used to determine the volume of the data the application writes onto the disk of the
* instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* NETWORK_IN_BYTES_PER_SECOND - The number of bytes received by the instance on all network
* interfaces. This metric identifies the volume of incoming network traffic to a single instance.
*
*
* -
*
* NETWORK_OUT_BYTES_PER_SECOND - The number of bytes sent out by the instance on all network
* interfaces. This metric identifies the volume of outgoing network traffic from a single instance.
*
*
* -
*
* NETWORK_PACKETS_IN_PER_SECOND - The number of packets received by the instance on all network
* interfaces. This metric identifies the volume of incoming traffic in terms of the number of packets on a single
* instance.
*
*
* -
*
* NETWORK_PACKETS_OUT_PER_SECOND - The number of packets sent out by the instance on all network
* interfaces. This metric identifies the volume of outgoing traffic in terms of the number of packets on a single
* instance.
*
*
*
*
* If the service returns an enum value that is not available in the current SDK version, {@link #name} will return
* {@link MetricName#UNKNOWN_TO_SDK_VERSION}. The raw value returned by the service is available from
* {@link #nameAsString}.
*
*
* @return 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
*
*
*
* 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.
*
*
* -
*
* GPU - The percentage of allocated GPUs that currently run on the instance.
*
*
* -
*
* GPU_MEMORY - The percentage of total GPU memory that currently runs on the instance.
*
*
*
* The GPU and GPU_MEMORY metrics are only returned for resources with the unified
* CloudWatch Agent installed on them. For more information, see Enabling
* NVIDIA GPU 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
*
*
* -
*
* DISK_READ_OPS_PER_SECOND - The completed read operations from all instance store volumes
* available to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_WRITE_OPS_PER_SECOND - The completed write operations from all instance store volumes
* available to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_READ_BYTES_PER_SECOND - The bytes read from all instance store volumes available to the
* instance. This metric is used to determine the volume of the data the application reads from the disk of
* the instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_WRITE_BYTES_PER_SECOND - The bytes written to all instance store volumes available to
* the instance. This metric is used to determine the volume of the data the application writes onto the
* disk of the instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* NETWORK_IN_BYTES_PER_SECOND - The number of bytes received by the instance on all network
* interfaces. This metric identifies the volume of incoming network traffic to a single instance.
*
*
* -
*
* NETWORK_OUT_BYTES_PER_SECOND - The number of bytes sent out by the instance on all network
* interfaces. This metric identifies the volume of outgoing network traffic from a single instance.
*
*
* -
*
* NETWORK_PACKETS_IN_PER_SECOND - The number of packets received by the instance on all
* network interfaces. This metric identifies the volume of incoming traffic in terms of the number of
* packets on a single instance.
*
*
* -
*
* NETWORK_PACKETS_OUT_PER_SECOND - The number of packets sent out by the instance on all
* network interfaces. This metric identifies the volume of outgoing traffic in terms of the number of
* packets on a single instance.
*
*
* @see MetricName
*/
public final String nameAsString() {
return name;
}
/**
*
* The statistic of the utilization metric.
*
*
* The Compute Optimizer API, Command Line Interface (CLI), and SDKs return utilization metrics using only the
* Maximum statistic, which is the highest value observed during the specified period.
*
*
* The Compute Optimizer console displays graphs for some utilization metrics using the Average
* statistic, which is the value of Sum / SampleCount during the specified period. For
* more information, see Viewing resource
* recommendations in the Compute Optimizer User Guide. You can also get averaged utilization metric data
* for your resources using Amazon CloudWatch. For more information, see the Amazon CloudWatch
* User Guide.
*
*
* If the service returns an enum value that is not available in the current SDK version, {@link #statistic} will
* return {@link MetricStatistic#UNKNOWN_TO_SDK_VERSION}. The raw value returned by the service is available from
* {@link #statisticAsString}.
*
*
* @return The statistic of the utilization metric.
*
* The Compute Optimizer API, Command Line Interface (CLI), and SDKs return utilization metrics using only
* the Maximum statistic, which is the highest value observed during the specified period.
*
*
* The Compute Optimizer console displays graphs for some utilization metrics using the Average
* statistic, which is the value of Sum / SampleCount during the specified period.
* For more information, see Viewing
* resource recommendations in the Compute Optimizer User Guide. You can also get averaged
* utilization metric data for your resources using Amazon CloudWatch. For more information, see the Amazon
* CloudWatch User Guide.
* @see MetricStatistic
*/
public final MetricStatistic statistic() {
return MetricStatistic.fromValue(statistic);
}
/**
*
* The statistic of the utilization metric.
*
*
* The Compute Optimizer API, Command Line Interface (CLI), and SDKs return utilization metrics using only the
* Maximum statistic, which is the highest value observed during the specified period.
*
*
* The Compute Optimizer console displays graphs for some utilization metrics using the Average
* statistic, which is the value of Sum / SampleCount during the specified period. For
* more information, see Viewing resource
* recommendations in the Compute Optimizer User Guide. You can also get averaged utilization metric data
* for your resources using Amazon CloudWatch. For more information, see the Amazon CloudWatch
* User Guide.
*
*
* If the service returns an enum value that is not available in the current SDK version, {@link #statistic} will
* return {@link MetricStatistic#UNKNOWN_TO_SDK_VERSION}. The raw value returned by the service is available from
* {@link #statisticAsString}.
*
*
* @return The statistic of the utilization metric.
*
* The Compute Optimizer API, Command Line Interface (CLI), and SDKs return utilization metrics using only
* the Maximum statistic, which is the highest value observed during the specified period.
*
*
* The Compute Optimizer console displays graphs for some utilization metrics using the Average
* statistic, which is the value of Sum / SampleCount during the specified period.
* For more information, see Viewing
* resource recommendations in the Compute Optimizer User Guide. You can also get averaged
* utilization metric data for your resources using Amazon CloudWatch. For more information, see the Amazon
* CloudWatch User Guide.
* @see MetricStatistic
*/
public final String statisticAsString() {
return statistic;
}
/**
*
* The value of the utilization metric.
*
*
* @return The value of the utilization metric.
*/
public final Double value() {
return value;
}
@Override
public Builder toBuilder() {
return new BuilderImpl(this);
}
public static Builder builder() {
return new BuilderImpl();
}
public static Class serializableBuilderClass() {
return BuilderImpl.class;
}
@Override
public final int hashCode() {
int hashCode = 1;
hashCode = 31 * hashCode + Objects.hashCode(nameAsString());
hashCode = 31 * hashCode + Objects.hashCode(statisticAsString());
hashCode = 31 * hashCode + Objects.hashCode(value());
return hashCode;
}
@Override
public final boolean equals(Object obj) {
return equalsBySdkFields(obj);
}
@Override
public final boolean equalsBySdkFields(Object obj) {
if (this == obj) {
return true;
}
if (obj == null) {
return false;
}
if (!(obj instanceof UtilizationMetric)) {
return false;
}
UtilizationMetric other = (UtilizationMetric) obj;
return Objects.equals(nameAsString(), other.nameAsString())
&& Objects.equals(statisticAsString(), other.statisticAsString()) && Objects.equals(value(), other.value());
}
/**
* Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be
* redacted from this string using a placeholder value.
*/
@Override
public final String toString() {
return ToString.builder("UtilizationMetric").add("Name", nameAsString()).add("Statistic", statisticAsString())
.add("Value", value()).build();
}
public final Optional getValueForField(String fieldName, Class clazz) {
switch (fieldName) {
case "name":
return Optional.ofNullable(clazz.cast(nameAsString()));
case "statistic":
return Optional.ofNullable(clazz.cast(statisticAsString()));
case "value":
return Optional.ofNullable(clazz.cast(value()));
default:
return Optional.empty();
}
}
@Override
public final List> sdkFields() {
return SDK_FIELDS;
}
private static Function getter(Function g) {
return obj -> g.apply((UtilizationMetric) obj);
}
private static BiConsumer setter(BiConsumer s) {
return (obj, val) -> s.accept((Builder) obj, val);
}
public interface Builder extends SdkPojo, CopyableBuilder {
/**
*
* 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
*
*
*
* 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.
*
*
* -
*
* GPU - The percentage of allocated GPUs that currently run on the instance.
*
*
* -
*
* GPU_MEMORY - The percentage of total GPU memory that currently runs on the instance.
*
*
*
* The GPU and GPU_MEMORY metrics are only returned for resources with the unified
* CloudWatch Agent installed on them. For more information, see Enabling NVIDIA
* GPU 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
*
*
* -
*
* DISK_READ_OPS_PER_SECOND - The completed read operations from all instance store volumes
* available to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_WRITE_OPS_PER_SECOND - The completed write operations from all instance store volumes
* available to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_READ_BYTES_PER_SECOND - The bytes read from all instance store volumes available to the
* instance. This metric is used to determine the volume of the data the application reads from the disk of the
* instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_WRITE_BYTES_PER_SECOND - The bytes written to all instance store volumes available to the
* instance. This metric is used to determine the volume of the data the application writes onto the disk of the
* instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* NETWORK_IN_BYTES_PER_SECOND - The number of bytes received by the instance on all network
* interfaces. This metric identifies the volume of incoming network traffic to a single instance.
*
*
* -
*
* NETWORK_OUT_BYTES_PER_SECOND - The number of bytes sent out by the instance on all network
* interfaces. This metric identifies the volume of outgoing network traffic from a single instance.
*
*
* -
*
* NETWORK_PACKETS_IN_PER_SECOND - The number of packets received by the instance on all network
* interfaces. This metric identifies the volume of incoming traffic in terms of the number of packets on a
* single instance.
*
*
* -
*
* NETWORK_PACKETS_OUT_PER_SECOND - The number of packets sent out by the instance on all network
* interfaces. This metric identifies the volume of outgoing traffic in terms of the number of packets on a
* single instance.
*
*
*
*
* @param 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
*
*
*
* 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.
*
*
* -
*
* GPU - The percentage of allocated GPUs that currently run on the instance.
*
*
* -
*
* GPU_MEMORY - The percentage of total GPU memory that currently runs on the instance.
*
*
*
* The GPU and GPU_MEMORY metrics are only returned for resources with the
* unified CloudWatch Agent installed on them. For more information, see Enabling
* NVIDIA GPU 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
*
*
* -
*
* DISK_READ_OPS_PER_SECOND - The completed read operations from all instance store volumes
* available to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not
* reported.
*
*
* -
*
* DISK_WRITE_OPS_PER_SECOND - The completed write operations from all instance store
* volumes available to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not
* reported.
*
*
* -
*
* DISK_READ_BYTES_PER_SECOND - The bytes read from all instance store volumes available to
* the instance. This metric is used to determine the volume of the data the application reads from the
* disk of the instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not
* reported.
*
*
* -
*
* DISK_WRITE_BYTES_PER_SECOND - The bytes written to all instance store volumes available
* to the instance. This metric is used to determine the volume of the data the application writes onto
* the disk of the instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not
* reported.
*
*
* -
*
* NETWORK_IN_BYTES_PER_SECOND - The number of bytes received by the instance on all network
* interfaces. This metric identifies the volume of incoming network traffic to a single instance.
*
*
* -
*
* NETWORK_OUT_BYTES_PER_SECOND - The number of bytes sent out by the instance on all
* network interfaces. This metric identifies the volume of outgoing network traffic from a single
* instance.
*
*
* -
*
* NETWORK_PACKETS_IN_PER_SECOND - The number of packets received by the instance on all
* network interfaces. This metric identifies the volume of incoming traffic in terms of the number of
* packets on a single instance.
*
*
* -
*
* NETWORK_PACKETS_OUT_PER_SECOND - The number of packets sent out by the instance on all
* network interfaces. This metric identifies the volume of outgoing traffic in terms of the number of
* packets on a single instance.
*
*
* @see MetricName
* @return Returns a reference to this object so that method calls can be chained together.
* @see MetricName
*/
Builder name(String 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
*
*
*
* 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.
*
*
* -
*
* GPU - The percentage of allocated GPUs that currently run on the instance.
*
*
* -
*
* GPU_MEMORY - The percentage of total GPU memory that currently runs on the instance.
*
*
*
* The GPU and GPU_MEMORY metrics are only returned for resources with the unified
* CloudWatch Agent installed on them. For more information, see Enabling NVIDIA
* GPU 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
*
*
* -
*
* DISK_READ_OPS_PER_SECOND - The completed read operations from all instance store volumes
* available to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_WRITE_OPS_PER_SECOND - The completed write operations from all instance store volumes
* available to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_READ_BYTES_PER_SECOND - The bytes read from all instance store volumes available to the
* instance. This metric is used to determine the volume of the data the application reads from the disk of the
* instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* DISK_WRITE_BYTES_PER_SECOND - The bytes written to all instance store volumes available to the
* instance. This metric is used to determine the volume of the data the application writes onto the disk of the
* instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not reported.
*
*
* -
*
* NETWORK_IN_BYTES_PER_SECOND - The number of bytes received by the instance on all network
* interfaces. This metric identifies the volume of incoming network traffic to a single instance.
*
*
* -
*
* NETWORK_OUT_BYTES_PER_SECOND - The number of bytes sent out by the instance on all network
* interfaces. This metric identifies the volume of outgoing network traffic from a single instance.
*
*
* -
*
* NETWORK_PACKETS_IN_PER_SECOND - The number of packets received by the instance on all network
* interfaces. This metric identifies the volume of incoming traffic in terms of the number of packets on a
* single instance.
*
*
* -
*
* NETWORK_PACKETS_OUT_PER_SECOND - The number of packets sent out by the instance on all network
* interfaces. This metric identifies the volume of outgoing traffic in terms of the number of packets on a
* single instance.
*
*
*
*
* @param 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
*
*
*
* 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.
*
*
* -
*
* GPU - The percentage of allocated GPUs that currently run on the instance.
*
*
* -
*
* GPU_MEMORY - The percentage of total GPU memory that currently runs on the instance.
*
*
*
* The GPU and GPU_MEMORY metrics are only returned for resources with the
* unified CloudWatch Agent installed on them. For more information, see Enabling
* NVIDIA GPU 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
*
*
* -
*
* DISK_READ_OPS_PER_SECOND - The completed read operations from all instance store volumes
* available to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not
* reported.
*
*
* -
*
* DISK_WRITE_OPS_PER_SECOND - The completed write operations from all instance store
* volumes available to the instance in a specified period of time.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not
* reported.
*
*
* -
*
* DISK_READ_BYTES_PER_SECOND - The bytes read from all instance store volumes available to
* the instance. This metric is used to determine the volume of the data the application reads from the
* disk of the instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not
* reported.
*
*
* -
*
* DISK_WRITE_BYTES_PER_SECOND - The bytes written to all instance store volumes available
* to the instance. This metric is used to determine the volume of the data the application writes onto
* the disk of the instance. This can be used to determine the speed of the application.
*
*
* If there are no instance store volumes, either the value is 0 or the metric is not
* reported.
*
*
* -
*
* NETWORK_IN_BYTES_PER_SECOND - The number of bytes received by the instance on all network
* interfaces. This metric identifies the volume of incoming network traffic to a single instance.
*
*
* -
*
* NETWORK_OUT_BYTES_PER_SECOND - The number of bytes sent out by the instance on all
* network interfaces. This metric identifies the volume of outgoing network traffic from a single
* instance.
*
*
* -
*
* NETWORK_PACKETS_IN_PER_SECOND - The number of packets received by the instance on all
* network interfaces. This metric identifies the volume of incoming traffic in terms of the number of
* packets on a single instance.
*
*
* -
*
* NETWORK_PACKETS_OUT_PER_SECOND - The number of packets sent out by the instance on all
* network interfaces. This metric identifies the volume of outgoing traffic in terms of the number of
* packets on a single instance.
*
*
* @see MetricName
* @return Returns a reference to this object so that method calls can be chained together.
* @see MetricName
*/
Builder name(MetricName name);
/**
*
* The statistic of the utilization metric.
*
*
* The Compute Optimizer API, Command Line Interface (CLI), and SDKs return utilization metrics using only the
* Maximum statistic, which is the highest value observed during the specified period.
*
*
* The Compute Optimizer console displays graphs for some utilization metrics using the Average
* statistic, which is the value of Sum / SampleCount during the specified period. For
* more information, see Viewing resource
* recommendations in the Compute Optimizer User Guide. You can also get averaged utilization metric
* data for your resources using Amazon CloudWatch. For more information, see the Amazon CloudWatch
* User Guide.
*
*
* @param statistic
* The statistic of the utilization metric.
*
* The Compute Optimizer API, Command Line Interface (CLI), and SDKs return utilization metrics using
* only the Maximum statistic, which is the highest value observed during the specified
* period.
*
*
* The Compute Optimizer console displays graphs for some utilization metrics using the
* Average statistic, which is the value of Sum / SampleCount
* during the specified period. For more information, see Viewing
* resource recommendations in the Compute Optimizer User Guide. You can also get averaged
* utilization metric data for your resources using Amazon CloudWatch. For more information, see the Amazon
* CloudWatch User Guide.
* @see MetricStatistic
* @return Returns a reference to this object so that method calls can be chained together.
* @see MetricStatistic
*/
Builder statistic(String statistic);
/**
*
* The statistic of the utilization metric.
*
*
* The Compute Optimizer API, Command Line Interface (CLI), and SDKs return utilization metrics using only the
* Maximum statistic, which is the highest value observed during the specified period.
*
*
* The Compute Optimizer console displays graphs for some utilization metrics using the Average
* statistic, which is the value of Sum / SampleCount during the specified period. For
* more information, see Viewing resource
* recommendations in the Compute Optimizer User Guide. You can also get averaged utilization metric
* data for your resources using Amazon CloudWatch. For more information, see the Amazon CloudWatch
* User Guide.
*
*
* @param statistic
* The statistic of the utilization metric.
*
* The Compute Optimizer API, Command Line Interface (CLI), and SDKs return utilization metrics using
* only the Maximum statistic, which is the highest value observed during the specified
* period.
*
*
* The Compute Optimizer console displays graphs for some utilization metrics using the
* Average statistic, which is the value of Sum / SampleCount
* during the specified period. For more information, see Viewing
* resource recommendations in the Compute Optimizer User Guide. You can also get averaged
* utilization metric data for your resources using Amazon CloudWatch. For more information, see the Amazon
* CloudWatch User Guide.
* @see MetricStatistic
* @return Returns a reference to this object so that method calls can be chained together.
* @see MetricStatistic
*/
Builder statistic(MetricStatistic statistic);
/**
*
* The value of the utilization metric.
*
*
* @param value
* The value of the utilization metric.
* @return Returns a reference to this object so that method calls can be chained together.
*/
Builder value(Double value);
}
static final class BuilderImpl implements Builder {
private String name;
private String statistic;
private Double value;
private BuilderImpl() {
}
private BuilderImpl(UtilizationMetric model) {
name(model.name);
statistic(model.statistic);
value(model.value);
}
public final String getName() {
return name;
}
public final void setName(String name) {
this.name = name;
}
@Override
public final Builder name(String name) {
this.name = name;
return this;
}
@Override
public final Builder name(MetricName name) {
this.name(name == null ? null : name.toString());
return this;
}
public final String getStatistic() {
return statistic;
}
public final void setStatistic(String statistic) {
this.statistic = statistic;
}
@Override
public final Builder statistic(String statistic) {
this.statistic = statistic;
return this;
}
@Override
public final Builder statistic(MetricStatistic statistic) {
this.statistic(statistic == null ? null : statistic.toString());
return this;
}
public final Double getValue() {
return value;
}
public final void setValue(Double value) {
this.value = value;
}
@Override
public final Builder value(Double value) {
this.value = value;
return this;
}
@Override
public UtilizationMetric build() {
return new UtilizationMetric(this);
}
@Override
public List> sdkFields() {
return SDK_FIELDS;
}
}
}