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á.
# Painéis e visualizações do Grafana versão 9
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
O *painel* é o componente básico da visualização no Grafana. Cada painel tem um editor de consultas específico para a fonte de dados selecionada no painel. O editor de consultas permite criar uma consulta que retorna os dados que você deseja visualizar.
Há uma grande variedade de opções de estilo e formatação para cada painel. Os painéis podem ser arrastados, soltos e redimensionados para que sejam reorganizados no dashboard.
Antes de adicionar um painel, verifique se configurou uma fonte de dados.
Tipos de painéis adicionais podem estar disponíveis ao instalar [plug-ins](grafana-plugins.md) adicionais no espaço de trabalho.
+ Para obter detalhes sobre usar fontes de dados específicas, consulte [Conectar-se à fonte de dados](AMG-data-sources.md).
**Topics**
+ [Visão geral do editor de painéis](v9-panels-editor-overview.md)
+ [Configurar as opções do painel](v9-panels-configure-panel-options.md)
+ [Configurar opções padrão](v9-panels-configure-standard-options.md)
+ [Consultar e transformar de dados](v9-panels-query-xform.md)
+ [Configurar limites](v9-panels-configure-thresholds.md)
+ [Configurar links de dados](v9-panels-configure-data-links.md)
+ [Configurar substituições de campos](v9-panels-configure-overrides.md)
+ [Configurar mapeamentos de valores](v9-panels-configure-value-mappings.md)
+ [Configurar uma legenda](v9-panels-configure-legend.md)
+ [Tipos de cálculos](v9-panels-calculation-types.md)
+ [Anotar as visualizações](v9-panels-annotate-visualizations.md)
+ [A visualização de inspeção do painel](v9-panels-panel-inspector.md)
+ [Visualizações disponíveis no Grafana versão 9](v9-panels-viz.md)
# Visão geral do editor de painéis
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
Esta seção descreve as áreas do editor do painel do Grafana.
+ Cabeçalho do painel: a seção do cabeçalho lista o dashboard no qual o painel aparece e os seguintes controles:
+ **Ícone de configurações (engrenagem) do dashboard:** clique para acessar as configurações do dashboard.
+ **Descartar:** descarta as alterações feitas no painel desde a última vez que você salvou o dashboard.
+ **Salvar**: salva as alterações que você fez no painel.
+ **Aplicar:** aplica as alterações feitas e fecha o editor do painel, retornando ao dashboard. Você precisará salvar o dashboard para persistir nas alterações aplicadas.
+ Pré-visualização: a seção de pré-visualização contém as seguintes opções:
+ **Visualização em tabela:** converta qualquer visualização em uma tabela para que você possa ver os dados. As visualizações em tabela são úteis para a solução de problemas. Essa visualização contém somente os dados brutos. Ela não inclui as transformações que você possa ter aplicado aos dados ou às opções de formatação disponíveis na visualização [Tabela](v9-panels-table.md).
+ **Preencher:** a pré-visualização preenche o espaço disponível. Se você alterar a largura do painel lateral ou a altura do painel inferior, a visualização será alterada para preencher o espaço disponível.
+ **Real:** a pré-visualização terá o tamanho exato do dashboard. Se não houver espaço suficiente disponível, a visualização reduzirá a escala verticalmente preservando a proporção.
+ **Controles de intervalo de tempo:** o **padrão** é o fuso horário local do navegador ou o fuso horário selecionado em um nível superior.
+ Seção de dados: a seção de dados contém guias nas quais você insere consultas, transforma os dados e cria regras de alerta (se aplicável).
+ **Guia Consulta:** selecione a fonte de dados e insira as consultas aqui.
+ **Aba Transformar:** aplique transformações de dados.
+ **Aba Alerta:** escreva regras de alerta.
+ Opções de exibição do painel: a seção de opções de exibição contém guias nas quais você configura quase todos os aspectos da visualização de dados.
## Abrir o quadro de inspeção do painel
O quadro de inspeção ajuda você a entender e solucionar problemas nos painéis. Você pode visualizar os dados brutos de qualquer painel, exportar esses dados para um arquivo de valores separados por vírgula (CSV), visualizar solicitações de consulta e exportar painéis e dados JSON.
**Observação:** nem todos os tipos de painel incluem todas as guias. Por exemplo, os painéis da lista de dashboards não têm dados brutos para inspecionar e, portanto, não exibem as guias Estatísticas, Dados ou Consulta.
O inspetor do painel consiste nas seguintes opções:
+ As telas do quadro de inspeção do painel abrem um quadro no lado direito. Clique na seta no canto superior direito para expandir ou reduzir o painel do quadro.
+ **Guia Dados:** mostra os dados brutos retornados pela consulta com as transformações aplicadas. As opções de campo, como substituições e mapeamentos de valores, não são aplicadas por padrão.
+ **Aba Estatísticas:** mostra quanto tempo sua consulta leva e o quanto ela retorna.
+ **Aba JSON:** permite que você visualize e copie o painel JSON, dados do painel JSON e a estrutura de quadros de dados JSON. Isso é útil se você estiver provisionando ou administrando o Grafana.
+ **Guia Consulta:** mostra as solicitações enviadas ao servidor quando o Grafana consulta a fonte de dados.
+ **Aba Erro:** mostra o erro. Visível somente quando a consulta retorna um erro.
# Configurar as opções do painel
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
Um painel do Grafana é a interface de usuário que você usa para definir uma consulta de fonte de dados e transformar e formatar dados que aparecem nas visualizações.
Um editor de painéis inclui um construtor de consultas e uma série de opções que você pode usar para transformar dados e adicionar informações aos painéis.
Este tópico descreve como:
+ Abrir um painel para edição
+ Adicionar uma descrição e um título do painel
+ Visualizar um modelo de painel JSON
+ Adicionar linhas e painéis repetidos
## Editar um painel
Depois de adicionar um painel a um dashboard, você pode abri-lo a qualquer momento para alterar ou atualizar consultas, adicionar transformação de dados e alterar as configurações de visualização.
1. Abra o dashboard que contém o painel que você deseja editar.
1. Passe o mouse sobre qualquer parte do painel para exibir o menu de ações no canto superior direito.
1. Clique no menu e selecione **Editar**.
Para usar um atalho de teclado para abrir o painel, passe o mouse sobre o painel e pressione **e**.
O painel será aberto no modo de edição.
## Adicionar um título e uma descrição a um painel
Adicione um título e uma descrição a um painel para compartilhar com os usuários qualquer informação importante sobre a visualização. Por exemplo, use a descrição para documentar a finalidade da visualização.
1. Edite um painel.
1. No painel de opções de exibição do painel, localize a seção **Opções do painel**.
1. Insira um **Título**.
O texto inserido nesse campo aparece na parte superior do painel no editor de painéis e no dashboard.
1. Escreva uma descrição do painel e dos dados que você está exibindo.
O texto inserido nesse campo aparece em uma dica de ferramenta no canto superior esquerdo do painel.
Você pode usar as [variáveis que você definiu](v9-dash-variables.md) no campo **Título** e **Descrição**, mas não as [variáveis globais](v9-dash-variable-add.md#v9-dash-variable-add-global).
## Visualizar um modelo de painel JSON
Explore e exporte modelos JSON de painel, dados de painel e quadro de dados.
1. Abra o dashboard que contém o painel.
1. Passe o mouse sobre qualquer parte do painel para exibir o menu de ações no canto superior direito.
1. Clique no menu e selecione **Inspecionar > Painel JSON**.
1. No campo **Selecionar origem**, selecione uma das opções a seguir:
+ **Painel JSON:** exibe um objeto JSON representando o painel.
+ **Dados do painel:** exibe um objeto JSON representando os dados que foram passados para o painel.
+ **DataFrame estrutura:** exibe o conjunto de resultados brutos com transformações, configurações de campo e configurações de substituição aplicadas.
1. Para explorar o JSON, clique em **>** para expandir ou recolher partes do modelo JSON.
## Configurar painéis repetidos
Você pode configurar o Grafana para adicionar dinamicamente painéis ou linhas a um dashboard. Um painel dinâmico é um painel que o sistema cria com base no valor de uma variável. As variáveis alteram dinamicamente as consultas em todos os painéis em um dashboard.
**nota**
Painéis repetidos exigem que as variáveis tenham um ou mais itens selecionados. Você não pode repetir um painel zero vez para ocultá-lo.
**Antes de começar**
+ Certifique-se de que a consulta inclua uma variável de vários valores.
**Para configurar painéis repetidos:**
1. Edite o painel que você deseja repetir.
1. No painel de opções de exibição, clique em **Opções do painel > Opções de repetição**.
1. Selecione uma **direção**.
+ Escolha **horizontal** para organizar os painéis side-by-side. O Grafana ajusta a largura de um painel repetido. Atualmente, você não pode misturar outros painéis em uma linha com um painel repetido.
+ Escolha **vertical** para organizar os painéis em uma coluna. A largura dos painéis repetidos é a mesma do painel original repetido.
1. Para propagar as alterações em todos os painéis, recarregue o dashboard.
# Configurar opções padrão
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
O modelo de dados usado no Grafana é uma estrutura de tabela orientada por colunas que unifica as séries temporais e os resultados da tabela da consulta. Cada coluna dentro dessa estrutura é chamada de *campo*. Um campo pode representar uma única série temporal ou coluna de tabela.
As opções de campo permitem que você altere a forma como os dados são exibidos nas visualizações. As opções e substituições que você aplica não alteram os dados, elas alteram a forma como o Grafana exibe os dados. Quando você altera uma opção, ela é aplicada a todos os campos, ou seja, a todas as séries ou colunas. Por exemplo, se você alterar a unidade para porcentagem, então todos os campos com valores numéricos serão exibidos em porcentagens.
Para obter uma lista completa das opções de formatação de campo, consulte [Definições de opções padrão](#v9-panels-standard-options-definitions).
**nota**
Você pode aplicar opções padrão à maioria dos painéis integrados do Grafana. Alguns painéis antigos e painéis comunitários que não foram atualizados para o novo painel e modelo de dados perderão todas ou algumas dessas opções de campo.
1. Abra um dashboard, clique no título do painel e depois em **Editar**.
1. No painel de opções de exibição do painel, localize a seção **Opções padrão**.
1. Selecione as opções padrão que você deseja aplicar.
1. Para pré-visualizar sua alteração, clique fora da caixa de opção de campo que você está editando ou pressione **Enter**.
## Definições de opções padrão
Esta seção explica todas as opções padrão disponíveis.
Você pode aplicar opções padrão à maioria dos painéis integrados do Grafana. Alguns painéis antigos e painéis comunitários que não foram atualizados para o novo painel e modelo de dados perderão todas ou algumas dessas opções de campo.
A maioria das opções de campo não afetará a visualização até você clicar fora da caixa de opções de campo que você está editando ou pressionar Enter.
**nota**
Estamos trabalhando constantemente para adicionar e expandir as opções para todas as visualizações, portanto, nem todas as opções podem estar disponíveis para todas as visualizações.
### Unidade
Permite escolher qual unidade um campo deve usar. Clique no campo **Unidade** e, em seguida, faça uma busca detalhada até encontrar a unidade desejada. A unidade selecionada é aplicada a todos os campos, exceto a hora.
#### Unidades personalizadas
Você pode usar o menu suspenso de unidades para também especificar unidades personalizadas, prefixo ou sufixo personalizado e formatos de data e hora.
Para selecionar uma unidade personalizada, insira a unidade e selecione a última opção **Personalizado: xxx** no menu suspenso.
+ **sufixo:** para a unidade personalizada que deve vir depois do valor.
+ **prefixo:** para a unidade personalizada que deve vir antes do valor.
+ **hora:** para formatos de data e hora personalizados, digite, por exemplo, **hora:DD-MM-AAA**. Consulte [formatos](https://momentjs.com/docs/#/displaying/) para ver a sintaxe e as opções de formato.
+ **si:** para unidades SI personalizadas. Por exemplo: **si: mF**. Este é um pouco mais avançado, pois você pode especificar uma unidade e a escala de dados de origem. Portanto, se seus dados de origem forem representados como mili (milhares de) de alguma coisa, prefixe a unidade com o caractere de escala SI.
+ **contagem:** para uma unidade de contagem personalizada.
+ **moeda:** para personalizar uma unidade monetária.
Você também pode colar um emoji nativo no seletor de unidades e selecioná-lo como uma unidade personalizada.
#### Unidades de string
O Grafana às vezes pode ser muito radical ao analisar strings e exibi-las como números. Para configurar o Grafana para mostrar o valor da string original, crie uma substituição de campo e adicione uma propriedade de unidade com a unidade **String**.
### Mín.
Permite definir o valor mínimo usado nos cálculos do limite percentual. Deixe em branco para o cálculo automático com base em todas as séries e campos.
### Máx
Permite definir o valor máximo usado nos cálculos do limite percentual. Deixe em branco para o cálculo automático com base em todas as séries e campos.
### Decimais
Especifique o número de decimais que o Grafana inclui no valor renderizado. Se você deixar esse campo em branco, o Grafana truncará automaticamente o número de decimais com base no valor. Por exemplo, 1,1234 será exibido como 1,12, e 100,456 será exibido como 100.
Para exibir todos os decimais, defina a unidade como **String**.
### Nome de exibição
Permite definir o título de exibição de todos os campos. Você pode usar [variáveis](v9-dash-variables.md).
Quando várias estatísticas, campos ou séries são mostrados, esse campo controla o título em cada estatística. Você pode usar expressões como **\$1\$1\$1\$1field.name\$1** para usar somente o nome da série ou o nome do campo no título.
Fornecido um campo com o nome Temp e rótulos de \$1"Loc"="PBI", "Sensor"="3"\$1
| Sintaxe da expressão | Exemplo | Renderiza para | Explicação |
| --- | --- | --- | --- |
| \$1\$1\$1\$1field.displayName\$1 | O mesmo que a sintaxe | Temp \$1Loc="PBI", Sensor="3"\$1 | Exibe o nome do campo e os rótulos em \$1\$1, se estiverem presentes. Se houver apenas uma chave de rótulo na resposta, então, para a parte do rótulo, o Grafana exibirá o valor dele sem as chaves delimitadoras. |
| \$1\$1\$1\$1field.name\$1 | O mesmo que a sintaxe | Temp | Exibe o nome do campo (sem rótulos). |
| \$1\$1\$1\$1field.labels\$1 | O mesmo que a sintaxe | Loc="PBI", Sensor="3" | Exibe os rótulos sem o nome. |
| \$1\$1\$1\$1field.labels.X\$1 | \$1\$1\$1\$1field.labels.Loc\$1 | PBI | Exibe o valor da chave de rótulo especificada. |
| \$1\$1\$1\$1field.labels.\$1\$1values\$1 | O mesmo que a sintaxe | PBI, 3 | Exibe os valores dos rótulos separados por uma vírgula (sem as chaves do rótulo). |
Se o valor for uma string vazia após renderizar a expressão para um campo específico, então o método de exibição padrão será usado.
### Esquema de cores
As opções de cores e seus efeitos na visualização dependem da visualização com a qual você está trabalhando. Algumas visualizações têm opções de cores diferentes.
Você pode especificar uma única cor ou selecionar um esquema de cores contínuo (gradiente), com base em um valor. A cor contínua interpola uma cor usando a porcentagem de um valor em relação ao mínimo e ao máximo.
Selecione uma das seguintes paletas:
| Modo de cor | Description |
| --- | --- |
| Cor única | Especifique uma única cor, útil em uma regra de substituição |
| Nos limites | Informa o Grafana para retirar a cor do limite correspondente |
| Paleta clássica | O Grafana atribuirá cores pesquisando uma cor em uma paleta por índice de série. Útil para grafos e diagramas de pizza e outras visualizações de dados categóricos |
| Green-Yellow-Red (por valor) | Esquema de cores contínuo |
| Blue-Yellow-Red (por valor) | Esquema de cores contínuo |
| Azuis (por valor) | Esquema de cores contínuo (fundo do painel em azul) |
| Vermelhos (por valor) | Esquema de cores contínuo (cor de fundo do painel em azul) |
| Verdes (por valor) | Esquema de cores contínuo (cor de fundo do painel em azul) |
| Roxo (por valor) | Esquema de cores contínuo (cor de fundo do painel em azul) |
### Nenhum valor
Insira o que o Grafana deverá exibir quando o valor do campo estiver vazio ou for nulo. O valor padrão é um hífen (-).
# Consultar e transformar de dados
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
O Grafana é compatível com vários tipos de [fontes de dados](AMG-data-sources.md). As *consultas* às fontes de dados retornam dados que o Grafana pode *transformar* e visualizar. Cada fonte de dados usa sua própria linguagem de consulta, e cada plug-in de fonte de dados implementa uma interface de usuário de criação de consultas chamada editor de consultas.
## Sobre consultas
Os painéis do Grafana se comunicam com as fontes de dados por meio de consultas, que recuperam dados para a visualização. Uma consulta é uma pergunta escrita na linguagem de consulta usada pela fonte de dados.
Você pode configurar a frequência de consultas e os limites de coleta de dados nas opções da fonte de dados do painel. O Grafana é compatível com até 26 consultas por painel.
Você pode encontrar mais informações sobre cada linguagem de consulta da fonte de dados na seção [Fontes de dados](AMG-data-sources.md).
**Editores de consultas**
Cada *editor de consultas* da fonte de dados fornece uma interface de usuário personalizada que ajuda você a escrever consultas que aproveitam seus recursos exclusivos.
Devido às diferenças entre as linguagens de consulta, cada editor de consultas da fonte de dados tem um formato e funciona de forma diferente. Dependendo da fonte de dados, o editor de consultas pode fornecer recursos de preenchimento automático, nomes de métricas, sugestões de variáveis ou uma interface visual de criação de consultas.
Para obter detalhes sobre os recursos exclusivos do editor de consultas de uma fonte de dados específica, consulte sua documentação:
+ Para fontes de dados incluídas no Grafana, consulte [Fontes de dados integradas](AMG-data-sources-builtin.md).
+ Para fontes de dados incluídas na edição Grafana Enterprise, consulte [Conectar-se às fonte de dados Enterprise](AMG-data-sources-enterprise.md).
**Sintaxe de consulta**
As fontes de dados usam linguagens de consulta diferentes para solicitar dados. Para obter detalhes sobre a linguagem de consulta exclusiva de uma fonte de dados específica, consulte sua documentação.
**Exemplo de PostgreSQL:**
```
SELECT hostname FROM host WHERE region IN($region)
```
**Exemplo de PromQL:**
```
query_result(max_over_time([${__range_s}s]) != )
```
**Fontes de dados especiais**
O Grafana também inclui três fontes de dados especiais: **Grafana**, **Mista** e **Dashboard.** Para obter mais detalhes, consulte Fontes de dados
## Navegue pela guia de consulta
A guia **Consulta** de um painel consiste nos seguintes elementos:
+ **Seletor de fonte de dados**: seleciona a fonte de dados a ser consultada.
+ **Opções de consulta:** define parâmetros máximos de recuperação de dados e intervalos de tempo de execução da consulta.
+ **Botão do inspetor de consultas:** abre o painel do Inspetor de consultas, no qual você pode visualizar e otimizar a consulta.
+ **Lista do editor de consultas:** lista as consultas que você escreveu.
+ **Expressões:** usa o construtor de expressões para criar expressões de alerta. Para obter mais informações sobre expressões, consulte [Gravar consultas de expressão](v9-panels-query-xform-expressions.md).
## Adicionar uma consulta
Uma consulta retorna dados que o Grafana visualiza nos painéis do dashboard. Quando você cria um painel, o Grafana seleciona automaticamente a fonte de dados padrão.
**Para adicionar uma consulta**
1. Edite o painel ao qual você está adicionando uma consulta.
1. Escolha a guia **Queries** (Consultas).
1. Escolha o menu suspenso **Fonte de dados** e selecione uma fonte de dados.
1. Escolha **Opções de consulta** para configurar o número máximo de pontos de dados necessários. Para obter mais informações sobre essas opções, consulte [Opções de consulta](#v9-panels-query-xform-options).
1. Escreva a consulta usando o editor de consultas.
1. Escolha **Aplicar**.
O Grafana consulta a fonte de dados e visualiza os dados.
## Gerenciar consultas
O Grafana organiza as consultas em linhas de consulta recolhíveis. Cada linha de consulta contém um editor de consultas e é identificada com uma letra (A, B, C e assim por diante).
Para gerenciar suas consultas, você pode copiar consultas, ocultar consultas, remover uma consulta, reordenar consultas e alternar a ajuda para o editor de consultas.
## Opções de consulta
Escolha **Opções de consulta** ao lado do seletor da fonte de dados para ver as configurações da fonte de dados selecionada. As alterações feitas aqui afetam somente as consultas feitas nesse painel.
O Grafana define padrões que são mostrados em texto cinza escuro. As alterações são exibidas em texto na cor branca. Para retornar um campo à configuração padrão, exclua o texto na cor branca do campo.
As opções de consulta da fonte de dados do painel incluem:
+ **Máximo de pontos de dados**: se a fonte de dados for compatível, isso definirá o número máximo de pontos de dados para cada série retornada. Se a consulta retornar mais pontos de dados do que a configuração máxima de pontos de dados, a fonte de dados reduzirá o número de pontos retornados ao agregá-los por média, máximo ou outra função.
Você pode limitar o número de pontos para melhorar a performance da consulta ou suavizar a linha visualizada. O valor padrão é a largura (ou o número de pixels) do grafo, porque você só pode visualizar a quantidade de pontos de dados que o painel de grafo tem espaço para exibir.
Com dados de streaming, o Grafana usa o valor máximo de pontos de dados para o buffer contínuo. O streaming é um fluxo contínuo de dados, e o buffer divide o fluxo em blocos. Por exemplo, o Loki transmite dados no modo Live Tailing.
+ **Intervalo mínimo**: define um limite mínimo para o intervalo calculado automaticamente, que normalmente é o intervalo mínimo de extração. Se um ponto de dados for salvo a cada 15 segundos, você não se beneficiará de ter um intervalo menor do que isso. Você também pode definir para um mínimo maior do que o intervalo de extração para recuperar consultas mais simplificadas e funcionais.
+ **Intervalo**: define um intervalo de tempo que você pode usar ao agregar ou agrupar pontos de dados por tempo.
O Grafana calcula automaticamente um intervalo apropriado que você pode usar como variável em consultas modeladas. A variável é medida em segundos (`$__interval`) ou milissegundos (`$__interval_ms`).
Os intervalos são normalmente usados em funções de agregação, como soma ou média. Por exemplo, esta é uma consulta do Prometheus que usa a variável de intervalo: `rate(http_requests_total[$__interval])`.
Esse intervalo automático é calculado com base na largura do grafo. Conforme o usuário diminui o zoom em uma visualização, o intervalo aumenta, resultando em uma agregação mais simplificada. Da mesma forma, se o usuário aumentar o zoom, o intervalo diminuirá, resultando em uma agregação mais refinada.
Para obter mais informações, consulte [Variáveis globais](v9-dash-variable-add.md#v9-dash-variable-add-global).
+ **Tempo relativo**: substitui o intervalo de tempo relativo para painéis individuais, o que faz com que eles sejam diferentes do que está selecionado no seletor de tempo do dashboard no canto superior direito do dashboard. Você pode usar isso para mostrar métricas de diferentes períodos ou dias no mesmo dashboard.
**nota**
As substituições de tempo do painel não têm efeito quando o intervalo de tempo do dashboard é absoluto.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/v9-panels-query-xform.html)
+ **Mudança de tempo**: substitui o intervalo de tempo de painéis individuais ao mudar o início e o fim em relação ao seletor de tempo. Por exemplo, você pode alterar o intervalo de tempo do painel para duas horas antes do seletor de tempo do dashboard.
**nota**
As substituições de tempo do painel não têm efeito quando o intervalo de tempo do painel é absoluto.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/v9-panels-query-xform.html)
+ **Tempo limite de cache**: *(visível somente se disponível na fonte de dados)* substituirá o tempo limite de cache padrão se seu armazenamento de séries temporais tiver um cache de consulta. Especifique este valor como um valor numérico em segundos.
# Gravar consultas de expressão
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
As expressões do servidor permitem que você manipule os dados retornados de consultas com operações matemáticas e outras. As expressões criam novos dados e não manipulam os dados retornados pelas fontes de dados.
## Sobre expressões
As expressões do servidor permitem que você manipule dados retornados de consultas com operações matemáticas e outras. As expressões criam novos dados e não manipulam os dados retornados pelas fontes de dados, exceto por uma pequena reestruturação de dados para tornar os dados uma entrada aceitável para expressões.
**Usar expressões**
As expressões são usadas principalmente pelo [Grafana Alerting](v9-alerts.md). O processamento é feito no servidor para que as expressões possam operar sem uma sessão do navegador. No entanto, as expressões também podem ser usadas com fontes de dados de backend e visualização.
**nota**
As expressões não funcionam com alertas legados do dashboard.
As expressões têm como objetivo aumentar as fontes de dados, permitindo que consultas de diferentes fontes de dados sejam combinadas ou fornecendo operações indisponíveis em uma fonte de dados.
**nota**
Quando possível, você deve fazer o processamento de dados dentro da fonte de dados. Copiar dados do armazenamento para o servidor Grafana para processamento é ineficiente, portanto, as expressões são direcionadas ao processamento leve de dados.
As expressões funcionam com consultas de fontes de dados que retornam dados numéricos ou de séries temporais. Eles também operam com [dados multidimensionais](getting-started-grafanaui.md#time-series-dimensions). Por exemplo, uma consulta que retorna várias séries, em que cada série é identificada por rótulos ou tags.
Uma expressão individual usa uma ou mais consultas ou outras expressões como entrada e adiciona dados ao resultado. Cada expressão ou consulta individual é representada por uma variável que é um identificador nomeado conhecido como RefID (por exemplo, a letra padrão `A` ou `B`).
Para referenciar a saída de uma expressão individual ou de uma consulta de fonte de dados em outra expressão, esse identificador é usado como uma variável.
**Tipos de expressões**
As expressões funcionam com dois tipos de dados.
+ Uma coleção de séries temporais.
+ Uma coleção de números, em que cada número é um item.
Cada coleção é retornada de uma única consulta ou expressão de fonte de dados e é representada pelo RefID. Cada coleção é um conjunto, em que cada item do conjunto é identificado exclusivamente por suas dimensões, que são armazenadas como [rótulos](getting-started-grafanaui.md#labels) ou pares de chave/valor.
**Consultas de fonte de dados**
As expressões do servidor só são compatíveis com consultas de fontes de dados para fontes de dados de backend. Geralmente, presume-se que os dados sejam rotulados como dados de séries temporais. No futuro, pretendemos adicionar uma declaração dos dados do tipo de retorno da consulta (número ou série temporal) para que as expressões possam lidar melhor com os erros.
As consultas à fonte de dados, quando usadas com expressões, são executadas pelo mecanismo de expressão. Ao fazer isso, ele reestrutura os dados para serem uma série temporal ou um número por quadro de dados. Então, por exemplo, se estiver usando uma fonte de dados que retorna várias séries em um quadro na exibição de tabela, você perceberá que ela parece diferente quando executada com expressões.
Atualmente, o único formato de série não temporal (número) compatível com o uso de quadros de dados é o que você tem uma resposta de tabela que retorna um quadro de dados sem hora, colunas de strings e uma coluna numérica:
| Loc | Host | Avg\$1CPU |
| --- | --- | --- |
| MIA | A | 1 |
| NYC | B | 2 |
O exemplo acima produzirá um número que funciona com expressões. As colunas de strings tornam-se rótulos e a coluna numérica o valor correspondente. Por exemplo, `{"Loc": "MIA", "Host": "A"}` com um valor de 1.
**Operações**
Você pode usar as seguintes operações em expressões: matemática, reduzir e reamostrar.
**Math**
Matemática é para fórmulas matemáticas de formato livre em séries temporais ou dados numéricos. As operações matemáticas usam números e séries temporais como entrada e os alteram para outros números e séries temporais.
Os dados de outras consultas ou expressões são referenciados com o RefID prefixado com um cifrão, por exemplo, `$A`. Se a variável tiver espaços no nome, você poderá usar uma sintaxe entre chaves, como `${my variable}`.
As constantes numéricas podem estar em decimal (`2.24`), octal (com um zero à esquerda, como `072`) ou hexadecimal (com um 0x à esquerda, como `0x2A`). Exponenciais e sinais também são compatíveis (por exemplo, `-0.8e-2`).
**Operadores**
Os operadores aritméticos (`+`, binários e unários `-`, `*`, `/`, `%`, expoente `**`), relacionais (`<`, `>`, `==`, `!=`, `>=`, `<=`) e lógicos (`&&`, `||` e unários `!`) são compatíveis.
A forma como a operação se comporta com os dados depende se são dados numéricos ou de séries temporais.
Com operações binárias, como `$A + $B` ou `$A || $B`, o operador é aplicado das seguintes maneiras, dependendo do tipo de dados:
+ Se `$A` e `$B` forem um número, a operação será executada entre os dois números.
+ Se uma variável for um número e a outra variável for uma série temporal, a operação entre o valor de cada ponto na série temporal e o número será executada.
+ Se `$A` e `$B` forem dados de séries temporais, a operação entre cada valor nas duas séries será executada para cada carimbo de data e hora existente tanto em `$A` quanto em `$B`. A operação `Resample` pode ser usada para alinhar carimbos de data e hora.
Resumo:
+ Número OP número = número
+ Número OP série = série
+ Série OP série = série
Como as expressões funcionam com várias séries ou números representados por uma única variável, as operações binárias também realizam uma união (junção) entre as duas variáveis. Isso é feito com base nos rótulos de identificação associados a cada série ou número individual.
Portanto, se você tiver números com rótulos como `{host=web01}` em `$A` e outro número em `$B` com os mesmos rótulos, a operação será executada entre esses dois itens em cada variável, e o resultado compartilhará os mesmos rótulos. As regras para o comportamento dessa união são as seguintes:
+ Um item sem rótulos se juntará a qualquer coisa.
+ Se `$A` e `$B` contiverem, cada um, apenas um item (uma série ou um número), eles se unirão.
+ Se os rótulos forem matematicamente exatos, eles se juntarão.
+ Se os rótulos forem um subconjunto um do outro, por exemplo, se um item em `$A` for rotulado `{host=A,dc=MIA}` e um item em `$B` for rotulado `{host=A}`, eles serão unidos.
+ Se dentro de uma variável, como `$A`, houver chaves de tag diferentes para cada item, o comportamento da junção será indefinido.
Os operadores lógicos e relacionais retornam 0 para false 1 para true.
**Funções matemáticas**
Embora a maioria das funções exista nas próprias operações de expressão, a operação matemática tem algumas funções semelhantes aos operadores ou símbolos matemáticos. Quando as funções podem receber números ou séries, o mesmo tipo do argumento será retornado. Quando é uma série, a operação é executada para o valor de cada ponto na série.
*abs*
abs retorna o valor absoluto de seu argumento, que pode ser um número ou uma série. Por exemplo, `abs(-1)` ou `abs($A)`.
*is\$1inf*
is\$1inf pega um número ou uma série e retorna `1` para valores `Inf` (negativos ou positivos) e `0` para outros valores. Por exemplo, `is_inf($A)`.
**nota**
Se você precisar verificar especificamente o infinito negativo, por exemplo, você pode fazer uma comparação como `$A == infn()`.
*is\$1nan*
is\$1nan pega um número ou uma série e retorna `1` para valores `NaN` e `0` para outros valores. Por exemplo, `is_nan($A)`. Essa função existe porque `NaN` não é igual a `NaN`.
*is\$1null*
is\$1null pega um número ou uma série e retorna `1` para valores `null` e `0` para outros valores. Por exemplo, `is_null($A)`.
*is\$1number*
is\$1number pega um número ou uma série e retorna `1` para todos os valores de números reais e `0` para outros valores (que são `null`, `Inf+`, `Inf-` e `NaN`). Por exemplo, `is_number($A)`.
*log*
Log retorna o logaritmo natural de seu argumento, que pode ser um número ou uma série. Se o valor for menor que 0, `NaN` será retornado. Por exemplo, `log(-1)` ou `log($A)`.
*inf, infn, nan e null*
Todas as funções inf, infn, nan e null retornam um único valor do nome. Eles existem principalmente para testes. Exemplo: `null()`.
*round*
Round retorna um valor inteiro arredondado. Por exemplo, `round(3.123)` ou `round($A)`.
*ceil*
Ceil arredonda o número até o valor inteiro mais próximo. Por exemplo, `ceil(3.123)` exibe `4`.
*floor*
Floor arredonda o número para baixo até o valor inteiro mais próximo. Por exemplo, `floor(3.123`) retorna `3`.
**Reduzir**
Reduzir usa uma ou mais séries temporais retornadas de uma consulta ou expressão e transforma cada série em um único número. Os rótulos da série temporal são mantidos como rótulos em cada número reduzido gerado.
*Campos:*
+ **Função**: a função de redução a ser usada
+ **Entrada**: a variável (refID [como `A`]) a ser reamostrada
+ **Modo**: permite o comportamento de controle da função de redução quando uma série contém valores não numéricos (null, NaN, \$1-Inf)
**Funções de redução**
*Contagem*
A contagem retorna o número de pontos em cada série.
*Média*
A média retorna o total de todos os valores em cada série dividido pelo número de pontos nessa série. No modo `strict`, se algum valor na série for null ou nan, ou se a série estiver vazia, NaN será retornado.
*Min and Max*
Min and Max retornam o menor ou maior valor da série, respectivamente. No modo `strict`, se algum valor na série for null ou nan, ou se a série estiver vazia, NaN será retornado.
*Soma*
Sum retorna o total de todos os valores em uma série. Se a série tiver comprimento zero, a soma será 0. No modo `strict`, se houver algum valor NaN ou Null na série, NaN será retornado.
*Last*
Last retorna o último número da série. Se a série não tiver valores, retorna NaN.
**Modos de redução**
*Estrito*
No modo Estrito, a série de entrada é processada como está. Se algum valor na série não for numérico (null, NaN ou \$1-Inf), NaN será retornado.
*Descartar dados não numéricos*
Nesse modo, todos os valores não numéricos (null, NaN ou \$1-Inf) na série de entrada são filtrados antes de executar a função de redução.
*Substituir não numérico*
Nesse modo, todos os valores não numéricos são substituídos por um valor predefinido.
**Reamostrar**
A reamostragem altera os carimbos de data e hora em cada série temporal para ter um intervalo de tempo consistente. O principal caso de uso é que você possa reamostrar séries temporais que não compartilham os mesmos carimbos de data e hora para que a matemática possa ser executada entre elas. Isso pode ser feito reamostrando cada uma das duas séries e, em seguida, em uma operação matemática referenciando as variáveis reamostradas.
*Campos:*
+ **Input**: a variável de dados de séries temporais (refID [como `A`]) a ser reamostrada
+ **Reamostrar** até: a duração do tempo para reamostrar, por exemplo, `10s.`unidades pode ser `s` segundos, `m` para minutos, `h` para horas, `d` para dias, `w` para semanas e `y` para anos.
+ **Downsample**: a função de redução a ser usada quando há mais de um ponto de dados por amostra de janela. Consulte a operação de redução para obter detalhes sobre o comportamento.
+ **Upsample**: o método a ser usado para preencher uma amostra de janela que não tem pontos de dados.
+ **pad** é preenchido com o último valor conhecido
+ **backfill** com o próximo valor conhecido
+ **preencha para preencher as** janelas de amostra vazias com NaNs
## Escrever uma expressão
Se a fonte de dados for compatível, o Grafana exibirá o botão **Expressão** e mostrará todas as expressões existentes na lista do editor de consultas.
**Para escrever uma expressão**
1. Abra o painel.
1. Abaixo da consulta, escolha **Expressão**.
1. No campo **Operação**, selecione o tipo de expressão que você deseja escrever.
1. Escreva a expressão.
1. Escolha **Aplicar**.
## Casos especiais
Quando qualquer fonte de dados consultada não retorna séries ou números, o mecanismo de expressão retorna `NoData`. Por exemplo, se uma solicitação contiver duas consultas de fonte de dados mescladas por uma expressão, se `NoData` for retornado por pelo menos uma das consultas de fonte de dados, o resultado retornado para toda a consulta será `NoData`. Para obter mais informações sobre como o Grafana Alerting processa os resultados `NoData`, consulte [Lidar com casos de erro e ausência de dados](v9-alerting-managerules-grafana.md#v9-alerting-rule-no-data-error).
# Compartilhar resultados da consulta com outro painel
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
O Grafana permite que você use o resultado da consulta de um painel para qualquer outro painel no dashboard. Compartilhar os resultados da consulta entre painéis reduz o número de consultas feitas à fonte de dados, o que pode melhorar a performance do dashboard.
A fonte de dados Dashboard permite que você selecione um painel no dashboard que contém as consultas para as quais você deseja compartilhar os resultados. Em vez de enviar uma consulta separada para cada painel, o Grafana envia uma consulta e outros painéis usam os resultados da consulta para criar visualizações.
Essa estratégia pode reduzir significativamente o número de consultas feitas quando, por exemplo, você tem vários painéis visualizando os mesmos dados.
**Para compartilhar resultados da consulta**
1. [Crie um dashboard](v9-dash-creating.md).
1. Altere o título para `Source panel`. Você usará este painel como fonte para os outros painéis.
1. Defina a consulta ou as consultas que você deseja compartilhar.
Se você não tiver uma fonte de dados disponível, use a fonte de **TestData**dados, que retorna uma série temporal aleatória que você pode usar para testes.
1. Adicione um segundo painel e selecione a fonte de dados **Dashboard** no editor de consultas.
1. Na **lista Usar resultados do painel**, selecione o primeiro painel que você criou.
Todas as consultas definidas no painel de origem agora estão disponíveis para o novo painel. As consultas feitas no painel de origem podem ser compartilhadas com vários painéis.
Você pode clicar em qualquer uma das consultas para acessar o painel onde elas estão definidas.
# Transformar dados
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
As transformações são uma forma eficaz de manipular dados retornados por uma consulta antes que o sistema aplique uma visualização. Ao usar transformações, você pode:
+ Renomear campos
+ Juntar dados de séries temporais
+ Executar operações matemáticas em todas as consultas
+ Usar a saída de uma transformação como a entrada para outra transformação
Para usuários que dependem de várias visualizações do mesmo conjunto de dados, as transformações oferecem um método eficiente de criar e manter vários dashboards.
Você também pode usar a saída de uma transformação como entrada para outra transformação, o que resulta em um ganho de performance.
**nota**
Às vezes, o sistema não consegue representar graficamente os dados transformados. Quando isso acontecer, clique no botão de alternância **Visualização de tabela** acima da visualização para alternar para uma visualização de tabela dos dados. Ela pode ajudar você a entender o resultado final das transformações.
## Tipos de transformação
O Grafana fornece várias maneiras de transformar dados. Há uma lista completa das funções de transformação abaixo.
## Ordem das transformações
Quando há várias transformações, o Grafana as aplica na ordem em que estão listadas. Cada transformação cria um conjunto de resultados que, em seguida, passa para a próxima transformação no pipeline de processamento.
A ordem na qual o Grafana aplica as transformações afeta diretamente os resultados. Por exemplo, se você usar uma transformação de redução para condensar todos os resultados de uma coluna em um único valor, só poderá aplicar transformações a esse valor único.
## Adicionar uma função de transformação aos dados
As etapas a seguir orientam você a adicionar uma transformação aos dados.
**Para adicionar uma transformação a um painel**
1. Navegue até o painel em que você deseja adicionar uma ou mais transformações.
1. Escolha o título do painel e clique em **Editar**.
1. Escolha a guia **Transform** (Transformação).
1. Escolha uma transformação. Uma linha de transformação aparece onde você configura as opções de transformação.
1. Para aplicar outra transformação, escolha **Adicionar transformação**. Essa transformação atua no conjunto de resultados retornado pela transformação anterior.
## Depurar uma transformação
Para ver os conjuntos de resultados de entrada e saída da transformação, escolha o ícone de bug no lado direito da linha de transformação.
Os conjuntos de resultados de entrada e saída podem ajudar a depurar uma transformação.
## Excluir uma transformação
Recomendamos que você remova transformações que não sejam necessárias. Ao excluir uma transformação, você remove os dados da visualização.
Pré-requisitos:
Identifique todos os dashboards que dependem da transformação e informe seus usuários afetados.
**Para excluir uma transformação**
1. Abra um painel para edição.
1. Escolha a guia **Transform** (Transformação).
1. Selecione o ícone de lixeira ao lado da transformação que você deseja excluir.
## Funções de transformação
Você pode executar as transformações a seguir nos dados.
**Adicionar campo do cálculo**
Use esta transformação para adicionar um novo campo calculado de dois outros campos. Cada transformação permite que você adicione um novo campo.
+ **Modo**: selecione um modo:
+ **Reduzir linha**: aplique o cálculo selecionado em cada linha dos campos selecionados de forma independente.
+ **Opção binária**: aplique uma operação matemática básica (soma, multiplicação etc.) em valores em uma única linha de dois campos selecionados.
+ **Nome do campo**: selecione os nomes dos campos que você deseja usar no cálculo do novo campo.
+ **Cálculo**: se você selecionar o modo **Reduzir linha**, o campo **Cálculo** será exibido. Clique no campo para ver uma lista das opções de cálculo que você pode usar para criar o campo. Para obter informações sobre os cálculos disponíveis, consulte [Tipos de cálculos](v9-panels-calculation-types.md).
+ **Operação**: se você selecionar o modo **Opção binária**, os campos **Operação** serão exibidos. Esses campos permitem que você faça operações matemáticas básicas em valores em uma única linha de dois campos selecionados. Você também pode usar valores numéricos para operações binárias.
+ **Alias**: (opcional) insira o nome do novo campo. Se deixar em branco, o campo será nomeado de acordo com o cálculo.
+ **Substituir todos os campos**: (opcional) selecione esta opção se quiser ocultar todos os outros campos e exibir somente o campo calculado na visualização.
**Concatenar campos**
Esta transformação combina todos os campos de todos os quadros em um único resultado. Considere estas duas consultas.
Consulta A:
| Temporário | Tempo de atividade |
| --- | --- |
| 15.4 | 1230233 |
Consulta B:
| AQI | Erros |
| --- | --- |
| 3.2 | 5 |
Depois de concatenar os campos, o quadro de dados seria:
| Temporário | Tempo de atividade | AQI | Erros |
| --- | --- | --- | --- |
| 15.4 | 1230233 | 3.2 | 5 |
**Configurar com base nos resultados da consulta**
Esta transformação permite selecionar uma consulta e dela extrair opções padrão, como **Mín.**, **Máx.**, **Unidade** e **Limites**, e aplicá-la a outros resultados de consulta. Isso permite a configuração dinâmica da visualização orientada por consultas.
Se você quiser extrair uma configuração exclusiva para cada linha no resultado da consulta de configuração, tente a transformação de linhas em campos.
**Opções**
+ **Configurar consulta**: selecione a consulta que retorna os dados que você deseja usar como configuração.
+ **Aplicar a**: selecione a quais campos ou séries aplicar a configuração.
+ **Aplicar às opções**: normalmente, um tipo de campo ou regex do nome de campo, dependendo da opção selecionada em **Aplicar a**.
**Converter tipo de campo**
Esta transformação altera o tipo de campo do campo especificado.
+ **Campo**: seleciona entre os campos disponíveis
+ **como** — Selecione o FieldType para converter em
+ **Numérico**: tenta transformar os valores em números
+ **String**: fará com que os valores sejam strings
+ **Tempo**: tenta analisar os valores como tempo
+ Mostrará uma opção para especificar um DateFormat como entrada por meio de uma string como yyyy-mm-dd ou DD MM YYYY hh:mm:ss
+ **Booleano**: tornará os valores booleanos
Por exemplo, a consulta a seguir pode ser modificada selecionando o campo de tempo, como Tempo, e o Formato de data como AAAA.
| Hora | Marca | Valor |
| --- | --- | --- |
| 01/07/2017 | acima | 25 |
| 02/08/2018 | abaixo | 22 |
| 02/09/2019 | abaixo | 29 |
| 4/10/2020 | acima | 22 |
O resultado:
| Hora | Marca | Valor |
| --- | --- | --- |
| 1/1/2017 | acima | 25 |
| 1/1/2018 | abaixo | 22 |
| 1/1/2019 | abaixo | 29 |
| 1/1/2020 | acima | 22 |
**Filtrar dados por nome**
Use esta transformação para remover partes dos resultados da consulta.
O Grafana exibe o campo **Identificador**, seguido pelos campos retornados pela consulta.
Você pode aplicar filtros de duas formas:
+ Insira uma expressão regex.
+ Escolha um campo para alternar a filtragem nesse campo. Os campos filtrados são exibidos com texto na cor cinza escuro, e os campos não filtrados têm texto na cor branca.
**Filtrar dados por consulta**
Use esta transformação em painéis que tenham várias consultas, caso queira ocultar uma ou mais das consultas.
O Grafana exibe as letras de identificação da consulta em texto na cor cinza escuro. Clique em um identificador de consulta para alternar a filtragem. Se a letra da consulta estiver na cor branca, os resultados serão exibidos. Se a letra da consulta estiver em uma cor escura, os resultados serão ocultados.
**nota**
Esta transformação não está disponível para o Graphite porque essa fonte de dados não é compatível com a correlação de dados retornados com consultas.
**Filtrar dados por valor**
Esta transformação permite filtrar os dados diretamente no Grafana e remover alguns pontos de dados do resultado da consulta. Você tem a opção de incluir ou excluir dados que correspondam a uma ou mais condições definidas por você. As condições são aplicadas a um campo selecionado.
Esta transformação será útil se a fonte de dados não filtrar nativamente por valores. Você também pode usá-la para restringir os valores a serem exibidos se estiver usando uma consulta compartilhada.
As condições disponíveis para todos os campos são:
+ **Regex**: corresponde a uma expressão regex
+ **É nulo**: corresponde se o valor for nulo
+ **Não é nulo**: corresponde se o valor não for nulo
+ **Igual**: corresponde se o valor for igual ao valor especificado
+ **Diferente**: corresponde se o valor for diferente do valor especificado
As condições disponíveis para campos numéricos são:
+ **Maior**: corresponde se o valor for maior que o valor especificado
+ **Inferior**: corresponde se o valor for menor que o valor especificado
+ **Maior ou igual**: corresponde se o valor for maior ou igual
+ **Menor ou igual**: corresponde se o valor for menor ou igual
+ **Intervalo**: corresponde um intervalo entre um mínimo e um máximo especificados, incluindo o mínimo e máximo
Considere o seguinte conjunto de dados:
| Hora | Temperatura | Altitude |
| --- | --- | --- |
| 07/07/2020 11:34:23 | 32 | 101 |
| 07/07/2020 11:34:22 | 28 | 125 |
| 07/07/2020 11:34:21 | 26 | 110 |
| 07/07/2020 11:34:20 | 23 | 98 |
| 07/07/2020 10:32:24 | 31 | 95 |
| 07/07/2020 10:31:22 | 20 | 85 |
| 07/07/2020 09:30:57 | 19 | 101 |
Se você **incluir** os pontos de dados que têm uma temperatura abaixo de 30 °C, a configuração será da seguinte forma:
+ **Tipo de filtro**: `Include`
+ **Condição**: linhas em que `Temperature` corresponde a `Lower Than 30`
E você obterá o seguinte resultado, em que somente as temperaturas abaixo de 30 °C estão incluídas:
| Hora | Temperatura | Altitude |
| --- | --- | --- |
| 07/07/2020 11:34:22 | 28 | 125 |
| 07/07/2020 11:34:21 | 26 | 110 |
| 07/07/2020 11:34:20 | 23 | 98 |
| 07/07/2020 10:31:22 | 20 | 85 |
| 07/07/2020 09:30:57 | 19 | 101 |
Você pode adicionar mais de uma condição ao filtro. Por exemplo, talvez você queira incluir os dados somente se a altitude for maior que 100. Para fazê-lo, adicione essa condição à seguinte configuração:
+ Tipo de filtro: `Include` linhas que `Match All` condições
+ Condição 1: linhas em que `Temperature` corresponde a `Lower` que `30`
+ Condição 2: linhas em que `Altitude` corresponde a `Greater` que `100`
Quando você tem mais de uma condição, é possível escolher se deseja que a ação (incluir e excluir) seja aplicada a linhas que **Correspondam a todas** as condições ou **Correspondam a qualquer** uma das condições adicionadas.
No exemplo acima, escolhemos **Correspondam a todas** porque queríamos incluir as linhas que têm uma temperatura inferior a 30 E uma altitude superior a 100. Se quiséssemos incluir as linhas que têm uma temperatura inferior a 30 OU uma altitude superior a 100, selecionaríamos **Correspondam a qualquer**. Isso incluiria a primeira linha nos dados originais, que tem uma temperatura de 32 °C (não corresponde à primeira condição), mas uma altitude de 101 (que corresponde à segunda condição), portanto, está incluída.
As condições inválidas ou configuradas de forma incompleta são ignoradas.
**Group by** (Agrupar por)
Esta transformação agrupa os dados por um valor de campo (coluna) especificado e processa os cálculos em cada grupo. Clique para ver uma lista de opções de cálculo.
Veja a seguir um exemplo de dados originais.
| Hora | ID do servidor | Temperatura da CPU | Status do servidor |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20 | servidor 1 | 80 | Desligado |
| 07/07/2020 11:34:20 | servidor 3 | 62 | OK |
| 07/07/2020 10:32:20 | servidor 2 | 90 | Sobrecarregado |
| 07/07/2020 10:31:22 | servidor 3 | 55 | OK |
| 07/07/2020 09:30:57 | servidor 3 | 62 | Rebooting |
| 07/07/2020 09:30:05 | servidor 2 | 88 | OK |
| 07/07/2020 09:28:06 | servidor 1 | 80 | OK |
| 07/07/2020 09:25:05 | servidor 2 | 88 | OK |
| 07/07/2020 09:23:07 | servidor 1 | 86 | OK |
Esta transformação ocorre em duas etapas. Primeiro, você especifica um ou vários campos pelos quais agrupar os dados. Isso agrupará todos os mesmos valores desses campos, como se você os tivesse classificado. Por exemplo, se agruparmos pelo campo ID do servidor, os dados serão agrupados desta forma:
| Hora | ID do servidor | Temperatura da CPU | Status do servidor |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20 | servidor 1 | 80 | Desligado |
| 07/07/2020 09:28:06 | servidor 1 | 80 | OK |
| 07/07/2020 09:23:07 | servidor 1 | 86 | OK |
| 07/07/2020 10:32:20 | servidor 2 | 90 | Sobrecarregado |
| 07/07/2020 09:30:05 | servidor 2 | 88 | OK |
| 07/07/2020 09:25:05 | servidor 2 | 88 | OK |
| 07/07/2020 11:34:20 | servidor 3 | 62 | OK |
| 07/07/2020 10:31:22 | servidor 3 | 55 | OK |
| 07/07/2020 09:30:57 | servidor 3 | 62 | Rebooting |
Todas as linhas com o mesmo valor de ID do servidor são agrupadas.
Depois de escolher o campo pelo qual deseja agrupar os dados, você pode adicionar vários cálculos nos outros campos e aplicar o cálculo a cada grupo de linhas. Por exemplo, podemos querer calcular a temperatura média da CPU para cada um desses servidores. Dessa forma, podemos adicionar o cálculo da *média* aplicado no campo Temperatura da CPU para obter o seguinte:
| ID do servidor | Temperatura da CPU (média) |
| --- | --- |
| servidor 1 | 82 |
| servidor 2 | 88,6 |
| servidor 3 | 59,6 |
E podemos adicionar mais de um cálculo. Por exemplo:
+ Para o campo Tempo, podemos calcular o *último* valor, para saber quando o último ponto de dados foi recebido para cada servidor
+ Para o campo Status do servidor, podemos calcular o *último* valor para saber qual foi o último valor de estado para cada servidor
+ Para o campo Temperatura, também podemos calcular o *último* valor para saber qual foi a última temperatura monitorada para cada servidor
Então obteríamos:
| ID do servidor | Temperatura da CPU (média) | Temperatura da CPU (última) | Tempo (último) | Status do servidor (último) |
| --- | --- | --- | --- | --- |
| servidor 1 | 82 | 80 | 07/07/2020 11:34:20 | Desligado |
| servidor 2 | 88,6 | 90 | 07/07/2020 10:32:20 | Sobrecarregado |
| servidor 3 | 59,6 | 62 | 07/07/2020 11:34:20 | OK |
Esta transformação permite que você extraia informações importantes de sua série temporal e as exiba de uma forma conveniente.
**Unir por campo**
Use esta transformação para unir vários resultados em uma única tabela. Isso é especialmente útil para converter vários resultados de séries temporais em uma única tabela ampla com um campo de tempo compartilhado.
*Junção interna*
Uma junção interna mescla dados de várias tabelas em que todas as tabelas compartilham o mesmo valor do campo selecionado. Esse tipo de junção exclui dados em que os valores não coincidem em todos os resultados.
Use esta transformação para combinar os resultados de várias consultas (combinando em um campo de junção passado ou na coluna da primeira vez) em um resultado e descartar linhas em que uma junção com êxito não pode ocorrer.
No exemplo a seguir, duas consultas retornam dados de tabela. Elas são visualizadas como duas tabelas separadas antes de aplicar a transformação da junção interna.
Consulta A:
| Hora | Trabalho | Tempo de atividade |
| --- | --- | --- |
| 07/07/2020 11:34:20 | nó | 25260122 |
| 07/07/2020 11:24:20 | postgre | 123001233 |
| 07/07/2020 11:14:20 | postgre | 345001233 |
Consulta B:
| Hora | Servidor | Erros |
| --- | --- | --- |
| 07/07/2020 11:34:20 | servidor 1 | 15 |
| 07/07/2020 11:24:20 | servidor 2 | 5 |
| 07/07/2020 11:04:20 | servidor 3 | 10 |
O resultado depois de aplicar a transformação da junção interna fica da seguinte forma:
| Hora | Trabalho | Tempo de atividade | Servidor | Erros |
| --- | --- | --- | --- | --- |
| 07/07/2020 11:34:20 | nó | 25260122 | servidor 1 | 15 |
| 07/07/2020 11:24:20 | postgre | 123001233 | servidor 2 | 5 |
*Junção externa*
Uma junção externa inclui todos os dados de uma junção interna e linhas em que os valores não coincidem em todas as entradas. Enquanto a junção interna une a Consulta A e a Consulta B no campo de tempo, a junção externa inclui todas as linhas que não correspondem no campo de tempo.
No exemplo a seguir, duas consultas retornam dados de tabela. Elas são visualizadas como duas tabelas antes de aplicar a transformação da junção externa.
Consulta A:
| Hora | Trabalho | Tempo de atividade |
| --- | --- | --- |
| 07/07/2020 11:34:20 | nó | 25260122 |
| 07/07/2020 11:24:20 | postgre | 123001233 |
| 07/07/2020 11:14:20 | postgre | 345001233 |
Consulta B:
| Hora | Servidor | Erros |
| --- | --- | --- |
| 07/07/2020 11:34:20 | servidor 1 | 15 |
| 07/07/2020 11:24:20 | servidor 2 | 5 |
| 07/07/2020 11:04:20 | servidor 3 | 10 |
O resultado depois de aplicar a transformação de junção externa fica da seguinte forma:
| Hora | Trabalho | Tempo de atividade | Servidor | Erros |
| --- | --- | --- | --- | --- |
| 07/07/2020 11:04:20 | | | servidor 3 | 10 |
| 07/07/2020 11:14:20 | postgre | 345001233 | | |
| 07/07/2020 11:34:20 | nó | 25260122 | servidor 1 | 15 |
| 07/07/2020 11:24:20 | postgre | 123001233 | servidor 2 | 5 |
**Rótulos para campos**
Esta transformação altera os resultados das séries temporais que incluem rótulos ou tags em uma tabela em que cada chave e cada valor do rótulo são incluídos no resultado da tabela. Os rótulos podem ser exibidos como colunas ou valores de linha.
Tendo em conta um resultado de consulta de duas séries temporais:
+ Série 1: rótulos Servidor=Servidor A, Data center=UE
+ Série 2: rótulos Servidor=Servidor B, Data center=UE
No modo **Colunas**, o resultado fica assim:
| Hora | Servidor | Datacenter | Valor |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20 | Servidor A | UE | 1 |
| 07/07/2020 11:34:20 | Servidor B | UE | 2 |
No modo “Linhas”, o resultado tem uma tabela para cada série e mostra o valor de cada rótulo da seguinte forma:
| rótulo | valor |
| --- | --- |
| Servidor | Servidor A |
| Datacenter | UE |
| rótulo | valor |
| --- | --- |
| Servidor | Servidor B |
| Datacenter | UE |
*Nome do campo de valor*
Se você selecionou Servidor como **nome do campo Valor**, então vai obter um campo para cada valor do rótulo Servidor.
| Hora | Datacenter | Servidor A | Servidor B |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20 | UE | 1 | 2 |
*Comportamento de mesclagem*
O transformador de rótulos para campos é, internamente, duas transformações separadas. A primeira atua em uma única série e extrai rótulos para campos. A segunda é a transformação de mesclagem que une todos os resultados em uma única tabela. A transformação de mesclagem tenta unir todos os campos correspondentes. Essa etapa de mesclagem é obrigatória e não pode ser desativada.
**nota**
A transformação de *mesclagem* pode ser usada sozinha, e ela é descrita em detalhes abaixo.
Para fins de ilustração, veja um exemplo em que você tem duas consultas que retornam séries temporais sem rótulos sobrepostos.
+ Série 1: rótulos Servidor=ServidorA
+ Série 2: rótulos Data center=UE
Isso resultará primeiro nestas duas tabelas:
| Hora | Servidor | Valor |
| --- | --- | --- |
| 07/07/2020 11:34:20 | ServidorA | 10 |
| Hora | Datacenter | Valor |
| --- | --- | --- |
| 07/07/2020 11:34:20 | UE | 20 |
Depois da mesclagem:
| Hora | Servidor | Valor | Datacenter |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20 | ServidorA | 10 | |
| 07/07/2020 11:34:20 | | 20 | UE |
**Merge**
Use esta transformação para combinar o resultado de várias consultas em um único resultado. Isso é útil ao usar a visualização do painel de tabela. Os valores que podem ser mesclados são combinados na mesma linha. Os valores poderão ser mesclados se os campos compartilhados contiverem os mesmos dados.
No exemplo abaixo, temos duas consultas retornando dados da tabela. Elas são visualizadas como duas tabelas separadas antes de aplicar a transformação.
Consulta A:
| Hora | Trabalho | Tempo de atividade |
| --- | --- | --- |
| 07/07/2020 11:34:20 | nó | 25260122 |
| 07/07/2020 11:24:20 | postgre | 123001233 |
Consulta B:
| Hora | Trabalho | Erros |
| --- | --- | --- |
| 07/07/2020 11:34:20 | nó | 15 |
| 07/07/2020 11:24:20 | postgre | 5 |
Veja abaixo o resultado depois de aplicar a transformação de mesclagem:
| Hora | Trabalho | Erros | Tempo de atividade |
| --- | --- | --- | --- |
| 07/07/2020 11:34:20 | nó | 15 | 25260122 |
| 07/07/2020 11:24:20 | postgre | 5 | 123001233 |
**Organizar campos**
Use esta transformação para renomear, reordenar ou ocultar campos retornados pela consulta.
**nota**
Esta transformação só funciona em painéis com uma única consulta. Se o painel tiver várias consultas, você deverá aplicar uma transformação de junção externa ou remover as consultas extras.
O Grafana exibe uma lista de campos retornados pela consulta. Você pode:
+ Altere a ordem dos campos passando o cursor sobre um campo. O cursor se transforma em uma mão e, em seguida, você pode arrastar o campo para o novo lugar.
+ Oculte ou mostre um campo clicando no ícone de olho ao lado do nome do campo.
+ Renomeie os campos digitando um novo nome na caixa Renomear.
**Partição por valores**
Esta transformação pode ajudar a eliminar a necessidade de várias consultas à mesma fonte de dados com cláusulas `WHERE` diferentes ao representar graficamente várias séries. Considere uma tabela SQL de métricas com os seguintes dados:
| Hora | Região | Valor |
| --- | --- | --- |
| 20/10/2022 12:00:00 | EUA | 1520 |
| 20/10/2022 12:00:00 | UE | 2936 |
| 20/10/2022 1:00:00 DA MANHÃ | EUA | 1327 |
| 20/10/2022 1:00:00 DA MANHÃ | UE | 912 |
Antes da versão 9.3, se você quisesse traçar uma linha de tendência vermelha para os EUA e uma azul para a UE no mesmo TimeSeries painel, provavelmente precisaria dividi-la em duas consultas:
```
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'
```
Isso também exige que você saiba com antecedência quais regiões realmente existem na tabela de métricas.
Com o transformador *Partição por valores*, agora você pode emitir uma única consulta e dividir os resultados por valores exclusivos em uma ou mais colunas (`fields`) de sua escolha. O exemplo a seguir usa `Region`.
```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```
| Hora | Região | Valor |
| --- | --- | --- |
| 20/10/2022 12:00:00 | EUA | 1520 |
| 20/10/2022 1:00:00 DA MANHÃ | EUA | 1327 |
| Hora | Região | Valor |
| --- | --- | --- |
| 20/10/2022 12:00:00 | UE | 2936 |
| 20/10/2022 1:00:00 DA MANHÃ | UE | 912 |
**Reduzir**
A transformação *Reduzir* aplica um cálculo a cada campo no quadro e retorna um único valor. Os campos de tempo são removidos ao aplicar essa transformação.
Considere a entrada:
Consulta A:
| Hora | Temporário | Tempo de atividade |
| --- | --- | --- |
| 07/07/2020 11:34:20 | 12.3 | 25612 |
| 07/07/2020 11:24:20 | 15.4 | 1230233 |
Consulta B:
| Hora | AQI | Erros |
| --- | --- | --- |
| 07/07/2020 11:34:20 | 6.5 | 15 |
| 07/07/2020 11:24:20 | 3.2 | 5 |
O transformador de redução tem dois modos:
+ **Séries para linhas**: cria uma linha para cada campo e uma coluna para cada cálculo.
+ **Reduzir campos**: mantém a estrutura de quadros existente, mas reduz cada campo em um único valor.
Por exemplo, se você usasse o **Primeiro** e o **Último** cálculo com uma transformação de **Séries para linhas**, o resultado seria:
| Campo | First | Last |
| --- | --- | --- |
| Temporário | 12.3 | 15.4 |
| Tempo de atividade | 25612 | 1230233 |
| AQI | 6.5 | 3.2 |
| Erros | 15 | 5 |
Os campos Reduzir com o último cálculo resultam em dois quadros, cada um com uma linha:
Consulta A:
| Temporário | Tempo de atividade |
| --- | --- |
| 15.4 | 1230233 |
Consulta B:
| AQI | Erros |
| --- | --- |
| 3.2 | 5 |
**Renomear por regex**
Use esta transformação para renomear partes dos resultados da consulta usando uma expressão regular e um padrão de substituição.
Você pode especificar uma expressão regular, que só será aplicada às correspondências, junto com um padrão de substituição que seja compatível com referências anteriores. Por exemplo, vamos supor que você esteja visualizando o uso da CPU por host e queira remover o nome do domínio. Você pode definir o regex como `([^\.]+)\..+` e o padrão de substituição como `$1`, e `web-01.example.com` ficaria `web-01`.
**Linhas para campos**
A transformação de linhas para campos converte linhas em campos separados. Isso pode ser útil, pois os campos podem ser estilizados e configurados individualmente. Ela também pode usar campos adicionais como fontes para configuração dinâmica de campos ou mapeá-los para rótulos de campo. Os rótulos adicionais podem então ser usados para definir melhores nomes de exibição para os campos resultantes.
Essa transformação inclui uma tabela de campos que lista todos os campos nos dados retornados pela consulta de configuração. Essa tabela fornece controle sobre qual campo deve ser mapeado para cada propriedade de configuração (a opção \$1Usar como\$1\$1). Você também pode escolher qual valor selecionar se houver várias linhas nos dados retornados.
Essa transformação requer:
+ Um campo para usar como fonte dos nomes dos campos.
Por padrão, a transformação usa o primeiro campo de string como fonte. Você pode substituir essa configuração padrão selecionando **Nome do campo** na coluna **Usar como** do campo que você deseja usar.
+ Um campo para usar como fonte de valores.
Por padrão, a transformação usa o primeiro campo numérico como fonte. Mas você pode substituir essa configuração padrão selecionando **Valor do campo** na coluna **Usar como** do campo que você deseja usar.
Útil ao visualizar dados em:
+ Medidor
+ Stat
+ Gráfico de pizza
*Mapear campos extras para rótulos*
Se um campo não for mapeado para a propriedade de configuração, o Grafana o usará automaticamente como fonte para um rótulo no campo de saída.
Exemplo:
| Nome | DataCenter | Valor |
| --- | --- | --- |
| ServidorA | EUA | 100 |
| ServidorB | UE | 200 |
Saída:
| ServerA (rótulos DataCenter: EUA) | ServerB (rótulos DataCenter: UE) |
| --- | --- |
| 10 | 20 |
Agora, os rótulos extras podem ser usados no nome de exibição do campo para fornecer nomes de campo mais completos.
Se você quiser extrair a configuração de uma consulta e aplicá-la em outra, use a transformação Configurar dos resultados da consulta.
*Exemplo*
Entrada:
| Nome | Valor | Máx |
| --- | --- | --- |
| ServidorA | 10 | 100 |
| ServidorB | 20 | 200 |
| ServidorC | 30 | 300 |
Saída:
| ServidorA (configuração: máx.=100) | ServidorB (configuração: máx.=200) | ServidorC (configuração: máx.=300) |
| --- | --- | --- |
| 10 | 20 | 30 |
Como você pode ver, cada linha nos dados de origem vira um campo separado. Cada campo agora também tem uma opção de configuração máxima definida. Opções como Mín., Máx., Unidade e Limites fazem parte da configuração do campo e, se definidas dessa forma, serão usadas pela visualização em vez de qualquer opção configurada manualmente no painel de opções do editor de painéis.
**Preparar séries temporais**
Preparar a transformação de séries temporais é útil quando uma fonte de dados retorna dados de séries temporais em um formato que não é compatível com o painel que você deseja usar.
Essa transformação ajuda você a resolver esse problema convertendo os dados de séries temporais do formato amplo para o formato longo, ou vice-versa.
Selecione a opção **Série temporal de vários quadros** para transformar o quadro de dados de séries temporais do formato amplo para o longo.
Selecione a opção **Série temporal ampla** para transformar o quadro de dados de séries temporais do formato longo para o amplo.
**Séries para linhas**
Use esta transformação para combinar o resultado de várias consultas de dados de séries temporais em um único resultado. Isso é útil ao usar a visualização do painel de tabela.
O resultado dessa transformação conterá três colunas: Tempo, Métrica e Valor. A coluna Métrica é adicionada para que você possa ver facilmente de qual consulta a métrica se origina. Personalize esse valor definindo Rótulo na consulta de origem.
No exemplo abaixo, temos duas consultas retornando dados de séries temporais. Elas são visualizadas como duas tabelas separadas antes de aplicar a transformação.
Consulta A:
| Hora | Temperatura |
| --- | --- |
| 07/07/2020 11:34:20 | 25 |
| 07/07/2020 10:31:22 | 22 |
| 07/07/2020 09:30:05 | 19 |
Consulta B:
| Hora | Umidade |
| --- | --- |
| 07/07/2020 11:34:20 | 24 |
| 07/07/2020 10:32:20 | 29 |
| 07/07/2020 09:30:57 | 33 |
Veja abaixo o resultado depois de aplicar a transformação de séries para linhas.
| Hora | Métrica | Valor |
| --- | --- | --- |
| 07/07/2020 11:34:20 | Temperatura | 25 |
| 07/07/2020 11:34:20 | Umidade | 22 |
| 07/07/2020 10:32:20 | Umidade | 29 |
| 07/07/2020 10:31:22 | Temperatura | 22 |
| 07/07/2020 09:30:57 | Umidade | 33 |
| 07/07/2020 09:30:05 | Temperatura | 19 |
**Classificar por**
Esta transformação classificará cada quadro pelo campo configurado. Quando `reverse` estiver marcado, os valores retornarão na ordem inversa.
**Limite**
Use esta transformação para limitar o número de linhas exibidas.
No exemplo abaixo, temos a seguinte resposta da fonte de dados:
| Hora | Métrica | Valor |
| --- | --- | --- |
| 07/07/2020 11:34:20 | Temperatura | 25 |
| 07/07/2020 11:34:20 | Umidade | 22 |
| 07/07/2020 10:32:20 | Umidade | 29 |
| 07/07/2020 10:31:22 | Temperatura | 22 |
| 07/07/2020 09:30:57 | Umidade | 33 |
| 07/07/2020 09:30:05 | Temperatura | 19 |
Veja abaixo o resultado depois de adicionar uma transformação de limite com um valor de “3”:
| Hora | Métrica | Valor |
| --- | --- | --- |
| 07/07/2020 11:34:20 | Temperatura | 25 |
| 07/07/2020 11:34:20 | Umidade | 22 |
| 07/07/2020 10:32:20 | Umidade | 29 |
# Solucionar problemas de consultas
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
Esta página fornece informações para resolver problemas comuns do dashboard.
**Eu obtenho resultados diferentes quando reorganizo minhas funções**
A ordem das funções é muito importante. Assim como na matemática, a ordem em que você coloca suas funções pode afetar o resultado.
**Inspecionar a solicitação e resposta da consulta**
Os problemas mais comuns estão relacionados à consulta e à resposta da fonte de dados. Mesmo que pareça ser um bug ou um problema de visualização no Grafana, quase sempre é um problema com a consulta ou com a resposta da fonte de dados. Comece inspecionando a consulta e a resposta do painel.
Para obter mais informações, consulte [Inspecionar dados de solicitações e respostas](v9-panels-panel-inspector.md).
**Minha consulta está lenta**
Quantos pontos de dados a consulta está retornando? Uma consulta que retorna muitos pontos de dados será lenta. Experimente isto:
+ Em **Opções de consulta**, limite o **Máximo de pontos de dados** retornados.
+ Em **Opções de consulta**, aumente o tempo **Mínimo de intervalo**.
+ Na sua consulta, use uma função `group by`.
# Configurar limites
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
Esta seção inclui informações sobre o uso de limites nas visualizações. Você aprenderá sobre limites e seus padrões, como adicionar ou excluir um limite e como adicionar um limite a um painel legado.
## Sobre limites
Um limite é um valor que você especifica para uma métrica que é refletida visualmente em um dashboard quando o valor limite é atingido ou excedido.
Os limites fornecem um método para você estilizar e aplicar cores condicionalmente as visualizações com base nos resultados da consulta. Você pode aplicar limites à maioria das visualizações, mas não a todas. Para obter mais informações sobre visualizações, consulte [Painéis de visualização](v9-panels.md).
Você pode usar limites para:
+ Áreas de grade ou linhas de grade de cores na [Visualização de séries temporais](v9-panels-time-series.md)
+ Linhas com cores na [Visualização da séries temporais](v9-panels-time-series.md)
+ Aplique cores ao texto de fundo ou valor na [Visualização de estatísticas](v9-panels-stat.md)
+ Aplique cores os marcadores do medidor e do limite na [Visualização do medidor](v9-panels-gauge.md)
+ Marcadores de cores na [Visualização do Geomap](v9-panels-geomap.md)
+ Aplique cores ao texto da célula ou de fundo na [Visualização de tabela](v9-panels-table.md)
+ Defina regiões e cores das regiões na [Visualização da linha do tempo dos estados](v9-panels-state-timeline.md)
Existem dois tipos de limites:
+ Os limites **absolutos** são definidos por um número. Por exemplo, 80 em uma escala de 1 a 150.
+ Os limites **percentuais** são definidos em relação ao mínimo ou máximo. Por exemplo, 80%.
### Limites padrão
Nas visualizações compatíveis, o Grafana define valores limite padrão de:
+ 80 = vermelho
+ Base = verde
+ Modo = absoluto
O valor **Base** representa menos o infinito. Geralmente é a cor “boa”.
## Adicionar ou excluir um limite
Você pode adicionar ao painel quantos limites desejar. O Grafana classifica automaticamente os valores dos limites do mais alto para o mais baixo.
Exclua um limite quando ele não for mais relevante para suas operações comerciais. Quando você exclui um limite, o sistema remove o limite de todas as visualizações que incluem o limite.
1. Para adicionar um limite:
1. Edite o painel ao qual você deseja adicionar um limite.
1. No painel lateral de opções, localize a seção **Limites** e clique em **\$1 Adicionar limite**.
1. Selecione uma cor, número e modo de limite. O modo de limite se aplica a todos os limites deste painel.
1. Para um painel de séries temporais, selecione a opção **Mostrar limites**.
1. Para excluir um limite, navegue até o painel que contém o limite e clique no ícone da lixeira ao lado do limite que você deseja remover.
## Adicionar um limite a um painel de grafo legado
Na visualização do painel de Grafo, os limites permitem que você adicione linhas ou seções a um grafo para facilitar o reconhecimento quando o grafo ultrapassar um limite.
1. Navegue até o painel do grafo ao qual deseja adicionar um limite.
1. Na guia **Painel**, clique em **Limites**.
1. Clique em **Adicionar limite**.
1. Preencha os seguintes campos:
+ **T1:** ambos os valores são necessários para exibir um limite.
+ **lt** ou **gt**: selecione **lt** para menor que ou **gt** para maior que para indicar a que o limite se aplica.
+ **Valor:** insira um valor limite. O Grafana desenha uma linha limite ao longo do eixo Y nesse valor.
+ **Cor:** escolha uma condição que corresponda a uma cor, ou defina sua própria cor.
+ **personalizado:** você define a cor de preenchimento e a cor da linha.
+ **crítico:** a cor do preenchimento e da linha é vermelha.
+ **aviso:** a cor do preenchimento e da linha é amarela.
+ **ok:** a cor do preenchimento e da linha é verde.
+ **Preenchimento:** controla se o preenchimento do limite é exibido.
+ **Linha:** controla se a linha limite é exibida.
+ **Eixo Y:** escolha **esquerda** ou **direita**.
1. Clique em **Salvar** para salvar as alterações no dashboard.
# Configurar links de dados
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
Você pode usar variáveis de link de dados ou links de dados para criar links entre painéis.
## Variáveis de links de dados
Você pode usar variáveis em links de dados para se referir a campos, rótulos e valores de séries. Para obter mais informações sobre links de dados, consulte [Links de dados](#v9-panels-data-links).
Para ver uma lista de variáveis disponíveis, digite **\$1** no campo **URL** do link de dados para ver uma lista de variáveis que você pode usar.
**nota**
Essas variáveis foram alteradas na versão 6.4, portanto, se você tiver uma versão mais antiga do Grafana, use o seletor de versão para selecionar documentos para uma versão mais antiga do Grafana.
Você também pode usar variáveis de modelo em seus links de dados URLs, consulte[Adicionar e gerenciar variáveis de dashboard](v9-dash-variables.md).
## Variáveis do painel de intervalo de tempo
Essas variáveis permitem que você inclua o intervalo de tempo atual no URL do link de dados.
+ **\$1\$1url\$1time\$1range**: intervalo de tempo atual do dashboard (ou seja, **?from=now-6h&to=now**)
+ **\$1\$1\$1from e \$1\$1\$1to**: para obter mais informações, consulte [Variáveis globais](v9-dash-variable-add.md#v9-dash-variable-add-global).
## Variáveis de séries
Variáveis específicas de séries estão disponíveis no namespace **\$1\$1series**:
+ **\$1\$1series.name**: nome da série para o URL
## Variáveis de campo
Variáveis específicas de campo estão disponíveis no namespace **\$1\$1field**:
+ **\$1\$1field.name**: o nome do campo
+ **\$1\$1field.labels.