Grafite

O Grafana tem um editor de consultas de grafite avançado que permite navegar rapidamente pelo espaço métrico, adicionar funções, alterar parâmetros de função e muito mais. O editor pode lidar com todos os tipos de consultas de grafite. Ele pode até mesmo lidar com consultas complexas aninhadas por meio do uso de referências de consulta.

Configurações de grafite

Para acessar as configurações do Graphite, faça uma pausa naConfiguraçãoícone (engrenagem) e, em seguida, escolhaFontes de dadose, em seguida, escolha a fonte de dados Graphite.

Name (Nome)	Descrição
Name	O nome da fonte de dados. É assim que você vê a fonte de dados em painéis e consultas.
Default	A fonte de dados padrão significa que ela será pré-selecionada para novos painéis.
URL	O protocolo HTTP, o IP e a porta de sua instalação de graphite-web ou graphite-api.
Access	Servidor (padrão) = O URL deve ser acessível a partir do backend/servidor do Grafana.
Auth
Basic Auth	Habilite a autenticação básica na fonte de dados.
User	Nome de usuário para autenticação básica.
Password	Senha para autenticação básica.
Custom HTTP Headers	EscolhaAdicionar cabeçalhopara adicionar um cabeçalho HTTP personalizado.
Header	Insira o nome do cabeçalho personalizado.
Value	Insira o valor do cabeçalho personalizado.
Graphite details
Version	Selecione sua versão do Graphite.
Type	Selecione seu tipo de grafite.

O modo de acesso controla como as solicitações à fonte de dados serão tratadas. O servidor deve ser a forma preferida se nada mais for declarado.

Modo de acesso ao servidor (padrão)

Todas as solicitações são feitas do navegador para o Amazon Managed Grafana, que encaminha as solicitações para a fonte de dados, contornando possíveis requisitos de compartilhamento de recursos de origem cruzada (CORS). Se você selecionar esse modo de acesso, o URL deverá estar acessível a partir do Amazon Managed Grafana.

Modo de acesso ao navegador

O Amazon Managed Grafana não oferece suporte ao acesso direto do navegador à fonte de dados Graphite.

Editor de consultas de grafite

O Grafana inclui um editor de consultas específico do Graphite para ajudá-lo a criar suas consultas.

Para ver o texto bruto da consulta enviada ao Graphite, escolha aAlternar modo de edição de textoícone (lápis).

Escolhendo métricas para consultar

EscolhaSelecionar métricapara navegar no espaço métrico. Depois de começar, você pode continuar usando as teclas de seta do teclado ou do ponteiro. Você pode selecionar um caractere curinga e continuar.

Funções

Para adicionar uma função, escolha o ícone de adição ao lado deFunção. Você pode pesquisar a função ou selecioná-la no menu. Depois que uma função for selecionada, ela será adicionada e seu foco estará na caixa de texto do primeiro parâmetro. Para editar ou alterar um parâmetro, escolha-o e ele se transformará em uma caixa de texto. - Para excluir uma função, escolha o nome da função seguido pelo ícone x.

Algumas funções, comoaliasByNode, suportam um segundo argumento opcional. Para adicionar um argumento, faça uma pausa no primeiro argumento e escolha a+símbolo que aparece. Para remover o segundo parâmetro opcional, escolha-o e mantenha-o em branco. O editor o removerá.

Classificar etiquetas

Se você quiser pedidos consistentes, usesortByName. Isso pode ser irritante quando você tem os mesmos rótulos em vários gráficos e ambos são classificados de forma diferente e usando cores diferentes. Para corrigir isso, usesortByName().

Consultas aninhadas

Você pode referenciar consultas por linhaletraem que estão ativados (semelhante ao Microsoft Excel). Se você adicionar uma segunda consulta a um gráfico, poderá referenciar a primeira consulta digitando #A. Isso fornece uma maneira conveniente de criar consultas compostas.

Evitar muitas consultas usando caracteres curinga

Ocasionalmente, talvez você queira ver várias séries temporais plotadas no mesmo gráfico. Por exemplo, talvez você queira ver como a CPU está sendo usada em uma máquina. Inicialmente, você pode criar o gráfico adicionando uma consulta para cada série temporal, comocpu.percent.user.g,cpu.percent.system.g, e assim por diante. Isso resulta emnconsultas feitas à fonte de dados, o que é ineficiente.

Para ser mais eficiente, é possível usar caracteres curinga em sua pesquisa, retornando todas as séries temporais em uma consulta. Por exemplo, cpu.percent.*.g.

Modificando o nome da métrica em tabelas ou gráficos

Usealiasfunções para alterar nomes de métricas em tabelas ou gráficos do Grafana; por exemplo,aliasByNode()oualiasSub().

Consolidação de pontos

Todas as métricas do Graphite são consolidadas para que o Graphite não retorne mais pontos de dados do que pixels no gráfico. Por padrão, essa consolidação é feita usandoavgfunção. Você pode controlar como o Graphite consolida as métricas adicionando a função Graphite ConsolidateBy.

nota

Isso significa que os valores resumidos da legenda (máximo, mínimo, total) não podem estar todos corretos ao mesmo tempo. Eles são calculados do lado do cliente pela Grafana. E, dependendo da sua função de consolidação, somente uma ou duas podem estar corretas ao mesmo tempo.

Combinação de séries temporais

Para combinar séries temporais, escolhaCombinenaFunçõeslista.

Exploração de dados e tags

Em Graphite, tudo é uma etiqueta.

Ao explorar dados, as tags selecionadas anteriormente são usadas para filtrar o conjunto de resultados restante. Para selecionar dados, você usa oseriesByTagfunção, que usa expressões de tag (=,!=,=~,!=~) para filtrar séries temporais.

O criador de consultas Grafana faz isso automaticamente quando você seleciona uma tag.

nota

Dica:A pesquisa de expressões regulares pode ser lenta em tags de alta cardinalidade, então tente usar outras tags para reduzir o escopo primeiro. Começar com um nome ou namespace específico ajuda a reduzir os resultados.

Variáveis de modelo

Em vez de codificar coisas como nome do servidor, do aplicativo e do sensor em suas consultas métricas, você pode usar variáveis em seu lugar. As variáveis são mostradas como caixas de seleção suspensas na parte superior do painel. Você pode usar essas caixas suspensas para alterar os dados exibidos no seu painel.

Para obter mais informações sobre modelos e variáveis de modelo, consulteModelos e variáveis.

Para criar uma variável usando valores de tag, use as funções Grafanatagsetag_values.

Query	Descrição
tags()	Retorna todas as etiquetas.
tags(server=~backend\*)	Retorna somente as tags que ocorrem em séries que correspondem à expressão do filtro.
tag_values(server)	Valores de tag de retorno para a tag especificada.
tag_values(server, server=~backend\*)	Retorna valores de tag filtrados que ocorrem para a tag especificada em uma série correspondente a essas expressões.
tag_values(server, server=~backend\*, app=~${apps:regex})	Várias expressões e expressões de filtro podem conter outras variáveis.

Para obter mais detalhes, consulteDocumentos de grafite na API de preenchimento automático para tags.

Variável de consulta

A consulta especificada no campo de consulta deve ser um tipo de consulta de busca métrica. Por exemplo, uma consulta comoprod.servers.*preencherá a variável com todos os valores possíveis que existem na posição curinga.

Você também pode criar variáveis aninhadas que usam outras variáveis em sua definição. Por exemploapps.$app.servers.*usa a variável$appem sua definição de consulta.

Usando__searchFilterpara filtrar os resultados da variável de consulta

Usando__searchFilterno campo de consulta filtrará o resultado da consulta com base no que você inseriu na caixa de seleção suspensa. Quando você não insere nada, o valor padrão para__searchFilteré*e ``quando usado como parte de uma expressão regular.

O exemplo a seguir mostra como usar__searchFiltercomo parte do campo de consulta para permitir a pesquisa porserverenquanto o usuário insere o texto na caixa de seleção suspensa.

Query

apps.$app.servers.$__searchFilter

TagValues

tag_values(server, server=~${__searchFilter:regex})

Uso variável

Você pode usar uma variável em um caminho de nó métrico ou como parâmetro para uma função.

Há duas sintaxes:

• $<varname>Exemplo: apps.frontend. $server.requests.count

• ${varname}Exemplo: apps.frontend. $ {server} .requests.count

Por que duas maneiras? A primeira sintaxe é mais fácil de ler e escrever, mas não permite que você use uma variável no meio de uma palavra. Use a segunda sintaxe em expressões comomy.server${serverNumber}.count.

Uso de variáveis em consultas de tags

Variáveis de vários valores em consultas de tag usam a sintaxe de formatação avançada introduzida no Grafana 5.0 para variáveis:{var:regex}. As consultas sem tag usarão a formatação global padrão para variáveis de vários valores.

O exemplo de código a seguir mostra uma expressão de tag com formatação regex e usando o operador Equal Tilde,=~.

server=~${servers:regex}

Para obter mais informações, consulte Opções avançadas de formato variável.

Anotações

As anotações permitem que você sobreponha informações detalhadas sobre eventos em cima dos gráficos. Você adiciona consultas de anotações por meio do menu Dashboard /Visualização de anotações. Para obter mais informações, consulte Anotações.

O Graphite oferece suporte a duas formas de consultar anotações:

• Uma consulta métrica regular. Para isso, você usa oConsulta de grafitecaixa de texto.

• Uma consulta de eventos do Graphite. Para isso, você usa oGraphite event tagscaixa de texto e especifique uma tag ou caractere curinga (mantê-lo vazio também deve funcionar).