As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conectar-se a uma fonte de dados Graphite

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

Configurações do Graphite

Para acessar as configurações do Graphite, pause no ícone de Configuração (engrenagem), escolha Fontes de dados e depois a fonte de dados Graphite.

O modo de acesso controla como as solicitações à fonte de dados serão tratadas. O servidor deverá ser a forma preferencial 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 entre origens (CORS). Se você selecionar este modo de acesso, o URL deverá estar acessível no Amazon Managed Grafana.

Modo de acesso do navegador

O Amazon Managed Grafana não é compatível com o acesso direto do navegador para a fonte de dados Graphite.

Editor de consultas do Graphite

O Grafana inclui um editor de consultas específico do Graphite para ajudar a criar as consultas.

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

Escolher métricas para consultar

Escolha Selecionar métrica para navegar pela área de métricas. 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, como aliasByNode, são compatíveis com um segundo argumento opcional. Para adicionar um argumento, pause no primeiro argumento e escolha o símbolo de + 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, use sortByName. Isso pode ser inconveniente quando você tem os mesmos rótulos em vários grafos, e ambos são classificados de forma diferente e com cores diferentes. Para corrigir esse problema, use sortByName().

Consultas aninhadas

Você pode referenciar consultas pela letra da linha em que elas estão (semelhante ao Microsoft Excel). Caso adicione uma segunda consulta a um grafo, você poderá referenciar a primeira consulta digitando #A. Isso proporciona 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 grafo. Por exemplo, você pode querer ver como a CPU está sendo usada em uma máquina. Inicialmente, você pode criar o grafo adicionando uma consulta para cada série temporal, como cpu.percent.user.g, cpu.percent.system.g e assim por diante. Isso resulta em n consultas feitas à fonte de dados, o que é ineficiente.

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

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

Use funções alias para alterar os nomes das métricas nas tabelas ou grafos do Grafana, por exemplo, aliasByNode() ou aliasSub().

Consolidação de pontos

Todas as métricas do Graphite são consolidadas para que ele não retorne mais pontos de dados do que o número de pixels no grafo. Por padrão, essa consolidação é feita usando a função avg. Você pode controlar como o Graphite consolida as métricas adicionando a função consolidateBy do Graphite.

Combinar séries temporais

Para combinar séries temporais, escolha Combinar na lista Funções.

Tags e exploração de dados

No Graphite, tudo é uma tag.

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

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

Variáveis de modelo

Em vez da codificação rígida dos nomes de servidores, das aplicações e dos sensores em suas consultas de métricas, você pode usar variáveis no lugar deles. As variáveis são mostradas como caixas de seleção suspensas na parte superior do dashboard. Você pode usar essas caixas suspensas para alterar os dados exibidos no dashboard.

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

Para criar uma variável usando valores de tag, use as funções tags e tag_values do Grafana.

Para obter mais detalhes, consulte a documentação do Graphite sobre a API de preenchimento automático para tags.

Variável de consulta

A consulta que você especifica no campo de consulta deve ser um tipo de consulta de busca de métricas. Por exemplo, uma consulta como prod.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.

Usar __searchFilter para filtrar resultados de variáveis de consulta

Usar __searchFilter no campo de consulta filtrará o resultado da consulta com base no que você insere 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 pesquisa de server enquanto o usuário insere texto na caixa de seleção suspensa.

Consulta

apps.$app.servers.$__searchFilter

TagValues

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

Uso de variável

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

Há duas sintaxes:

Por que duas formas? 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 como my.server${serverNumber}.count.

Uso de variáveis em consultas de tags

Variáveis de vários valores em consultas de tags usam a sintaxe de formatação avançada introduzida no Grafana 5.0 para variáveis: {var:regex}. As consultas sem tags 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 de variáveis.

Anotações

As anotações permitem que você sobreponha informações importantes de eventos nos grafos. Você adiciona consultas de anotações por meio do menu Dashboard e da Visualização de anotações. Para obter mais informações, consulte Anotações.

O Graphite é compatível com duas maneiras de consultar anotações: