Skip to content

AlarmTaskProps

Properties for defining a AlarmTask.

See https://www.alibabacloud.com/help/ros/developer-reference/aliyun-ess-alarmtask

Initializer

import ros_cdk_ess
ros_cdk_ess.AlarmTaskProps(
  alarm_action: typing.Union[IResolvable, typing.List[typing.Union[str, IResolvable]]],
  metric_name: typing.Union[str, IResolvable],
  scaling_group_id: typing.Union[str, IResolvable],
  threshold: typing.Union[typing.Union[int, float], IResolvable],
  comparison_operator: typing.Union[str, IResolvable] = None,
  description: typing.Union[str, IResolvable] = None,
  dimensions: typing.Union[IResolvable, typing.List[typing.Union[IResolvable, DimensionsProperty]]] = None,
  evaluation_count: typing.Union[typing.Union[int, float], IResolvable] = None,
  group_id: typing.Union[typing.Union[int, float], IResolvable] = None,
  metric_type: typing.Union[str, IResolvable] = None,
  name: typing.Union[str, IResolvable] = None,
  period: typing.Union[typing.Union[int, float], IResolvable] = None,
  statistics: typing.Union[str, IResolvable] = None
)

Properties

Name Type Description
alarm_action typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[str, ros_cdk_core.IResolvable]]] Property alarmAction: The list of unique identifiers of the scaling rules that are associated with the event-triggered task.
metric_name typing.Union[str, ros_cdk_core.IResolvable] Property metricName: The name of the metric.
scaling_group_id typing.Union[str, ros_cdk_core.IResolvable] Property scalingGroupId: The ID of the scaling group.
threshold typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] Property threshold: The threshold of a metric in the multi-metric alert rule.
comparison_operator typing.Union[str, ros_cdk_core.IResolvable] Property comparisonOperator: The operator that is used to compare the metric value and the metric threshold.
description typing.Union[str, ros_cdk_core.IResolvable] Property description: The description of the event-triggered task.
dimensions typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, DimensionsProperty]]] Property dimensions: Dimensions.
evaluation_count typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] Property evaluationCount: The number of times that the threshold must be reached before a scaling rule can be executed.
group_id typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] Property groupId: The ID of the application group to which the custom metric belongs.
metric_type typing.Union[str, ros_cdk_core.IResolvable] Property metricType: The type of the metric.
name typing.Union[str, ros_cdk_core.IResolvable] Property name: The name of the event-triggered task.
period typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] Property period: The period of time during which statistics about the metric is collected.
statistics typing.Union[str, ros_cdk_core.IResolvable] Property statistics: The method that is used to aggregate statistics for the metric.

alarm_actionRequired

alarm_action: typing.Union[IResolvable, typing.List[typing.Union[str, IResolvable]]]
  • Type: typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[str, ros_cdk_core.IResolvable]]]

Property alarmAction: The list of unique identifiers of the scaling rules that are associated with the event-triggered task.


metric_nameRequired

metric_name: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property metricName: The name of the metric.

Valid values of MetricName vary based on the value of MetricType.

  • If you set MetricType to custom, the valid values of MetricName are your custom metrics.
  • If you set MetricType to system, MetricName has the following valid values:
  • CpuUtilization: (ECS) the CPU utilization. Unit: %.
  • IntranetTx: the outbound traffic over the internal network from an ECS instance. Unit: KB/min.
  • IntranetRx: the inbound traffic over the internal network to an ECS instance. Unit: KB/min.
  • VpcInternetTx: the outbound traffic over the Internet from an ECS instance that resides in a virtual private cloud (VPC). Unit: KB/min.
  • VpcInternetRx: the inbound traffic over the Internet to an ECS instance that resides in a VPC. Unit: KB/min.
  • SystemDiskReadBps: the number of bytes read from the system disk that is used by an ECS instance per second.
  • SystemDiskWriteBps: the number of bytes written to the system disk that is used by an ECS instance per second.
  • SystemDiskReadOps: the number of read operations on the system disk that is used by an ECS instance per second.
  • SystemDiskWriteOps: the number of write operations on the system disk that is used by an ECS instance per second.
  • CpuUtilizationAgent: the CPU utilization of an agent. Unit: %.
  • GpuMemoryFreeUtilizationAgent: the percentage of idle GPU memory of an agent.
  • GpuMemoryUtilizationAgent: the GPU memory usage of an agent. Unit: %.
  • MemoryUtilization: the memory usage of an agent. Unit: %.
  • LoadAverage: the average system load of an agent.
  • TcpConnection: the total number of TCP connections of an agent.
  • TcpConnection: the number of established TCP connections of an agent.
  • PackagesNetOut: the number of packets that are sent by the internal network interface controller (NIC) used by an agent.
  • PackagesNetIn: the number of packets that are received by the internal NIC used by an agent.
  • EciPodCpuUtilization: the CPU utilization of an elastic container instance. Unit: %.
  • EciPodMemoryUtilization: the memory usage of an elastic container instance. Unit: %.

scaling_group_idRequired

scaling_group_id: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property scalingGroupId: The ID of the scaling group.


thresholdRequired

threshold: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

Property threshold: The threshold of a metric in the multi-metric alert rule.

If the threshold is reached the specified number of times within the specified period, a scaling rule is executed.


comparison_operatorOptional

comparison_operator: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property comparisonOperator: The operator that is used to compare the metric value and the metric threshold.

Valid values:

  • If the metric value is greater than or equal to the metric threshold, set the value to >=.
  • If the metric value is less than or equal to the metric threshold, set the value to <=.
  • If the metric value is greater than the metric threshold, set the value to >.
  • If the metric value is less than the metric threshold, set the value to <.

descriptionOptional

description: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property description: The description of the event-triggered task.


dimensionsOptional

dimensions: typing.Union[IResolvable, typing.List[typing.Union[IResolvable, DimensionsProperty]]]
  • Type: typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, DimensionsProperty]]]

Property dimensions: Dimensions.


evaluation_countOptional

evaluation_count: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

Property evaluationCount: The number of times that the threshold must be reached before a scaling rule can be executed.

For example, if you set this parameter to 3, the average CPU utilization must reach or exceed 80% three times in a row before a scaling rule is triggered.


group_idOptional

group_id: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

Property groupId: The ID of the application group to which the custom metric belongs.

This parameter must be specified when MetricType is set to custom.


metric_typeOptional

metric_type: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property metricType: The type of the metric.

Valid values:

  • system: system metrics of CloudMonitor
  • custom: custom metrics that are reported to CloudMonitor

nameOptional

name: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property name: The name of the event-triggered task.


periodOptional

period: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

Property period: The period of time during which statistics about the metric is collected.

Unit: seconds. Valid values:

  • 15
  • 60
  • 120
  • 300
  • 900

If your scaling group is of the ECS type and uses CloudMonitor metrics, you can set Period to 15. In other cases, you can set Period to 60, 120, 300, or 900. In most cases, the name of a CloudMonitor metric contains Agent.


statisticsOptional

statistics: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property statistics: The method that is used to aggregate statistics for the metric.

Valid values:

  • Average
  • Minimum
  • Maximum