1. Docs
  2. @pulumi/awsx
  3. classic
  4. ebs

Module classic/ebs

    APIs

    APIs

    namespace metrics

    function burstBalance

    burstBalance(change?: EbsMetricChange): Metric

    Used with General Purpose SSD (gp2), Throughput Optimized HDD (st1), and Cold HDD (sc1) volumes only. Provides information about the percentage of I/O credits (for gp2) or throughput credits (for st1 and sc1) remaining in the burst bucket. Data is reported to CloudWatch only when the volume is active. If the volume is not attached, no data is reported.

    The Sum statistic on this metric is not relevant for volumes attached to Nitro-based instances.

    For a volume 1 TiB or larger, baseline performance is higher than maximum burst performance, so I/O credits are never spent. If the volume is attached to a Nitro-based instance, the burst balance is not reported. For a non-Nitro-based instance, the reported burst balance is 100%.

    Units: Percent

    interface EbsMetricChange

    interface EbsMetricChange extends MetricChange

    property color

    color?: pulumi.Input<string>;

    The six-digit HTML hex color code to be used for this metric.

    Only used if this metric is displayed in a [Dashboard] with a [MetricWidget].

    property dimensions

    dimensions?: pulumi.Input<Record<string, pulumi.Input<string>>>;

    The new dimension for this metric. If this object is missing this property, then no change will be made. However, if the property is there by set to [undefined] then the value will be cleared.

    property extendedStatistic

    extendedStatistic?: pulumi.Input<number>;

    The new percentile statistic for the metric associated with the alarm. If this object is missing this property, then no change will be made. However, if the property is there by set to [undefined] then the value will be set to the default.

    property label

    label?: pulumi.Input<string>;

    The label to display for this metric in the graph legend. If this is not specified, the metric is given an autogenerated label that distinguishes it from the other metrics in the widget.

    Only used if this metric is displayed in a [Dashboard] with a [MetricWidget].

    property period

    period?: pulumi.Input<number>;

    The new period in seconds over which the specified stat is applied. If this object is missing this property, then no change will be made. However, if the property is there by set to [undefined] then the value will be set to the default (300s).

    property statistic

    statistic?: pulumi.Input<MetricStatistic>;

    The new statistic to apply to the alarm’s associated metric. If this object is missing this property, then no change will be made. However, if the property is there by set to [undefined] then the value will be set to the default.

    property unit

    unit?: pulumi.Input<MetricUnit>;

    The new unit for this metric. If this object is missing this property, then no change will be made. However, if the property is there by set to [undefined] then the value will be set to the default.

    property visible

    visible?: pulumi.Input<boolean>;

    Set this to true to have the metric appear in the graph, or false to have it be hidden. The default is true.

    Only used if this metric is displayed in a [Dashboard] with a [MetricWidget].

    property volume

    volume?: aws.ebs.Volume;

    The only dimension that Amazon EBS sends to CloudWatch is the volume ID. This means that all available statistics are filtered by volume ID.

    property yAxis

    yAxis?: pulumi.Input<"left" | "right">;

    Where on the graph to display the y-axis for this metric. The default is left.

    Only used if this metric is displayed in a [Dashboard] with a [MetricWidget].

    type EbsMetricName

    type EbsMetricName = "VolumeReadBytes" | "VolumeWriteBytes" | "VolumeReadOps" | "VolumeWriteOps" | "VolumeTotalReadTime" | "VolumeTotalWriteTime" | "VolumeIdleTime" | "VolumeQueueLength" | "VolumeThroughputPercentage" | "VolumeConsumedReadWriteOps" | "BurstBalance";

    function metric

    metric(metricName: EbsMetricName, change: EbsMetricChange): Metric

    Creates an AWS/EBS metric with the requested [metricName]. See https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-volume-status.html for list of all metric-names.

    Note, individual metrics can easily be obtained without supplying the name using the other [metricXXX] functions.

    Amazon Web Services (AWS) automatically provides data, such as Amazon CloudWatch metrics and volume status checks, that you can use to monitor your Amazon Elastic Block Store (Amazon EBS) volumes.

    CloudWatch metrics are statistical data that you can use to view, analyze, and set alarms on the operational behavior of your volumes.

    The following table describes the types of monitoring data available for your Amazon EBS volumes.

    • Basic: Data is available automatically in 5-minute periods at no charge. This includes data for the root device volumes for EBS-backed instances.

    • Detailed: Provisioned IOPS SSD (io1) volumes automatically send one-minute metrics to CloudWatch.

    When you get data from CloudWatch, you can include a Period request parameter to specify the granularity of the returned data. This is different than the period that we use when we collect the data (5-minute periods). We recommend that you specify a period in your request that is equal to or larger than the collection period to ensure that the returned data is valid.

    You can get the data using either the CloudWatch API or the Amazon EC2 console. The console takes the raw data from the CloudWatch API and displays a series of graphs based on the data. Depending on your needs, you might prefer to use either the data from the API or the graphs in the console. Amazon EBS Metrics

    Amazon Elastic Block Store (Amazon EBS) sends data points to CloudWatch for several metrics. Amazon EBS General Purpose SSD (gp2), Throughput Optimized HDD (st1) , Cold HDD (sc1), and Magnetic (standard) volumes automatically send five-minute metrics to CloudWatch. Provisioned IOPS SSD (io1) volumes automatically send one-minute metrics to CloudWatch. Data is only reported to CloudWatch when the volume is attached to an instance.

    Some of these metrics have differences on Nitro-based instances. For a list of instance types based on the Nitro system, see Nitro-based-Instances.

    The only dimension that Amazon EBS sends to CloudWatch is the volume ID. This means that all available statistics are filtered by volume ID.

    function volumeConsumedReadWriteOps

    volumeConsumedReadWriteOps(change?: EbsMetricChange): Metric

    Used with Provisioned IOPS SSD volumes only. The total amount of read and write operations (normalized to 256K capacity units) consumed in a specified period of time.

    I/O operations that are smaller than 256K each count as 1 consumed IOPS. I/O operations that are larger than 256K are counted in 256K capacity units. For example, a 1024K I/O would count as 4 consumed IOPS.

    Units: Count

    function volumeIdleTime

    volumeIdleTime(change?: EbsMetricChange): Metric

    The total number of seconds in a specified period of time when no read or write operations were submitted.

    The Average statistic on this metric is not relevant for volumes attached to Nitro-based instances.

    The Minimum and Maximum statistics on this metric are supported only by volumes attached to Nitro-based instances.

    Units: Seconds

    function volumeQueueLength

    volumeQueueLength(change?: EbsMetricChange): Metric

    The number of read and write operation requests waiting to be completed in a specified period of time.

    The Sum statistic on this metric is not relevant for volumes attached to Nitro-based instances.

    The Minimum and Maximum statistics on this metric are supported only by volumes attached to Nitro-based instances.

    Units: Count

    function volumeReadBytes

    volumeReadBytes(change?: EbsMetricChange): Metric

    Provides information on the read operations in a specified period of time. The Sum statistic reports the total number of bytes transferred during the period. The Average statistic reports the average size of each read operation during the period, except on volumes attached to a Nitro-based instance, where the average represents the average over the specified period. The SampleCount statistic reports the total number of read operations during the period, except on volumes attached to a Nitro-based instance, where the sample count represents the number of data points used in the statistical calculation. For Xen instances, data is reported only when there is read activity on the volume.

    The Minimum and Maximum statistics on this metric are supported only by volumes attached to Nitro-based instances.

    Units: Bytes

    function volumeReadOps

    volumeReadOps(change?: EbsMetricChange): Metric

    The total number of read operations in a specified period of time.

    To calculate the average read operations per second (read IOPS) for the period, divide the total read operations in the period by the number of seconds in that period.

    The Minimum and Maximum statistics on this metric are supported only by volumes attached to Nitro-based instances.

    Units: Count

    function volumeThroughputPercentage

    volumeThroughputPercentage(change?: EbsMetricChange): Metric

    Used with Provisioned IOPS SSD volumes only. The percentage of I/O operations per second (IOPS) delivered of the total IOPS provisioned for an Amazon EBS volume. Provisioned IOPS SSD volumes deliver within 10 percent of the provisioned IOPS performance 99.9 percent of the time over a given year.

    During a write, if there are no other pending I/O requests in a minute, the metric value will be 100 percent. Also, a volume’s I/O performance may become degraded temporarily due to an action you have taken (for example, creating a snapshot of a volume during peak usage, running the volume on a non-EBS-optimized instance, or accessing data on the volume for the first time).

    Units: Percent

    function volumeTotalReadTime

    volumeTotalReadTime(change?: EbsMetricChange): Metric

    The total number of seconds spent by all read operations that completed in a specified period of time. If multiple requests are submitted at the same time, this total could be greater than the length of the period. For example, for a period of 5 minutes (300 seconds): if 700 operations completed during that period, and each operation took 1 second, the value would be 700 seconds. For Xen instances, data is reported only when there is read activity on the volume.

    The Average statistic on this metric is not relevant for volumes attached to Nitro-based instances.

    The Minimum and Maximum statistics on this metric are supported only by volumes attached to Nitro-based instances.

    Units: Seconds

    function volumeTotalWriteTime

    volumeTotalWriteTime(change?: EbsMetricChange): Metric

    The total number of seconds spent by all write operations that completed in a specified period of time. If multiple requests are submitted at the same time, this total could be greater than the length of the period. For example, for a period of 5 minutes (300 seconds): if 700 operations completed during that period, and each operation took 1 second, the value would be 700 seconds. For Xen instances, data is reported only when there is write activity on the volume.

    The Average statistic on this metric is not relevant for volumes attached to Nitro-based instances.

    The Minimum and Maximum statistics on this metric are supported only by volumes attached to Nitro-based instances.

    Units: Seconds

    function volumeWriteBytes

    volumeWriteBytes(change?: EbsMetricChange): Metric

    Provides information on the write operations in a specified period of time. The Sum statistic reports the total number of bytes transferred during the period. The Average statistic reports the average size of each write operation during the period, except on volumes attached to a Nitro-based instance, where the average represents the average over the specified period. The SampleCount statistic reports the total number of write operations during the period, except on volumes attached to a Nitro-based instance, where the sample count represents the number of data points used in the statistical calculation. For Xen instances, data is reported only when there is write activity on the volume.

    The Minimum and Maximum statistics on this metric are supported only by volumes attached to Nitro-based instances.

    Units: Bytes

    function volumeWriteOps

    volumeWriteOps(change?: EbsMetricChange): Metric

    The total number of write operations in a specified period of time.

    To calculate the average write operations per second (write IOPS) for the period, divide the total write operations in the period by the number of seconds in that period.

    The Minimum and Maximum statistics on this metric are supported only by volumes attached to Nitro-based instances.

    Units: Count

      Pulumi AI - What cloud infrastructure would you like to build? Generate Program