テンプレートクエリ

サーバー、アプリケーション、センサー名などの詳細をメトリクスクエリでハードコーディングする代わりに、変数を代わりに使用できます。変数は、ダッシュボードの上部にドロップダウン選択ボックスとして表示されます。これらのドロップダウンボックスを使用して、ダッシュボードに表示されるデータを変更できます。

テンプレート機能とさまざまなタイプのテンプレート変数の概要テンプレートについては、「」を参照してください。

クエリ変数

CloudWatch データソースには、変数編集ビューの Query フィールドで指定できる以下のクエリが用意されています。これらを使用して、変数のオプションリストを region、namespaces、、 などのモノで埋めることができますmetric namesdimension keys/values。

の代わりにregion、クエリのデータソースで設定されたデフォルトのリージョンを使用するdefaultように を指定できます。

名前	説明
regions()	すべての AWS リージョンのリストを返します。
namespaces()	が CloudWatch サポートする名前空間のリストを返します。
metrics(namespace, [region])	名前空間内のメトリクスのリストを返します。（リージョンを指定するか、カスタムメトリクス"default"に使用します。）
dimension_keys(namespace)	名前空間のディメンションキーのリストを返します。
dimension_values(region, namespace, metric, dimension_key, [filters])	指定された region、、namespace、metricまたは に一致するディメンション値のリストを返しますdimension_key。または、ディメンションを使用してより具体的な結果filtersを取得することもできます。
ebs_volume_ids(region, instance_id)	指定された region、 IDsに一致するボリュームのリストを返しますinstance_id。
ec2_instance_attribute(region, attribute_name, filters)	指定された 、region、 に一致する属性のリストを返しますattribute_namefilters。
resource_arns(region, resource_type, tags)	指定された 、region、resource_typeおよび ARNsに一致する のリストを返しますtags。
statistics()	すべての標準統計のリストを返します。

CloudWatch が提供するメトリクスの詳細については、「メトリクスを発行AWS する のサービス CloudWatch 」を参照してください。

テンプレート化されたクエリの例

次の表は、個々の AWS サービスのリソースのリストを返すディメンションクエリの例を示しています。

Query	サービス
dimension_values(us-east-1,AWS/ELB,RequestCount,LoadBalancerName)	Elastic Load Balancing
dimension_values(us-east-1,AWS/ElastiCache,CPUUtilization,CacheClusterId)	Amazon ElastiCache
dimension_values(us-east-1,AWS/Redshift,CPUUtilization,ClusterIdentifier)	Amazon Redshift
dimension_values(us-east-1,AWS/RDS,CPUUtilization,DBInstanceIdentifier)	Amazon RDS
dimension_values(us-east-1,AWS/S3,BucketSizeBytes,BucketName)	Amazon Simple Storage Service (Amazon S3)
dimension_values(us-east-1,CWAgent,disk_used_percent,device,{"InstanceId":"$instance_id"})	CloudWatch エージェント
resource_arns(eu-west-1,elasticloadbalancing:loadbalancer,{"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]})	Elastic Load Balancing
resource_arns(eu-west-1,ec2:instance,{"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]})	Amazon EC2