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á.

# Conectar-se a uma fonte de dados Datadog
<a name="AMG-datadog-datasource-plugin"></a>

 A fonte de dados Datadog permite que você visualize as métricas do serviço de monitoramento Datadog no Amazon Managed Grafana. 

**nota**  
Essa fonte de dados é somente para o Grafana Enterprise. Para obter mais informações, consulte [Gerenciar o acesso aos plug-ins do Enterprise](upgrade-to-enterprise-plugins.md).  
Além disso, em espaços de trabalho compatíveis com a versão 9 ou mais recente, essa fonte de dados pode requerer a instalação do plug-in apropriado. Para obter mais informações, consulte [Ampliar o espaço de trabalho com plug-ins](grafana-plugins.md).

## Usage
<a name="datadog-usage"></a>

### Armazenamento em cache
<a name="datadog-caching"></a>

 Para dashboards grandes, que fazem muitas consultas, é possível ter uma taxa limitada pela API Datadog (alcance o número máximo de chamadas de API por hora que a API Datadog permite). O recurso de cache armazena em cache consultas exclusivas por 60 segundos. Esse intervalo pode ser alterado para ser maior ou menor na página de configuração. 

### Editor de consultas
<a name="datadog-query-editor"></a>

 É fácil: selecione agregação e métrica. Caso você deseja filtrar o resultado, selecione uma ou mais tags. 

 A fonte de dados Datadog é compatível com todas as funções avançadas compatíveis com o editor de consultas do Datadog. Selecione-o na lista suspensa e organize escolhendo um nome de função.

 **Possibilidades de uso do campo Alias por**: 
+  Insira o alias no campo “Alias por”. 
+  Use variáveis com escopo: 
  +  `$__metric` = substituído pelo nome da métrica 
  +  `$__display_name` = substituído pelo nome da métrica 
  +  `$__expression` = substituído pela expressão de métrica completa 
  +  `$__aggr` = substituído pela função de agregação de métrica (por exemplo, méd., máx., mín., soma) 
  +  `$__scope` = substituído pelo escopo de métrica (por exemplo, região, site, ambiente, host) 
+  Usar expressões regulares: 
  +  Insira sua expressão regular no campo “Alias RegExp” no `/you regexp here/flags` formato. 
  +  Se o campo “Alias por” estiver vazio, RegExp os resultados serão unidos usando. Exemplo com expressão métrica =`avg:system.load.5{*}`: “Alias por” entrada de campo: “" "Alias RegExp "Entrada de campo: Resultado: `avg:(.+)\.(\d)` `system.load, 5` 
  +  Use variáveis `$<group_number>` no campo “Alias por”. Exemplo com expressão métrica =`avg:system.load.5{*}`: entrada de campo “Alias por”: entrada de campo `$1: $2 seconds` “Alias RegExp”: Resultado: `avg:(.+)\.(\d)` `system.load: 5 seconds` 
  +  Use `$0` para obter toda a expressão. Exemplo com expressão métrica =`datadog.dogstatsd.packet.count{*}`: entrada de campo “Alias por”: entrada de campo `Expression: $0` “Alias RegExp”: Resultado: `DOGstatsd\.(.*)\.(.*){\*}/i` `Expression: datadog.dogstatsd.packet.count{*}` 

   Observação: você receberá um erro ao usar um número de grupo inexistente. 

#### Métrica aritmética
<a name="datadog-metric-arithmetic"></a>

 Para usar a métrica aritmética, defina *Tipo de consulta* como *Aritmética*. Vincule à métrica que você deseja usando o sinal `#`. Por exemplo, `#A * 2` dobrará o resultado da consulta `A`. A aritmética entre duas métricas funciona da mesma forma: adicione consultas cujos resultados você deseja usar para o cálculo e, em seguida, vincule essas métricas na terceira consulta, como `#A / #B`. 

### Anotações
<a name="datadog-annotations"></a>

 Uma anotação é um evento sobreposto aos grafos. Um exemplo de evento é uma implantação ou uma interrupção. Com essa fonte de dados, você pode buscar eventos do Datadog e sobrepô-los em grafos no Amazon Managed Grafana. Os eventos de anotações podem ser filtrados por fonte, tag ou prioridade. 

### Modelos
<a name="datadog-templating"></a>

 Existem algumas opções para obter valores da variável do modelo: métricas e tags. Para obter a lista de métricas disponíveis, especifique `*` no campo *Consulta*. 

 Para retornar todas as tags, use o valor: `tag` ou `scope`. 

 Para retornar tags para um grupo de tags especificado, use um dos seguintes valores de categoria padrão: 
+  `host` 
+  `device` 
+  `env` 
+  `region` 
+  `site` 
+  `status` 
+  `version` 

 Para grupos de tags personalizados, basta inserir o nome do grupo de tags. Por exemplo, se o nome do grupo de tags personalizado for `subscription_name`, insira-o no campo *Consulta*. 

 Filtre os resultados usando o campo *Regex*. Variáveis de vários valores são compatíveis ao usar tags: vários valores de tag selecionados serão convertidos em uma lista de tags separada por vírgula. 

#### Filtros ad hoc
<a name="datadog-ad-hoc-filters"></a>

 Há um novo tipo especial de variável de modelo no Grafana denominado *Filtros ad hoc*. Essa variável será aplicada a *todas* as consultas do Datadog em um dashboard. Isso permite usá-lo como um filtro rápido. Uma variável ad hoc para o Datadog busca todos os pares de chave/valor das tags, por exemplo, `region:east, region:west`, e os usa como tags de consulta. Para criar essa variável, selecione o tipo de *filtros ad hoc* e escolha a fonte de dados Datadog. Você pode definir qualquer nome para essa variável.