イベントトリガータスクを作成します。
操作説明
操作説明
-
カスタム監視タイプのイベントトリガータスク (MetricType=custom) を作成する場合、事前にカスタム監視メトリクスを CloudMonitor にレポートする必要があります。詳細については、カスタム監視タイプのイベントトリガータスクを参照してください。
-
イベントトリガータスクを作成する際、監視メトリクス (MetricName) を指定し、ディメンション情報 (Dimension.N.DimensionKey および Dimension.N.DimensionValue) を使用して、スケーリンググループ内の監視メトリクスデータの集約範囲を決定する必要があります。たとえば、user_id と scaling_group を指定して、指定したユーザーのスケーリンググループ内のすべての ECS インスタンスまたはエラスティックコンテナインスタンスの監視メトリクスデータを集約できます。
カスタム監視タイプのイベントトリガータスク (MetricType=custom) の監視メトリクスは、カスタム監視メトリクスに依存します。
システムモニタリングタイプのイベントトリガータスク (MetricType=system) でサポートされる監視メトリクスの詳細については、システムモニタリングタイプのイベントトリガータスクを参照してください。
ディメンション情報の user_id と scaling_group はシステムによって自動的に入力されます。デバイスと state は手動で指定する必要があります。詳細については、Dimension.N.DimensionKey および Dimension.N.DimensionValue パラメーターを参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ess:CreateAlarm |
create |
*ScalingGroup
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
スケーリンググループのリージョン ID。 |
cn-hangzhou |
| Name |
string |
任意 |
イベントトリガータスクの名前。 |
TestAlarmTask |
| Description |
string |
任意 |
イベントトリガータスクの説明。 |
Test alarm task. |
| ScalingGroupId |
string |
必須 |
イベントトリガータスクに関連付けられたスケーリンググループの ID。 |
asg-bp18p2yfxow2dloq**** |
| MetricName |
string |
任意 |
監視メトリクスの名前。有効な値はイベントトリガータスクのモニタリングタイプによって異なります:
詳細については、システムモニタリングタイプのイベントトリガータスクを参照してください。 |
CpuUtilization |
| MetricType |
string |
任意 |
モニタリングメトリックのタイプ。有効な値:
|
system |
| Period |
integer |
任意 |
モニタリングメトリックデータの統計期間。単位: 秒。有効な値:
説明
15 秒の統計期間をサポートするのは ECS タイプのスケーリンググループのみです。 デフォルト値: 300。 |
300 |
| Statistics |
string |
任意 |
モニタリングメトリックデータの集約に使用されるメソッド。有効な値:
デフォルト値: Average。 |
Average |
| Threshold |
number |
任意 |
モニタリングメトリックのしきい値。指定された回数だけしきい値式が満たされると、アラートがトリガーされ、スケーリングルールが実行されます。 |
80.0 |
| ComparisonOperator |
string |
任意 |
モニタリングメトリックの集約値としきい値の間の比較演算子。このパラメーターは、条件が満たされる関係を指定します。有効な値:
デフォルト値: >=。 |
>= |
| EvaluationCount |
integer |
任意 |
スケーリングルールが実行される前に、しきい値式が連続して満たされる必要がある回数。たとえば、平均 CPU 使用率が 3 回連続の統計期間で 80% 以上である必要があります。 デフォルト値: 3。 |
3 |
| GroupId |
integer |
任意 |
カスタム監視メトリックが属する CloudMonitor アプリケーショングループの ID。このパラメーターは、MetricType が custom にセットされている場合にのみ必須です。 |
4055401 |
| Effective |
string |
任意 |
イベントトリガータスクの有効期間。デフォルトでは、イベントトリガータスクは常に有効です。 このパラメーターは cron 式に従います。デフォルトのフォーマットは
説明
このパラメーターの値はデフォルトで協定世界時 (UTC)+8 タイムゾーンです。cron 式の前にタイムゾーン情報 例:
|
TZ=+00 * * 1-2 * * ? |
| AlarmAction |
array |
任意 |
イベントトリガータスクに関連付けられたスケーリングルールの一意の識別子。 |
ari:acs:ess:cn-hangzhou:1406926****:scalingrule/asr-bp163l21e07uhn**** |
|
string |
任意 |
イベントトリガータスクに関連付けられたスケーリングルールの一意の識別子。 |
ari:acs:ess:cn-hangzhou:1406926****:scalingrule/asr-bp163l21e07uhn**** |
|
| Dimension |
array<object> |
任意 |
モニタリングメトリックに関連付けられたディメンションのリスト。 |
|
|
object |
任意 |
モニタリングメトリックに関連付けられたディメンションのリスト。 |
||
| DimensionKey |
string |
任意 |
監視メトリクスに関連付けられたディメンションのキー。有効な値はイベントトリガータスクのモニタリングタイプによって異なります:
|
device |
| DimensionValue |
string |
任意 |
監視メトリクスに関連付けられたディメンションの値。有効な値は Dimension.N.DimensionKey によって決まります:
|
eth0 |
| Expression |
array<object> |
任意 |
マルチメトリックアラートルールの情報。 |
|
|
object |
任意 |
マルチメトリックアラートルールの情報。 |
||
| MetricName |
string |
任意 |
マルチメトリックアラートルールの監視メトリクスの名前。有効な値はイベントトリガータスクのモニタリングタイプによって異なります:
詳細については、システムモニタリングタイプのイベントトリガータスクを参照してください。 |
CpuUtilization |
| ComparisonOperator |
string |
任意 |
マルチメトリックアラートルールにおけるモニタリングメトリックの集約値としきい値の間の比較演算子。このパラメーターは、条件が満たされる関係を指定します。有効な値:
デフォルト値: >=。 |
>= |
| Period |
integer |
任意 |
マルチメトリックアラートルールにおけるモニタリングメトリックデータの統計期間。単位: 秒。有効な値:
説明
15 秒の統計期間をサポートするのは ECS タイプのスケーリンググループのみです。 デフォルト値: 300。 |
900 |
| Statistics |
string |
任意 |
マルチメトリックアラートルールにおけるモニタリングメトリックデータの集約に使用されるメソッド。有効な値:
デフォルト値: Average。 |
Average |
| Threshold |
number |
任意 |
マルチメトリックアラートルールにおける監視メトリクスのしきい値。指定された回数だけしきい値式が満たされると、アラートがトリガーされ、スケーリングルールが実行されます。 |
40.0 |
| ExpressionsLogicOperator |
string |
任意 |
複数の監視メトリクスアラート条件間の関係。有効な値:
デフォルト値: |
&& |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| AlarmTaskId |
string |
イベントトリガータスクの ID。 |
asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1**** |
| RequestId |
string |
リクエスト ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
例
成功レスポンス
JSONJSON
{
"AlarmTaskId": "asg-bp1hvbnmkl10vll5****_f95ce797-dc2e-4bad-9618-14fee7d1****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。