As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Consultas modeladas
<a name="cloudwatch-templated-queries"></a>

 Em vez da codificação rígida dos detalhes dos nomes de servidores, das aplicações e dos sensores em suas consultas de métricas, você pode usar variáveis no lugar deles. As variáveis são mostradas como caixas de seleção suspensas na parte superior do dashboard. Você pode usar essas caixas suspensas para alterar os dados exibidos no dashboard. 

 Consulte [Modelos](templates-and-variables.md#templates) para obter uma introdução ao recurso de modelagem e aos diferentes tipos de variáveis de modelo. 

## Variável de consulta
<a name="cloudwatch-query-variable"></a>

 A fonte de CloudWatch dados fornece as seguintes consultas que você pode especificar no campo **Consulta** na exibição de edição de **variáveis**. Você pode usá-las para preencher a lista de opções de uma variável com elementos como `region`, `namespaces`, `metric names` e `dimension keys/values`. 

 No lugar de `region`, você pode especificar `default` para usar a região padrão configurada na fonte de dados da consulta. 


|  Name (Nome)  |  Description  | 
| --- | --- | 
|  regions()  |  Retorna uma lista de todas as AWS regiões. | 
|  namespaces()  |  Retorna uma lista de namespaces compatíveis CloudWatch .  | 
|  metrics(namespace, [region])  |  Retorna uma lista de métricas no namespace. (Especifique a região ou use "default" para métricas personalizadas.)  | 
|  dimension\$1keys(namespace)  |  Retorna uma lista de chaves de dimensão no namespace.  | 
|  dimension\$1values(region, namespace, metric, dimension\$1key, [filters])  |  Retorna uma lista de valores de dimensão que correspondem aos elementos region, namespace, metric ou dimension\$1key especificados. Como alternativa, você pode usar filters de dimensão para obter um resultado mais específico.  | 
|  ebs\$1volume\$1ids(region, instance\$1id)  |  Retorna uma lista de volumes IDs correspondentes ao especificadoregion,instance\$1id.  | 
|  ec2\$1instance\$1attribute(region, attribute\$1name, filters)  |  Retorna uma lista de atributos que correspondem aos elementos region, attribute\$1name e filtersespecificados.  | 
|  resource\$1arns(region, resource\$1type, tags)  |  Retorna uma lista de ARNs correspondências às especificadas regionresource\$1type, tags e.  | 
|  statistics()  |  Retorna uma lista de todas as estatísticas padrão.  | 

 Para obter detalhes sobre as métricas que CloudWatch fornece, consulte [AWS serviços que publicam CloudWatch métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html). 

### Exemplos de consultas modeladas
<a name="cloudwatch-examples-templated-queries"></a>

 A tabela a seguir mostra exemplos de consultas de dimensão que retornam uma lista de recursos para AWS serviços individuais. 


|  Consulta  |  Serviço  | 
| --- | --- | 
|  dimension\$1values(us-east-1,AWS/ELB,RequestCount,LoadBalancerName)  |  Elastic Load Balancing  | 
|  dimension\$1values(us-east-1,AWS/ElastiCache,CPUUtilization,CacheClusterId)  |  Amazon ElastiCache  | 
|  dimension\$1values(us-east-1,AWS/Redshift,CPUUtilization,ClusterIdentifier)  |  banco de dados de origem  | 
|  dimension\$1values(us-east-1,AWS/RDS,CPUUtilization,DBInstanceIdentifier)  |  Amazon RDS  | 
|  dimension\$1values(us-east-1,AWS/S3,BucketSizeBytes,BucketName)  |  Amazon Simple Storage Service (Amazon S3)  | 
|  dimension\$1values(us-east-1,CWAgent,disk\$1used\$1percent,device,\$1"InstanceId":"\$1instance\$1id"\$1)  |  CloudWatch Agente  | 
|  resource\$1arns(eu-west-1,elasticloadbalancing:loadbalancer,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1)  |  Elastic Load Balancing  | 
|  resource\$1arns(eu-west-1,ec2:instance,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1)  |  Amazon EC2  |