Grafite

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

Configurações de grafite

Para acessar as configurações do Graphite, pause no ícone Configuração (engrenagem), escolha Fontes de dados e 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, IP e 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 Grafana.
Auth
Basic Auth	Habilite a autenticação básica na fonte de dados.
User	O nome de usuário para autenticação básica.
Password	Senha para autenticação básica.
Custom HTTP Headers	Escolha Adicionar cabeçalho para 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 Cross-Origin Resource Sharing (CORS). Se você selecionar esse modo de acesso, o URL deverá estar acessível a partir do Amazon Managed Grafana.

Modo de acesso do navegador

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

Editor de consultas em 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 o ícone Alternar modo de edição de texto (lápis).

Escolhendo métricas para consultar

Escolha Selecionar métrica para navegar pelo espaço métrico. Depois de começar, você pode continuar usando o ponteiro ou as teclas de seta do teclado. Você pode selecionar um caractere curinga e continuar.

Funções

Para adicionar uma função, escolha o ícone de adição ao lado de Funçã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, oferecem suporte a um segundo argumento opcional. Para adicionar um argumento, faça uma pausa no primeiro argumento e escolha o+ símbolo que aparece. Para remover o segundo parâmetro opcional, escolha-o e mantenha-o em branco. O editor o removerá.

Rótulos de classificação

Se você quiser uma ordenação consistente, 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 pela letra da linha em que elas estão (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.

Evitando muitas consultas usando caracteres curinga

Ocasionalmente, talvez você queira ver várias séries temporais plotadas no mesmo gráfico. Por exemplo, você pode 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.gcpu.percent.system.g, e assim por diante. Isso resulta em n consultas feitas à fonte de dados, o que é ineficiente.

Para ser mais eficiente, pode-se 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

Usealias funçõ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 usandoavg a funçã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, escolha Combinar na lista Funções.

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 aseriesByTag função, que usa expressões de tag (=,,!==~,!=~) para filtrar séries temporais.

O construtor 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 servidor, aplicativo e nome 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 em seu painel.

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

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

Query	Descrição
tags()	Retorna todas as etiquetas.
tags(server=~backend\*)	Retorna somente tags que ocorrem em séries que correspondem à expressão do filtro.
tag_values(server)	Retorna valores de tag para a tag especificada.
tag_values(server, server=~backend\*)	Retorna valores de tag filtrados que ocorrem para a tag especificada em séries que correspondem 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, consulte os documentos do Graphite sobre a 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 localização métrica. Por exemplo, uma consulta como aprod.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 exemplo,apps.$app.servers.* usa a variável$app em sua definição de consulta.

Usando__searchFilter para filtrar resultados de variáveis de consulta

O uso__searchFilter no campo de consulta filtrará o resultado da consulta com base no que você inserir 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__searchFilter como parte do campo de consulta para permitir a pesquisaserver enquanto o usuário insere 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 um 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 de formato de variáveis avançadas.

Anotações

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

O Graphite suporta duas maneiras de consultar anotações:

• Uma consulta métrica regular. Para isso, você usa a caixa de texto da consulta Graphite.

• Uma consulta de eventos do Graphite. Para isso, você usa a caixa deGraphite event tags texto e especifica uma tag ou caractere curinga (mantê-la vazia também deve funcionar).