すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:ALIYUN::CMS::GroupMetricRule

最終更新日:Mar 28, 2026

ALIYUN::CMS::GroupMetricRule リソースは、アプリケーショングループのアラートルールを作成します。

構文

{
  "Type": "ALIYUN::CMS::GroupMetricRule",
  "Properties": {
    "NoEffectiveInterval": String,
    "SilenceTime": Integer,
    "Category": String,
    "RuleId": String,
    "Dimensions": String,
    "Period": Integer,
    "EffectiveInterval": String,
    "Namespace": String,
    "GroupId": String,
    "MetricName": String,
    "Escalations": Map,
    "EmailSubject": String,
    "Webhook": String,
    "RuleName": String,
    "Interval": Integer,
    "NoDataPolicy": String,
    "ExtraDimensionJson": Map,
    "Options": String,
    "ContactGroups": List
  }
}

プロパティ

パラメーター

タイプ

必須

更新の許可

説明

制約

Category

String

はい

いいえ

Alibaba Cloud サービスの略称です。

有効値:

  • ecs:Elastic Compute Service (ECS)

  • rds:ApsaraDB RDS

  • ads:AnalyticDB for MySQL

  • slb:Server Load Balancer (SLB)

  • vpc:Virtual Private Cloud (VPC)

  • apigateway:API Gateway

  • cdn:Alibaba Cloud CDN (CDN)

  • cs:Container Service for Kubernetes (ACK)

  • dcdn:Dynamic Content Delivery Network (DCDN)

  • ddos:Anti-DDoS Pro/Premium

  • eip:Elastic IP Address (EIP)

  • elasticsearch:Elasticsearch

  • emr:E-MapReduce (EMR)

  • ess:Auto Scaling

  • hbase:ApsaraDB for HBase

  • iot_edge:Link IoT Edge

  • k8s_pod:ACK pod

  • kvstore_sharding:クラスターアーキテクチャの Tair (Redis OSS-compatible)

  • kvstore_splitrw:読み書き分離アーキテクチャの Tair (Redis OSS-compatible)

  • kvstore_standard:スタンダードアーキテクチャの Tair (Redis OSS-compatible)

  • memcache:ApsaraDB for Memcache (新バージョン)

  • SMQSimple Message Queue (formerly MNS)

  • mongodb:ApsaraDB for MongoDB レプリカセットインスタンス

  • mongodb_cluster:ApsaraDB for MongoDB スタンドアロンインスタンス

  • mongodb_sharding:ApsaraDB for MongoDB シャードクラスターインスタンス

  • mq_topic:Simple Message Queue (formerly MNS) トピック

  • ocs:ApsaraDB for Memcache (オリジナルバージョン)

  • opensearch:OpenSearch

  • oss:Object Storage Service (OSS)

  • polardb:PolarDB

  • petadata:HybridDB for MySQL

  • sharebandwidthpackages: Internet Shared Bandwidth。

  • sls:Simple Log Service (SLS)

  • vpn:VPN Gateway

説明

CloudMonitor は継続的に多くのサービスをサポートしているため、このリストは完全ではない場合があります。

Escalations

Map

はい

はい

アラート設定です。

詳細については、「Escalations のプロパティ」をご参照ください。

GroupId

String

はい

はい

アプリケーショングループの ID です。

なし。

MetricName

String

はい

はい

メトリックの名前です。詳細については、「DescribeMetricMetaList」または「Alibaba Cloud サービスの主要メトリック」をご参照ください。

なし。

Namespace

String

はい

いいえ

サービスの名前空間です。詳細については、「DescribeMetricMetaList」または「Alibaba Cloud サービスの主要メトリック」をご参照ください。

なし。

RuleId

String

はい

いいえ

アラートルールの ID です。

呼び出し元で一意になるようにこの ID を生成する必要があります。

RuleName

String

はい

はい

アラートルールの名前です。

なし。

ContactGroups

List

いいえ

はい

アラートグループです。

最大 200 の連絡先を指定できます。

Dimensions

String

いいえ

はい

拡張リソースディメンションです。

デフォルトでは、アプリケーショングループのアラートルールは、そのグループ内のすべてのインスタンスに適用されます。このパラメーターを使用して、追加のリソースディメンションを指定します。たとえば、グループ内のすべてのインスタンスのルートパーティションのディスク使用率をモニターするには、このパラメーターを [ {"dskName":"/"} ] に設定します。

EffectiveInterval

String

いいえ

はい

アラートルールがアクティブな期間です。

なし。

EmailSubject

String

いいえ

はい

アラート通知メールの件名です。

なし。

ExtraDimensionJson

Map

いいえ

はい

アラートルールの 2 次または 3 次ディメンションです。

フォーマット:key:value 形式のキーと値のペアのコレクションです。例:port:80/dev/xvda:d-m5e6yphgzn3aprwu****

アラートルールのプライマリディメンションが {"instanceId":"i-m5e1qg6uo38rztr4****"} の場合、セカンダリディメンションはそのインスタンスの特定のクラウドディスク (例:{"/dev/xvda":"d-m5e6yphgzn3aprwu****"}) になります。

Interval

Integer

いいえ

はい

アラートルールをチェックする間隔です。デフォルト値は、メトリックの最小ポーリング頻度です。

単位:秒。

この間隔は、データレポート期間と同じ値に設定することを推奨します。チェック間隔がレポート期間より短い場合、データ不足によりアラートがトリガーされない可能性があります。

NoDataPolicy

String

いいえ

はい

モニタリングデータが利用できない場合にアラートを処理するメソッドです。

有効値:

  • KEEP_LAST_STATE (デフォルト):アクションは実行されません。

  • INSUFFICIENT_DATA:データ不足を示すアラートをトリガーします。

  • OK:ステータスを正常と見なします。

NoEffectiveInterval

String

いいえ

はい

アラートルールが非アクティブな期間です。

なし。

Options

String

いいえ

はい

詳細設定です。

JSON 形式で詳細設定を指定します:{"key1":"value1","key2":"value2"}。たとえば、{"NotSendOK":true} は、アラートが解決されたときに CloudMonitor が通知を送信しないようにします。NotSendOK キーの場合、true は送信しないことを意味し、false (デフォルト) は送信することを意味します。

Period

Integer

いいえ

はい

メトリックデータの集計期間です。

値は 60 または 60 の整数倍である必要があります。

単位:秒。

デフォルト値:300。

説明

300 秒の期間の場合、システムは指定された統計メソッドに基づいて、5 分間のウィンドウから生データを集計し、評価のために単一のデータポイントにします。たとえば、データが 1 分ごとにレポートされる場合、システムはその期間内の 5 つのデータポイントを平均します。

SilenceTime

Integer

いいえ

はい

サイレンス期間の持続時間です。アラートがトリガーされた場合、サイレンス期間が終了するまで新しい通知は送信されません。

単位:秒。

最小値:3600 (1 時間)。

デフォルト値:86400 (1 日)。

Webhook

String

いいえ

はい

アラートがトリガーされたときに CloudMonitor が通知を送信する Webhook URL です。

なし。

Escalations の構文

"Escalations": {
  "Critical": Map,
  "Info": Map,
  "Warn": Map
}

Escalations のプロパティ

パラメーター

タイプ

必須

更新の許可

説明

制約

Critical

Map

いいえ

はい

クリティカルレベルのアラートの設定です。

詳細については、「Critical のプロパティ」をご参照ください。

Info

Map

いいえ

はい

情報レベルのアラートの設定です。

詳細については、「Info のプロパティ」をご参照ください。

Warn

Map

いいえ

はい

警告レベルのアラートの設定です。

詳細については、「Warn のプロパティ」をご参照ください。

重要な構文

"Critical": {
  "ComparisonOperator": String,
  "Times": Integer,
  "Statistics": String,
  "Threshold": Integer
}

クリティカルなプロパティ

パラメーター

タイプ

必須

更新の許可

説明

制約

ComparisonOperator

String

はい

はい

メトリック値としきい値を比較するための演算子です。

有効値:

  • GreaterThanOrEqualToThreshold:しきい値以上。

  • GreaterThanThreshold:しきい値より大きい。

  • LessThanOrEqualToThreshold:しきい値以下。

  • LessThanThreshold:しきい値未満。

  • NotEqualToThreshold:しきい値と等しくない。

  • GreaterThanYesterday:昨日の同時刻のメトリック値より大きい。

  • LessThanYesterday:昨日の同時刻のメトリック値未満。

  • GreaterThanLastWeek:先週の同時刻のメトリック値より大きい。

  • LessThanLastWeek:先週の同時刻のメトリック値未満。

  • GreaterThanLastPeriod:前のモニタリングサイクルでのメトリック値より大きい。

  • LessThanLastPeriod:前のモニタリングサイクルでのメトリック値未満。

Statistics

String

はい

はい

統計メソッドです。

各重要度レベルの統計メソッドの有効値については、「DescribeSystemEventMetaList」をご参照ください。

Times

Integer

はい

はい

アラートをトリガーするためにメトリック値がアラート条件を満たす必要がある連続回数です。

なし。

Threshold

Integer

はい

はい

アラートのしきい値です。

なし。

Info の構文

"Info": {
  "ComparisonOperator": String,
  "Times": Integer,
  "Statistics": String,
  "Threshold": Integer
}

Info のプロパティ

パラメーター

タイプ

必須

更新の許可

説明

制約

ComparisonOperator

String

はい

はい

メトリック値としきい値を比較するための演算子です。

有効値:

  • GreaterThanOrEqualToThreshold:しきい値以上。

  • GreaterThanThreshold:しきい値より大きい。

  • LessThanOrEqualToThreshold:しきい値以下。

  • LessThanThreshold:しきい値未満。

  • NotEqualToThreshold:しきい値と等しくない。

  • GreaterThanYesterday:昨日の同時刻のメトリック値より大きい。

  • LessThanYesterday:昨日の同時刻のメトリック値未満。

  • GreaterThanLastWeek:先週の同時刻のメトリック値より大きい。

  • LessThanLastWeek:先週の同時刻のメトリック値未満。

  • GreaterThanLastPeriod:前のモニタリングサイクルでのメトリック値より大きい。

  • LessThanLastPeriod:前のモニタリングサイクルでのメトリック値未満。

Statistics

String

はい

はい

統計メソッドです。

各重要度レベルの統計メソッドの有効値については、「DescribeSystemEventMetaList」をご参照ください。

Threshold

Integer

はい

はい

アラートのしきい値です。

なし。

Times

Integer

はい

はい

アラートをトリガーするためにメトリック値がアラート条件を満たす必要がある連続回数です。

なし。

Warn の構文

"Warn": {
  "ComparisonOperator": String,
  "Times": Integer,
  "Statistics": String,
  "Threshold": Integer
}

Warn のプロパティ

パラメーター

タイプ

必須

更新の許可

説明

制約

ComparisonOperator

String

はい

はい

メトリック値としきい値を比較するための演算子です。

有効値:

  • GreaterThanOrEqualToThreshold:しきい値以上。

  • GreaterThanThreshold:しきい値より大きい。

  • LessThanOrEqualToThreshold:しきい値以下。

  • LessThanThreshold:しきい値未満。

  • NotEqualToThreshold:しきい値と等しくない。

  • GreaterThanYesterday:昨日の同時刻のメトリック値より大きい。

  • LessThanYesterday:昨日の同時刻のメトリック値未満。

  • GreaterThanLastWeek:先週の同時刻のメトリック値より大きい。

  • LessThanLastWeek:先週の同時刻のメトリック値未満。

  • GreaterThanLastPeriod:前のモニタリングサイクルでのメトリック値より大きい。

  • LessThanLastPeriod:前のモニタリングサイクルでのメトリック値未満。

Statistics

String

はい

はい

統計メソッドです。

各重要度レベルの統計メソッドの有効値については、「DescribeSystemEventMetaList」をご参照ください。

Threshold

Integer

はい

はい

アラートのしきい値です。

なし。

Times

Integer

はい

はい

アラートをトリガーするためにメトリック値がアラート条件を満たす必要がある連続回数です。

なし。

戻り値

Fn::GetAtt

RuleId:アラートルールの ID です。

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  Category:
    Type: String
    Description: |-
      Alibaba Cloud サービスの略称です。有効値:
      ecs:Elastic Compute Service (ECS)
      rds:ApsaraDB RDS
      ads:AnalyticDB for MySQL
      slb:Server Load Balancer (SLB)
      vpc:Virtual Private Cloud (VPC)
      apigateway:API Gateway
      cdn:Alibaba Cloud CDN (CDN)
      cs:Container Service for Kubernetes (ACK)
      dcdn:Dynamic Content Delivery Network (DCDN)
      ddos:Anti-DDoS Pro/Premium
      eip:Elastic IP Address (EIP)
      elasticsearch:Elasticsearch
      emr:E-MapReduce (EMR)
      ess:Auto Scaling
      hbase:ApsaraDB for HBase
      iot_edge:Link IoT Edge
      k8s_pod:ACK pod
      kvstore_sharding:クラスターアーキテクチャの Tair (Redis OSS-compatible)
      kvstore_splitrw:読み書き分離アーキテクチャの Tair (Redis OSS-compatible)
      kvstore_standard:スタンダードアーキテクチャの Tair (Redis OSS-compatible)
      memcache:ApsaraDB for Memcache (新バージョン)
      mongodb:ApsaraDB for MongoDB レプリカセットインスタンス
      mongodb_cluster:ApsaraDB for MongoDB スタンドアロンインスタンス
      mongodb_sharding:ApsaraDB for MongoDB シャードクラスターインスタンス
      mq_topic:Simple Message Queue (SMQ) トピック
      ocs:ApsaraDB for Memcache (オリジナルバージョン)
      opensearch:OpenSearch
      oss:Object Storage Service (OSS)
      polardb:PolarDB
      petadata:HybridDB for MySQL
      sharebandwidthpackages:Internet Shared Bandwidth
      sls:Simple Log Service (SLS)
      smq:Simple Message Queue (SMQ)
      vpn:VPN Gateway
    Default: ecs
  RuleId:
    Type: String
    Description: アラートルールの ID です。この ID は、呼び出し元で一意になるように生成する必要があります。
    Default: uuid_aad57415dswer23124sfsg9***
  Namespace:
    Type: String
    Description: |-
      サービスのデータ名前空間です。詳細については、DescribeMetricMetaList を呼び出すか、
      「Alibaba Cloud サービスの主要メトリック」をご参照ください。
    Default: acs_ecs_dashboard
  GroupId:
    Type: String
    Description: アプリケーショングループの ID です。
    Default: 6102***
  MetricName:
    Type: String
    Description: メトリックの名前です。詳細については、DescribeMetricMetaList を呼び出すか、「Alibaba Cloud サービスの主要メトリック」をご参照ください。
    Default: cpu_cores
  Escalations:
    Type: Json
    Description: アラート設定です。
    Default:
      Critical:
        ComparisonOperator: GreaterThanOrEqualToThreshold
        Times: 3
        Statistics: Value
        Threshold: '100'
  RuleName:
    Type: String
    Description: アラートルールの名前です。
    Default: mytest
Resources:
  GroupMetricRule:
    Type: ALIYUN::CMS::GroupMetricRule
    Properties:
      Category:
        Ref: Category
      RuleId:
        Ref: RuleId
      Namespace:
        Ref: Namespace
      GroupId:
        Ref: GroupId
      MetricName:
        Ref: MetricName
      Escalations:
        Ref: Escalations
      RuleName:
        Ref: RuleName
Outputs:
  RuleId:
    Description: アラートルールの ID です。
    Value:
      Fn::GetAtt:
        - GroupMetricRule
        - RuleId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "Category": {
      "Type": "String",
      "Description": "Alibaba Cloud サービスの略称です。有効値:\necs:Elastic Compute Service (ECS)\nrds:ApsaraDB RDS\nads:AnalyticDB for MySQL\nslb:Server Load Balancer (SLB)\nvpc:Virtual Private Cloud (VPC)\napigateway:API Gateway\ncdn:Alibaba Cloud CDN (CDN)\ncs:Container Service for Kubernetes (ACK)\ndcdn:Dynamic Content Delivery Network (DCDN)\nddos:Anti-DDoS Pro/Premium\neip:Elastic IP Address (EIP)\nelasticsearch:Elasticsearch\nemr:E-MapReduce (EMR)\ness:Auto Scaling\nhbase:ApsaraDB for HBase\niot_edge:Link IoT Edge\nk8s_pod:ACK pod\nkvstore_sharding:クラスターアーキテクチャの Tair (Redis OSS-compatible)\nkvstore_splitrw:読み書き分離アーキテクチャの Tair (Redis OSS-compatible)\nkvstore_standard:スタンダードアーキテクチャの Tair (Redis OSS-compatible)\nmemcache:ApsaraDB for Memcache (新バージョン)\nmongodb:ApsaraDB for MongoDB レプリカセットインスタンス\nmongodb_cluster:ApsaraDB for MongoDB スタンドアロンインスタンス\nmongodb_sharding:ApsaraDB for MongoDB シャードクラスターインスタンス\nmq_topic:Simple Message Queue (SMQ) トピック\nocs:ApsaraDB for Memcache (オリジナルバージョン)\nopensearch:OpenSearch\noss:Object Storage Service (OSS)\npolardb:PolarDB\npetadata:HybridDB for MySQL\nsharebandwidthpackages:Internet Shared Bandwidth\nsls:Simple Log Service (SLS)\nSMQ:Simple Message Queue (SMQ)\nvpn:VPN Gateway",
      "Default": "ecs"
    },
    "RuleId": {
      "Type": "String",
      "Description": "アラートルールの ID です。この ID は、呼び出し元で一意になるように生成する必要があります。",
      "Default": "uuid_aad57415dswer23124sfsg9***"
    },
    "Namespace": {
      "Type": "String",
      "Description": "サービスのデータ名前空間です。詳細については、DescribeMetricMetaList を呼び出すか、「Alibaba Cloud サービスの主要メトリック」をご参照ください。",
      "Default": "acs_ecs_dashboard"
    },
    "GroupId": {
      "Type": "String",
      "Description": "アプリケーショングループの ID です。",
      "Default": "6102***"
    },
    "MetricName": {
      "Type": "String",
      "Description": "メトリックの名前です。詳細については、DescribeMetricMetaList を呼び出すか、「Alibaba Cloud サービスの主要メトリック」をご参照ください。",
      "Default": "cpu_cores"
    },
    "Escalations": {
      "Type": "Json",
      "Description": "アラート設定です。",
      "Default": {
        "Critical": {
          "ComparisonOperator": "GreaterThanOrEqualToThreshold",
          "Times": 3,
          "Statistics": "Value",
          "Threshold": "100"
        }
      }
    },
    "RuleName": {
      "Type": "String",
      "Description": "アラートルールの名前です。",
      "Default": "mytest"
    }
  },
  "Resources": {
    "GroupMetricRule": {
      "Type": "ALIYUN::CMS::GroupMetricRule",
      "Properties": {
        "Category": {
          "Ref": "Category"
        },
        "RuleId": {
          "Ref": "RuleId"
        },
        "Namespace": {
          "Ref": "Namespace"
        },
        "GroupId": {
          "Ref": "GroupId"
        },
        "MetricName": {
          "Ref": "MetricName"
        },
        "Escalations": {
          "Ref": "Escalations"
        },
        "RuleName": {
          "Ref": "RuleName"
        }
      }
    }
  },
  "Outputs": {
    "RuleId": {
      "Description": "アラートルールの ID です。",
      "Value": {
        "Fn::GetAtt": [
          "GroupMetricRule",
          "RuleId"
        ]
      }
    }
  }
}