韓誥傭痔

Table of Contents

17 Verifica??es Prometheus

17 Verifica??es Prometheus

Vis?o geral

O 韓誥傭痔 pode consultar m谷tricas expostas no formato de linha do Prometheus.

Dois passos s?o necess芍rios para iniciar a obten??o de dados do Prometheus:

um item principal HTTP apontando para o endpoint de dados apropriado, p.e. https://<prometheus host>/metrics
itens dependentes usando a op??o de pr谷-processamento Prometheus para consultar dados de m谷tricas reunidos pelo item principal

Estas s?o duas op??es de pr谷-processamento de dados do Prometheus:

Padr?o Prometheus - usado em itens normais para consultar dados Prometheus
Prometheus para JSON - usado em itens normais e para descoberta de baixo-n赤vel. Neste caso dados Prometheus consultados s?o retornados em um formato JSON.

Processamento em massa

Processamento em massa 谷 suportado para itens dependentes. Para habilitar o cache e indexa??o, o pr谷-processamento Padr?o Prometheus deve ser a primeira etapa de pr谷-processamento. Quando o Padr?o Prometheus 谷 a primeira etapa de pr谷-processamento ent?o o dado Prometheus analisado 谷 colocado em cache e indexado pela primeira condi??o <etiqueta>==<valor> na etapa de pr谷-processamento Padr?o Prometheus. Este cache 谷 reutilizado quando processando outros itens dependentes neste neste lote. Para otimiza??o de performance, a primeira etiqueta deve ser aquela com mais valores diferentes.

Se h芍 outro pr谷-processamento a ser feito antes da primeira etapa, ele deve ser movido ou para o item principal ou para um novo item dependente que seria usado como item principal para os itens dependentes relacionados.

Configura??o

Considerando que voc那 tenha o item principal HTTP configurado, voc那 precisa criar um item dependente que usa uma etapa de pr谷-processamento Prometheus:

Informe os par?metros gerais do item dependente no formul芍rio de configura??o
V芍角 aba de Pr谷-processamento
Selecione uma op??o de pr谷-processamento Prometheus (Padr?o Prometheus ou Prometheus para JSON)

Os seguintes par?metros s?o especificados para a op??o de pr谷-processamento Padr?o Prometheus:

Par?metro	Descri??o	Exemplos
Padr?o	Para definir o padr?o de dado requerido voc那 pode usar uma linguagem de consulta similar 角 linguagem de consulta to Prometheus (veja tabela de compara??o), p.e.: <nome m谷trica> - selecione por nome da m谷trica {__name__="<nome m谷trica>"} - selecione por nome da m谷trica {__name__=~"<regex>"} - selecione por nome da m谷trica correspondente a uma express?o regular {<label name>="<valor etiqueta>",...} - selecione por nome da etiqueta (label) {<label name>=~"<regex>",...} - selecione por nome da etiqueta correspondente a uma express?o regular {__name__=~".*"}==<valor> - selecione por valor da m谷trica Ou uma combina??o do que est芍 acima: <nome m谷trica>{<label1 name>="<valor etiqueta1>",<label2 name>=~"<regex>",...}==<valor> O valor da etiqueta pode ser qualquer sequ那ncia de caracteres UTF-8, mas os caracteres de contrabarra, aspas duplas e nova linha tem de ser escapados como `\\`, `\"` e `\n` respectivamente; outros caracteres n?o devem ser escapados.	wmi_os_physical_memory_free_bytes cpu_usage_system{cpu="cpu-total"} cpu_usage_system{cpu=~"."}* cpu_usage_system{cpu="cpu-total",host=~"."}* wmi_service_state{name="dhcp"}==1 wmi_os_timezone{timezone=~"."}==1*
Resultado do processamento	Especifique se ser芍 retornado o valor, a etiqueta ou aplique a fun??o apropriada (se o padr?o corresponde a v芍rias linhas e o resultado precisa ser agregado): valor - retorna o valor da m谷trica (erro se m迆ltiplas linhas corresponderem) etiqueta - retorna o valor da etiqueta especificada no campo Etiqueta (erro se m迆ltiplas linhas corresponderem) sum - retorna a soma dos valores min - retorna o valor m赤nimo max - retorna o valor m芍ximo avg - retorna o valor 鳥谷餃勳棗 count - retorna a contagem de valores Este campo est芍 dispon赤vel apenas na op??o Padr?o Prometheus.	Veja tamb谷m exemplos de uso de par?metros abaixo.
釦硃赤餃硃	Defina um nome de etiqueta (opcional). Neste caso o valor correspondente ao nome de etiqueta 谷 retornado. Este campo est芍 dispon赤vel apenas para a op??o Padr?o Prometheus, se 'Etiqueta' estiver selecionado no campo Processamento de resultado.

Exemplos de utiliza??o dos par?metros

O caso de uso mais comum 谷 para retornar o valor. Para retornar o valor de /var/db de:

node_disk_usage_bytes{path="/var/cache"} 2.1766144e+09
node_disk_usage_bytes{path="/var/db"} 20480
node_disk_usage_bytes{path="/var/dpkg"} 8192
node_disk_usage_bytes{path="/var/empty"} 4096

use os seguintes par?metros:

Padr?o - node_disk_usage_bytes{path="/var/db"}
Processamento do resulado - selecione 'valor'

Voc那 pode tamb谷m estar interessado no valor 鳥谷餃勳棗 de todos os par?metros node_disk_usage_bytes:

Padr?o - node_disk_usage_bytes
Resultado do processamento - selecione 'avg'

Enquanto o Prometheus suporta apenas dados num谷ricos, 谷 popular usar uma conting那ncia que permite retornar uma descri??o textual relevante tamb谷m. Isto pode ser alcan?ado com um filtro e especifica??o de uma etiqueta. Ent?o, para retornar o valor da etiqueta 'color' (cor) de

elasticsearch_cluster_health_status{cluster="elasticsearch",color="green"} 1
elasticsearch_cluster_health_status{cluster="elasticsearch",color="red"} 0
elasticsearch_cluster_health_status{cluster="elasticsearch",color="yellow"} 0

use os seguintes par?metros:

Padr?o - elasticsearch_cluster_health_status {cluster="elasticsearch"} == 1
Resultado do processamento - selecione 'etiqueta'
Etiqueta - especifique 'color'

O filtro (baseado no valor num谷rico '1') corresponder芍 a linha apropriada, enquanto a etiqueta retornar芍 a descri??o do estado de integridade (atualmente 'verde' (green); mas potencialmente tamb谷m 'vermelho' (red) ou 'amarelo' (yellow)).

Prometheus para JSON

Dados do Prometheus podem ser usados para descoberta de baixo-n赤vel. Neste caso s?o necess芍rios dados em formato JSON e a op??o de pr谷-processamento Prometheus para JSON retornar芍 exatamente isso.

Para mais detalhes, consulte Descoberta usando dados Prometheus.

Compara??o linguagem de consulta (query language)

A seguinte tabela lista as diferen?as e similaridades entre PromQL e a linguagem de consulta de pr谷-processamento Prometheus do 韓誥傭痔.

		韓誥傭痔 Pr谷-processamento Prometheus
Diferen?as
Alvo para consulta	Servidor Prometheus	Texto plano em formato de exposi??o Prometheus
Retornos	Vetor instant?neo	M谷trica ou valor de etiqueta (Padr?o Prometheus) Array de m谷tricas por valor 迆nico em JSON (Prometheus para JSON)
Operadores de correspond那ncia de etiqueta	=, !=, =~, !~	=, !=, =~, !~
Express?o Regular usada na etiqueta ou nome da m谷trica correspondente	RE2	PCRE
Operadores de compara??o	Veja	Apenas == (igual) 谷 suportado para filtro de valor
Similaridades
Sele??o por nome de m谷trica igual string	<nome m谷trica> ou {__name__="<nome m谷trica>"}	<nome m谷trica> ou {__name__="<nome m谷trica>"}
Sele??o por nome de m谷trica correspondente a express?o regular	{__name__=~"<regex>"}	{__name__=~"<regex>"}
Sele??o pelo valor <nome etiqueta> que iguala string	{<label name>="<nome etiqueta>",...}	{<label name>="<nome etiqueta>",...}
Sele??o pelo valor <nome etiqueta> que corresponde 角 express?o regular	{<label name>=~"<regex>",...}	{<label name>=~"<regex>",...}
Sele??o por valor que iguala string	{__name__=~".*"} == <valor>	{__name__=~".*"} == <valor>