View a markdown version of this page

Conectar-se a uma fonte de dados Datadog - Amazon Managed Grafana

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

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.

Usage

Armazenamento em cache

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

É 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

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

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

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. Multi-valuevariáveis são suportadas ao usar tags - vários valores de tag selecionados serão convertidos em uma lista de tags separada por vírgulas.

Ad-hoc filtros

Há um novo tipo especial de variável de modelo no Grafana chamado Ad-hoc filtros. 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 Ad-hoc filtro e escolha sua fonte de dados do Datadog. Você pode definir qualquer nome para essa variável.