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á.
Usando a fonte de dados Prometheus
Configurações do Prometheus
| 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 URL do seu servidor Prometheus; por exemplo,. https://prometheus.example.org:9090 |
Access
|
Servidor (padrão) = O URL deve estar acessível a partir do backend/servidor da Grafana. |
Basic Auth
|
Ative a autenticação básica na fonte de dados do Prometheus. |
User
|
Nome de usuário para autenticação básica. |
Password
|
Senha para autenticação básica. |
Scrape interval
|
Defina isso para o intervalo típico de raspagem e avaliação configurado no Prometheus. O padrão é 15s. |
Disable metrics lookup
|
Marcar essa opção desativará o seletor de métricas e o suporte à métrica/rótulo no preenchimento automático do campo de consulta. Isso ajuda se você tiver problemas de desempenho com instâncias maiores do Prometheus. |
Custom Query Parameters
|
Adicione parâmetros personalizados ao URL de consulta do Prometheus. Por exemplotimeout,partial_response,dedup, oumax_source_resolution. Vários parâmetros devem ser concatenados junto com um “&”. |
Editor de consultas Prometheus
As seções a seguir fornecem informações e opções para o editor de consultas Prometheus no painel e no Explore.
Editor de consultas em painéis
Abra um gráfico no modo de edição escolhendo o título e, em seguida, escolhendo Editar (ou pressionando a tecla e enquanto pausa no painel).
| Nome | Descrição |
|---|---|
Query expression
|
Para obter mais informações sobre as expressões de consulta do Prometheus, consulte a documentação do Prometheus. |
Legend format
|
Controla o nome da série temporal, usando nome ou padrão. Por exemplo, {{hostname}} é substituído pelo valor do rótulo para o rótulohostname. |
Min step
|
Um limite inferior adicional para o stepparâmetro das consultas de intervalo do Prometheus$__interval $__rate_interval O limite é absoluto e não é modificado pela configuração de Resolução. |
Resolution
|
1/1define a $__interval variável e o stepparâmetro das consultas de intervalo do Prometheus1/2recupera apenas um ponto de dados para cada outro pixel e 1/10 recupera um ponto de dados por 10 pixels. Observe que tanto o intervalo de tempo mínimo quanto a etapa mínima limitam o valor final de $__interval step e. |
Metric lookup
|
Pesquise nomes de métricas nesse campo de entrada. |
Format as
|
Alternar entreTable,Time
series, ouHeatmap. Tablefunciona somente no painel da tabela. Heatmapé adequado para exibir métricas do tipo histograma em um painel de mapa de calor. Ele converte histogramas cumulativos em regulares e classifica as séries pelo limite do compartimento. |
Instant
|
Execute uma consulta “instantânea” para retornar somente o valor mais recente que o Prometheus extraiu para a série temporal solicitada. As consultas instantâneas retornam resultados muito mais rapidamente do que as consultas de intervalo normal. Use-os para pesquisar conjuntos de etiquetas. |
Min time interval
|
Esse valor multiplicado pelo denominador da configuração Resolução define um limite inferior para a $__interval variável e o stepparâmetro das consultas de intervalo do Prometheus |
nota
O Amazon Managed Grafana modifica as datas de solicitação das consultas para alinhá-las com a etapa calculada dinamicamente. Isso garante a exibição consistente dos dados de métricas, mas pode resultar em uma pequena lacuna de dados na borda direita de um gráfico.
Consultas instantâneas em painéis
A fonte de dados do Prometheus permite que você execute consultas instantâneas, que consultam somente o valor mais recente. Você pode visualizar os resultados em um painel de tabela para ver todos os rótulos disponíveis de uma série temporal.
Os resultados da consulta instantânea são compostos por apenas um ponto de dados por série. Eles podem ser mostrados no painel gráfico com a ajuda de substituições de séries. Para mostrá-los no gráfico como um ponto de valor mais recente, adicione uma substituição de série e selecionePoints > true. Para mostrar uma linha horizontal em todo o gráfico, adicione uma substituição de série e selecione Transform > constant Para obter mais informações sobre substituições de série, consulte. Substituições de séries
Editor de consultas no Explore
| Nome | Descrição |
|---|---|
Query expression
|
Para obter mais informações sobre a expressão de consulta do Prometheus, consulte a documentação do Prometheus. |
Step
|
Stepparâmetro das consultas do intervalo Prometheuss (segundos). |
Query type
|
Range, Instant, ou Both. Ao executar a consulta Range, o resultado da consulta é exibido em gráfico e tabela. A consulta instantânea retorna somente o valor mais recente que o Prometheus extraiu para a série temporal solicitada e é exibida na tabela. Quando a opção Ambos é selecionada, a consulta instantânea e a consulta de intervalo são executadas. O resultado da consulta de intervalo é exibido no gráfico e o resultado da consulta instantânea é exibido na tabela. |
Navegador de métricas
O navegador de métricas permite que você encontre métricas rapidamente e selecione rótulos relevantes para criar consultas básicas. Ao abrir o navegador, você verá todas as métricas e rótulos disponíveis. Se compatível com sua instância do Prometheus, cada métrica mostrará sua AJUDA e TIPO como dica de ferramenta.
Quando você seleciona uma métrica, o navegador restringe os rótulos disponíveis para mostrar somente aqueles aplicáveis à métrica. Em seguida, você pode selecionar um ou mais rótulos para os quais os valores de rótulos disponíveis são mostrados nas listas na seção inferior. Selecione um ou mais valores para cada rótulo para restringir o escopo da consulta.
nota
Se você não se lembra do nome de uma métrica para começar, você também pode selecionar alguns rótulos primeiro, para restringir a lista e, em seguida, encontrar valores de rótulos relevantes.
Todas as listas no navegador de métricas têm um campo de pesquisa acima delas para filtrar rapidamente as métricas ou rótulos que correspondam a uma determinada string. A seção de valores tem apenas um campo de pesquisa. Sua filtragem se aplica a todos os rótulos para ajudá-lo a encontrar valores em todos os rótulos depois de selecionados, por exemplo, entre seus rótulos app, job, job_name, somente um pode com o valor que você está procurando.
Quando estiver satisfeito com sua consulta, clique em “Usar consulta” para executar a consulta. O botão Usar como consulta de taxa adiciona uma taxa (...) [$__interval] em torno de sua consulta para ajudar a escrever consultas para contramétricas. O botão “Validar seletor” verificará com o Prometheus quantas séries temporais estão disponíveis para esse seletor.
Limitações
O navegador de métricas tem um limite rígido de 10.000 rótulos (chaves) e 50.000 valores de rótulos (incluindo nomes de métricas). Se sua instância do Prometheus retornar mais resultados, o navegador continuará funcionando. No entanto, os conjuntos de resultados serão cortados acima desses limites máximos.
Modelagem
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.
Variável de consulta
A variável do tipo Consulta permite que você consulte o Prometheus para obter uma lista de métricas, rótulos ou valores de rótulos. O plug-in de fonte de dados Prometheus fornece as seguintes funções que você pode usar no campo de entrada Query.
| Nome | Descrição |
|---|---|
label_names()
|
Retorna uma lista dos nomes dos rótulos. |
label_values(label)
|
Retorna uma lista de valores de rótulos para o label em cada métrica. |
label_values(metric, label)
|
Retorna uma lista de valores de rótulos para o label na métrica especificada. |
metrics(metric)
|
Retorna uma lista de métricas que correspondem ao metric regex especificado. |
query_result(query)
|
Retorna uma lista dos resultados da consulta do Prometheus para o. query |
Para obter informações sobre o que são nomes de métricas, nomes de rótulos e valores de rótulos, consulte a documentação do Prometheus
Usando variáveis de intervalo e intervalo
nota
Support para$__range,$__range_s, e $__range_ms estão disponíveis somente no Grafana v5.3.
Você pode usar algumas variáveis globais nas variáveis de consulta: $__interval $__interval_ms$__range,$__range_s,, $__range_ms e. Para ter mais informações, consulte Variáveis globais. Pode ser conveniente usá-los com a query_result função quando você precisa filtrar consultas variáveis porque a label_values função não oferece suporte a consultas.
Para obter as instâncias corretas ao alterar o intervalo de tempo no painel, certifique-se de definir o refresh gatilho da variável como sendoOn Time Range Change.
O exemplo de código a seguir mostra como preencher uma variável com as cinco instâncias de solicitação mais ocupadas com base na média de QPS no intervalo de tempo mostrado no painel.
Query: query_result(topk(5, sum(rate(http_requests_total[$__range])) by (instance))) Regex: /"([^"]+)"/
O exemplo de código a seguir mostra como preencher uma variável com as instâncias que têm um determinado estado no intervalo de tempo mostrado no painel, usando$__range_s.
Query: query_result(max_over_time(<metric>[${__range_s}s]) != <state>) Regex:
Usando $__rate_interval variável
A $__rate_interval variável deve ser usada na função de taxa. É definido como máximo ($__interval+ intervalo de raspagem, 4 * intervalo de raspagem). O intervalo de captura é a configuração da etapa mínima (também conhecida como query_interval, uma configuração por consulta do PromQL), se houver alguma definida, e, caso contrário, o intervalo de coleta conforme definido na fonte de dados do Prometheus (mas ignorando qualquer configuração de intervalo mínimo no painel, porque a última é modificada pela configuração de resolução).
Usando variáveis em consultas
Há duas sintaxes:
-
$<varname>Exemplo: rate (http_requests_total {job=~"$job "} [5m]) -
[[varname]]Exemplo: rate (http_requests_total {job=~ "[[job]]"} [5m])
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. Quando as opções Multivalor ou Incluir todos os valores estão habilitadas, o Grafana converte os rótulos de texto simples em uma string compatível com regex. O que significa que você tem que usar =~ em vez de=.
Anotações
Você pode usar anotações para sobrepor informações ricas sobre eventos aos gráficos. Você adiciona consultas de anotação usando o menu Painel ou a visualização Anotações. Para ter mais informações, consulte Anotações.
O Prometheus oferece suporte a duas formas de consultar anotações.
-
Uma consulta métrica regular
-
Uma consulta do Prometheus para alertas pendentes e disparados. Para obter mais informações, consulte Inspecionando alertas durante o tempo de execução
).
A opção step é útil para limitar o número de eventos retornados da sua consulta.
