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 Dynatrace
Fonte de dados para [https://www.dynatrace.com/](https://www.dynatrace.com). Para usar essa fonte de dados, você deve ter uma conta do Dynatrace.
**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).
**Limitações conhecidas**
As variáveis do modelo não podem ser selecionadas várias vezes. Somente a seleção única é compatível.
Somente a métrica v2 APIs é suportada.
## Recursos
### Atributos principais
+ Variáveis do modelo
+ Nomes de métricas
+ Somente seleção única (**sem seleção múltipla**)
+ Filtros ad hoc
+ Anotações
+ Nenhum suporte no momento.
+ Aliases
+ Nomes de métricas
+ Agregação
+ Nome de exibição
+ Host
+ Description
+ Geração de alertas
+ Suporte completo para alertas
### Características específicas do Dynatrace
Compatível com métricas integradas e personalizadas usando a API de métricas v2 do Dynatrace. Para obter mais informações, consulte a documentação do Dynatrace: [Metrics API v2](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/) e [Metric ingestion](https://www.dynatrace.com/support/help/how-to-use-dynatrace/metrics/metric-ingestion/).
Dependendo da métrica, a API pode ser compatível com opções adicionais de transformação.
## Permissões do Dynatrace
Você precisará das seguintes permissões no Dynatrace: Ler métricas usando a API V2 (metrics.read) e Ler entidades usando a permissão a API V2 (entities.read).
## Obter uma chave de API do Dynatrace
Para configurar um token de API, consulte [Dynatrace API - Tokens and authentication](https://www.dynatrace.com/support/help/dynatrace-api/basics/dynatrace-api-authentication/?api-token%3C-%3Epersonal-access-token=api-token).
Defina as permissões `metrics.read` e `entities.read` para o token da API.
### Configuração
1. Escolha **Configurações/Fontes de dados** na interface de usuário do servidor Grafana lógico e escolha **Adicionar fonte de dados**.
1. Na página **Adicionar fonte de dados**, filtre por **Dynatrace** e selecione o plug-in do Dynatrace.
1. A configuração de uma fonte de dados Dynatrace requer os seguintes parâmetros:
+ `Name`: o nome que você deseja aplicar à fonte de dados Dynatrace (padrão: Dynatrace).
+ `Dynatrace API Type`: o tipo de instância do Dynatrace à qual você está se conectando. É `SaaS` ou `Managed Cluster`.
+ `Dynatrace API Token`: este é o token da API que você gerou na etapa anterior.
As próximas duas configurações dependem de você ser Dynatrace SaaS ou gerenciado.
+ Em um exemplo de SaaS de `yfc55578.live.dynatrace.com`, o **ID do ambiente** seria `yfc55578`.
+ No exemplo gerenciado de `yd8888.managed-sprint.dynalabs.io/e/abc99984-3af2-55tt-72kl-0672983gc45`, o **ID de ambiente** seria `abc99984-3af2-55tt-72kl-0672983gc45` e o **Domínio** seria `yd8888.managed-sprint.dynalabs.io`.
1. Depois que todos os valores de configuração tiverem sido definidos, escolha **Salvar e testar** para validar a configuração e salvar as alterações.
### Consultar a fonte de dados
Use o editor de consultas para consultar as métricas e os problemas do Dynatrace. O tipo de consulta pode ser `metric` ou `problem`.
**Tipo de consulta de métricas**
+ `Metric`: selecione a métrica que você deseja ver. Para obter a lista de métricas do Dynatrace novamente, escolha o botão **Atualizar**.
+ `Aggregations`: selecione a agregação que você deseja usar para uma métrica específica. Escolha o valor das agregações para alterar o tipo de agregação, ou escolha **\$1** para adicionar outra agregação.
+ `Transformations`: você pode selecionar transformações no editor de consultas. Depois, insira vários parâmetros na transformação selecionada. Atualmente, somente a transformação de mesclagem é compatível. Para obter mais informações sobre transformações de mesclagem, consulte [Transformação de mesclagem](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation).
+ `Filters`: a fonte de dados Dynatrace consulta dinamicamente os filtros apropriados para cada métrica. Para adicionar um filtro, escolha o símbolo **\$1** ao lado do rótulo **Filtros** no editor de consultas do Dynatrace, selecione o campo a ser filtrado, selecione o operador a ser usado e, em seguida, selecione um valor pelo qual filtrar. A fonte de dados Dynatrace permite criar grupos de filtros que você pode unir para criar comparações lógicas complexas. Para a maioria dos casos de uso, os grupos de filtros não são necessários. Ao criar filtros com tags, independentemente da conjunção selecionada, o Dynatrace sempre usará AND. O Dynatrace não é compatível com filtros OR com tags.
+ `Alias`: há dois tipos diferentes de aliases que você encontrará ao usar a fonte de dados Dynatrace. O primeiro é um alias estático. Um alias desse tipo está disponível em cada consulta que você cria, e o nome do alias começa com uma letra minúscula. O segundo é um alias dinâmico, que muda com base na métrica que você está usando na sua consulta, e o nome dele começa com uma letra maiúscula. O plug-in do Dynatrace é compatível com vários aliases diferentes: `Metric Names`, `Aggregation`, `Display Name`, `Host` e `Description`.
| Nome | Valor |
| --- | --- |
| \$1name | embutido: apps.other. keyUserActions. reportedErrorCount.os |
| \$1aggregation | automático,valor |
| \$1displayName | Contagem de erros relatados (por ação de chave do usuário, sistema operacional) [móvel, personalizado] |
**Tipo de consulta de problemas**
+ `Problem Query Type`: selecione um tipo de consulta de problema. Atualmente, apenas o tipo de consulta de problema de feed é compatível. Para obter informações sobre o tipo de consulta com problema de feed, consulte [Transformação de mesclagem](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation).
+ `Status Filter`: filtre os problemas do resultado pelo status.
+ `Impact Filter`: filtre os problemas de resultado pelo nível de impacto.
+ `Severity Filter`: filtre os problemas de resultado pelo nível de severidade.
+ `Expand Details`: inclua eventos relacionados à resposta, se definido.
#### Usar variáveis de modelo
Para adicionar uma nova variável de consulta do Dynatrace, consulte [Adicionar uma nova variável de modelo](variables-types.md#add-a-query-variable). Use sua fonte de dados do Dynatrace como fonte de dados para as seguintes consultas disponíveis:
+ `Query type`: selecione um tipo de consulta. O tipo de consulta associa alguns dados a alguma chave ou descritor.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/dynatrace-AMG-datasource.html)
+ `Regex`: (opcional) filtre qualquer um dos valores retornados da consulta com uma expressão regular.
**nota**
Atualmente, `Multi-value` e `Include All option` não são compatíveis com a fonte de dados Dynatrace.
Depois de criar uma variável, você pode encontrá-la no menu suspenso **Métrica**.
##### Importar um dashboard para o Dynatrace
Para importar um dashboard, consulte [Importar um dashboard](dashboard-export-and-import.md#importing-a-dashboard). Os dashboards importados podem ser encontrados em **Configuração** > **Fontes de dados** > selecione a fonte de dados Dynatrace > selecione a guia **Dashboards** para ver os dashboards predefinidos disponíveis.