Grafite (núcleo) - Amazon Managed Grafana

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á.

Grafite (núcleo)

O Grafana tem um editor de consultas Graphite avançado que permite navegar rapidamente pelo espaço métrico, adicionar funções, alterar parâmetros de funções e muito mais. O editor pode lidar com todos os tipos de consultas sobre 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, faça uma pausa no ícone Configuração (engrenagem), escolha Fontes de dados e escolha a fonte de dados do Graphite.

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 da sua instalação do graphite-web ou graphite-api.
Access Servidor (padrão) = O URL deve estar acessível a partir do backend/servidor da Grafana.
Auth
Basic Auth Ative 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 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, a 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 Graphite

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á.

Classificar rótulos

Se você quiser um pedido 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, 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, como cpu.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

Use alias funções para alterar os nomes das métricas nas tabelas ou gráficos da Grafana; por exemplo, ou. aliasByNode() aliasSub()

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 o número de pixels no gráfico. Por padrão, essa consolidação é feita usando a avg 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 ser 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.

Combinando 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 a seriesByTag 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 busca por 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 do modelo

Em vez de codificar itens 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 em 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 Grafana e. tags tag_values

Consulta Descrição
tags() Retorna todas as tags.
tags(server=~backend\*) Retorna somente as tags que ocorrem em séries que correspondem à expressão do filtro.
tag_values(server) Retorne 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 a documentação 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 busca métrica. 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.

Usando __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 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 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 ter mais informações, consulte Opções avançadas de formato variável.

Anotações

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

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

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

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