韓誥傭痔

Table of Contents

17 V谷rifications Prometheus

17 V谷rifications Prometheus

Aper?u

韓誥傭痔 peut interroger les m谷triques expos谷es dans le format de ligne Prometheus.

Deux 谷tapes sont n谷cessaires pour commencer 角 collecter les donn谷es Prometheus?:

un 谷l谷ment principal HTTP pointant vers le point de terminaison de donn谷es appropri谷, par ex. https://<prometheus host>/metrics
des 谷l谷ments d谷pendants utilisant une option de pr谷traitement Prometheus pour interroger les donn谷es requises 角 partir des m谷triques recueillies par l'谷l谷ment principal

Il existe deux options de pr谷traitement des donn谷es Prometheus?:

Motif Prometheus - utilis谷 dans les 谷l谷ments normaux pour interroger les donn谷es Prometheus
- Prometheus vers JSON * - utilis谷 dans les 谷l谷ments normaux et pour la d谷couverte de bas niveau. Dans ce cas, les donn谷es Prometheus interrog谷es sont renvoy谷es au format JSON.

Traitement de masse

Le traitement de masse est pris en charge pour les 谷l谷ments d谷pendants. Pour activer la mise en cache et l'indexation, le pr谷traitement Motif Prometheus doit 那tre la 梯娶梗鳥勳豕娶梗 谷tape de pr谷traitement. Lorsque Motif Prometheus est la 梯娶梗鳥勳豕娶梗谷tape de pr谷traitement, les donn谷es Prometheus analys谷es sont mises en cache et index谷es par la 梯娶梗鳥勳豕娶梗 condition <label>==<value> dans l'谷tape de pr谷traitement Motif Prometheus. Ce cache est r谷utilis谷 lors du traitement d'autres 谷l谷ments d谷pendants dans ce lot. Pour des performances optimales, la 梯娶梗鳥勳豕娶梗谷喧勳梁喝梗喧喧梗 doit 那tre celle avec les valeurs les plus diff谷rentes.

S'il y a un autre pr谷traitement 角 effectuer avant la 梯娶梗鳥勳豕娶梗谷tape, il doit 那tre d谷plac谷 soit vers l'谷l谷ment principal, soit vers un nouvel 谷l谷ment d谷pendant qui serait utilis谷 comme 谷l谷ment principal pour les 谷l谷ments d谷pendants.

Configuration

Si l'谷l谷ment ma?tre HTTP est configur谷, vous devez cr谷er un 谷l谷ment d谷pendant qui utilise une 谷tape de pr谷traitement Prometheus :

Saisissez les param豕tres g谷n谷raux de l'谷l谷ment d谷pendant dans le formulaire de configuration
Acc谷dez 角 l'onglet Pr谷traitement
S谷lectionnez une option de pr谷traitement Prometheus (Motif Prometheus ou Prometheus vers JSON)

Les param豕tres suivants sont sp谷cifiques 角 l'option de pr谷traitement Motif Prometheus :

捩硃娶硃鳥豕喧娶梗	Description	Exemples
Motif	Pour d谷finir le mod豕le de donn谷es requis, vous pouvez utiliser un langage de requ那te similaire au langage de requ那te Prometheus (voir la table de comparaison), par exemple : <nom m谷trique> - s谷lectionner par nom de m谷trique {__name__="<nom m谷trique>"} - s谷lectionner par nom de m谷trique {__name__=~"<regex>"} - s谷lectionner par nom de m谷trique correspondant 角 une expression r谷guli豕re {<nom 谷喧勳梁喝梗喧喧梗>="<谷喧勳梁喝梗喧喧梗>",...} - s谷lectionner par nom d'谷喧勳梁喝梗喧喧梗 {<nom 谷喧勳梁喝梗喧喧梗>=~"<regex>",...} - s谷lectionner par nom d'谷喧勳梁喝梗喧喧梗 correspondant 角 une expression r谷guli豕re {__name__=~".*"}==<valeur> - s谷lectionner par valeur de m谷trique Ou une combinaison des 谷l谷ments ci-dessus : <nom m谷trique>{<nom 谷喧勳梁喝梗喧喧梗1>="<valeur 谷喧勳梁喝梗喧喧梗1>",<nom 谷喧勳梁喝梗喧喧梗2>=~"<regex>",...}==<valeur> La valeur de l'谷喧勳梁喝梗喧喧梗 peut 那tre n'importe quelle s谷quence de caract豕res UTF-8, mais les caract豕res de barre oblique inverse, de guillemet double et de saut de ligne doivent 那tre 谷chapp谷s sous la forme `\\`, `\"` et `\n` respectivement ; les autres caract豕res ne doivent pas 那tre 谷chapp谷s .	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*
Traitement du r谷sultat	Indiquez s'il faut renvoyer la valeur, l'谷喧勳梁喝梗喧喧梗 ou appliquer la fonction appropri谷e (si le mod豕le correspond 角 plusieurs lignes et que le r谷sultat doit 那tre agr谷g谷) : valeur - renvoie la valeur de la m谷trique (erreur si plusieurs lignes correspondent) 谷喧勳梁喝梗喧喧梗 - renvoie la valeur du libell谷 sp谷cifi谷 dans le champ ?tiquette (erreur si plusieurs m谷triques correspondent) sum - renvoie la somme des valeurs<br >min - renvoie la valeur minimale max - renvoie la valeur maximale avg - renvoie la valeur moyenne count - renvoie le nombre de valeurs Ce champ n'est disponible que pour l'option Motif Prometheus.	Voir aussi des exemples d'utilisation de param豕tres ci-dessous.
Sortie	D谷finir le nom de l'谷喧勳梁喝梗喧喧梗 (optionnel). Dans ce cas, la valeur correspondant au nom de l'谷喧勳梁喝梗喧喧梗 est renvoy谷e. Ce champ n'est disponible que pour l'option Motif Prometheus, si '?tiquette' est s谷lectionn谷 dans le champ Traitement du r谷sultat.

Exemples d'utilisation de param豕tres

Le cas d'usage le plus courant consiste 角 renvoyer la valeur. Pour renvoyer la valeur de /var/db 角 partir 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

utilisez les param豕tres suivants :

Motif - node_disk_usage_bytes{path="/var/db"}
Traitement du r谷sultat - s谷lectionnez 'valeur'

Vous pouvez 谷galement 那tre int谷ress谷 par la valeur moyenne de tous les param豕tres node_disk_usage_bytes :

Motif - node_disk_usage_bytes
Traitement du r谷sultat - s谷lectionnez 'avg'

Alors que Prometheus ne prend en charge que les donn谷es num谷riques, il est courant d'utiliser une solution de contournement qui permet 谷galement de renvoyer la description textuelle pertinente. Cela peut 那tre accompli avec un filtre et en sp谷cifiant l'谷喧勳梁喝梗喧喧梗. Ainsi, pour renvoyer la valeur de l'谷喧勳梁喝梗喧喧梗 'color' 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

utilisez les param豕tres suivants :

Motif - elasticsearch_cluster_health_status {cluster="elasticsearch"} == 1
Traitement du r谷sultat - s谷lectionnez '谷喧勳梁喝梗喧喧梗'
?tiquette - sp谷cifiez 'color'

Le filtre (bas谷 sur la valeur num谷rique '1') correspondra 角 la ligne appropri谷e, tandis que l'谷喧勳梁喝梗喧喧梗 renverra la description de l'谷tat de sant谷 (actuellement 'green' ; mais potentiellement aussi 'red' ou 'yellow').

Prometheus vers JSON

Les donn谷es de Prometheus peuvent 那tre utilis谷es pour la d谷couverte de bas niveau. Dans ce cas, des donn谷es au format JSON sont n谷cessaires et l'option de pr谷traitement Prometheus vers JSON renverra exactement cela.

Pour plus de d谷tails, voir D谷couverte 角 l'aide des donn谷es Prometheus.

Comparaison des langages de requ那te

Le tableau suivant r谷pertorie les diff谷rences et les similitudes entre le langage de requ那te de pr谷traitement PromQL et 韓誥傭痔 Prometheus.

		Pr谷traitement 韓誥傭痔 Prometheus
嗨勳款款谷娶梗紳釵梗莽
Cible de la requ那te	Serveur Prometheus	Texte brut au format d'exposition Prometheus
Renvois	Vecteur instantan谷	Valeur de m谷trique ou d'谷喧勳梁喝梗喧喧梗 (mod豕le Prometheus) Tableau de m谷triques pour une valeur unique dans JSON (Prometheus vers JSON)
Op谷rateurs de correspondance d'谷喧勳梁喝梗喧喧梗s	=, !=, =~, !~	=, !=, =~, !~
Expression r谷guli豕re utilis谷e dans la correspondance de libell谷 ou de nom de m谷trique	RE2	PCRE
Op谷rateurs de comparaison	Voir la	Seulement == (谷gal) est pris en charge pour le filtrage de valeur
Similitudes
S谷lection par nom de m谷trique 谷gal 角 cha?ne	<nom de m谷trique> or {__nom__="<nom de m谷trique>"}	<nom de m谷trique> or {__nom__="<nom de m谷trique>"}
S谷lection par nom de m谷trique qui correspond 角 l'expression r谷guli豕re	{__nom__=~"<regex>"}	{__nom__=~"<regex>"}
S谷lection par <nom d'谷喧勳梁喝梗喧喧梗> valeur 谷gale 角 string	{<nom d'谷喧勳梁喝梗喧喧梗>="<valeur d'谷喧勳梁喝梗喧喧梗>",...}	{<nom d'谷喧勳梁喝梗喧喧梗>="<valeur d'谷喧勳梁喝梗喧喧梗>",...}
S谷lection par la valeur <nom d'谷喧勳梁喝梗喧喧梗> qui correspond 角 l'expression r谷guli豕re	{<nom d'谷喧勳梁喝梗喧喧梗>=~"<regex>",...}	{<nom d'谷喧勳梁喝梗喧喧梗>=~"<regex>",...}
S谷lection par valeur 谷gale 角 cha?ne	{__nom__=~".*"} == <valeur>	{__nom__=~".*"} == <valeur>