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
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
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
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, 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 oseriesByTag
funçã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 Grafanatags
etag_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$app
em sua definição de consulta.
Usando__searchFilter
para filtrar os resultados da variável de consulta
Usando__searchFilter
no 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__searchFilter
como parte do campo de consulta para permitir a pesquisa porserver
enquanto 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 o
Graphite event tags
caixa de texto e especifique uma tag ou caractere curinga (mantê-lo vazio também deve funcionar).