Accueil Technologies Grafana – guide complet : Paramètres avancés de Singlestat
Grafana - guide complet : Paramètres avancés de Singlestat

Grafana – guide complet : Paramètres avancés de Singlestat

par Jérémy PASTOURET

Dans un précédent article, je vous ai montré comment fonctionnent les widgets de base, et comment vous pouvez afficher vos données. Dans ce nouvel article, je vous propose d’aller plus loin. Notre objectif : jouer sur certains paramètres pour que les informations importantes/critiques sautent aux yeux. Notre moyen : le widget Singlestat.

Paramètres avancés du widget Singlestat

Comme vous le savez, tout commence avec une bonne requête. Je vous propose donc de poursuivre avec l’exemple utilisé dans mon précédent article. Afin d’utiliser l’ensemble des fonctionnalités de Singlestat, je vous invite à vous servir de cette requête avec le mode TimeSerie.

SELECT 
global.transfer_date as time,
(
  (SELECT COUNT(*) FROM  
  land_registry_price_paid_uk 
  WHERE city = 'LONDON' AND transfer_date = global.transfer_date) 
  * 100 / 
  (SELECT count(*) FROM 
  land_registry_price_paid_uk 
  WHERE city <> 'LONDON' and transfer_date = global.transfer_date)  
) as percent
FROM land_registry_price_paid_uk as global
WHERE $__timeFilter(global.transfer_date) 
GROUP BY global.transfer_date 
ORDER BY global.transfer_date ASC

Pour commencer, voici quelques explications sur mon contexte. Je désire connaître la part de marché représentée par la ville de Londres, par rapport à l’ensemble des autres villes. La requête ci-dessus est composé de 3 parties :

  • En premier, Select global.transfert_date as time : permet de trouver la part de marché de Londres par jour en utilisant la colonne transfer date.
  • Puis Select count(*) where city=’london’ : permet d’obtenir le nombre de lignes concernant Londres, avec la même date de transfert que la première requête.
  • Et enfin Select count(*) where city=’london’ : même chose que précédemment, mais sans compter Londres.

En multipliant la deuxième requête par 100 et en la divisant par la dernière, on obtient donc un pourcentage de part pour Londres par journée de transfert, grâce à la première requête.

Onglet Options

Je m’appuie sur un exemple concret afin que vous puissiez vous projeter sur ce que vous pourrez faire avec vos données. Après avoir saisi une requête, cliquez sur l’onglet Options.

Grafana - Options sur Singlestat

Sur la capture d’écran ci-dessus, il y a de bons paramètres pour obtenir un beau résultat. Vous trouverez ci-dessous une explication sur les différents blocs proposés par Singlestat.

Value

Permet de paramétrer la donnée et d’y ajouter des informations à afficher.

  • Stat : c’est l’opérateur de calcul appliqué à notre requête, qui donne le résultat de 11%. Vous pouvez afficher la moyenne comme moi. Ou le minimum, le maximum…
  • Font size : sert à appliquer une taille en pourcentage sur une valeur ou un titre. Pour la première ligne stat, on fixe la valeur à 150%. C’est pour cela que la valeur « 11% » est plus grande que le texte.
  • Prefix : permet d’ajouter un texte avant la valeur statistique.
  • Postfix : idem, mais après la valeur statistique.
  • Unit : sert à définir l’unité de mesure (pourcentage, énergie, température, pression, accélération…). D’ailleurs la liste est assez impressionnante.
  • Decimal : permet de spécifier le nombre de chiffres après la virgule. Par exemple : en tapant 2, on obtient 11.05%.

Coloring

Permet de modifier les différentes couleurs dans le widget.

  • Background : pour appliquer la couleur de fond en fonction du seuil (Thresholds) paramétrable plus bas.
  • Value : permet d’appliquer la couleur sur le texte statistique en fonction du même seuil.
  • Prefix : sert à appliquer la couleur sur le préfix en fonction du même seuil.
  • Postfix : idem, sur le postfix.
  • Thresholds : les seuils correspondent à deux valeurs. Que se passe-t-il si on tape « 50, 80 » ? Le système appliquera la première couleur (vert) si le chiffre est inférieur à 50. Si le chiffre est compris entre 50 et 80, ce sera la seconde couleur (orange). Enfin, s’il est supérieur à 80, ce sera la dernière couleur (rouge).
  • Colors : comme vous l’aurez compris, la couleur est associée aux seuils définis ci-dessus. Vous pouvez les modifier à votre guise.

Spark lines

C’est ici que vous pouvez afficher une courbe en fond de la vignette.

  • Show : permet d’afficher / cacher la courbe. Fonctionne uniquement si votre requête de base est sous un format Time series.
  • Full height : permet de remplir l’espace au maximum, à utiliser si votre graphique n’est pas trop gros.
  • Line color : sert à changer la couleur de votre courbe.
  • Fill color : permet de changer la couleur de remplissage sous la courbe.

Gauge

Grafana - ajout d'une jauge

Si vous adorez les tableaux de bord de votre voiture, c’est la fonction a activer.

  • Show : pour afficher / cacher la jauge.
  • Min : permet d’ajuster la valeur minimale.
  • Max : idem pour la valeur maximale.
  • Threshold labels : sert à afficher les chiffres correspondant aux seuils. Dans notre exemple : 0, 50, 80, 100.
  • Threshold markers : permet d’afficher les seuils de manière colorée. Ici : les fines lignes en vert, orange et rouge.

Onglet : Value Mapping

Grafana - Value mapping dans SingleStat

Ce dernier onglet peut être pertinent en fonction des cas. Par exemple : si le résultat est égal à 11, on veut que Grafana affiche la valeur Good. Pour cela, sélectionnez l’élément value to text dans la liste déroulante Type. Dans la partie Set Value mappings, insérez la valeur à surcharger à gauche, puis la nouvelle valeur à droite. Si vous vous demandez à quoi cela peux vraiment servir, voici un autre exemple :

Grafana - SingleStat avec des valeurs booléenes

Le principe consiste à jouer avec des valeurs binaires : soit 0, soit 1. Typiquement, on peut l’utiliser si on surveille des machines. Ainsi, si la machine est active, elle nous répond 1. En revanche, si elle est éteinte, on obtient 0.

Conclusion

Désormais vous n’avez plus d’excuses pour ne pas utiliser Singlestat, ce formidable widget riche en possibilités. Si vous avez la moindre question ou problématique, les commentaires sont là pour cela.

Vous pourriez aussi aimer

6 commentaires

Tchicken 29 mai 2019 - 14 h 51 min

Savez-vous si au niveau du « Onglet : Value Mapping » on peut utiliser des valeurs décimales ?
si oui, avec le point ou la virgule ?
A priori le point !?
D’avance merci, Tchicken

Répondre
Jérémy PASTOURET 16 juin 2019 - 20 h 28 min

Bonjour,
les décimales sont utilisables et fonctionnent avec des points (format anglais).

Répondre
YAHIA CHERIF 25 juin 2019 - 17 h 10 min

Coucou salut,

Je te remerci pour ces Tuto ça m a bcp aider à avancer

J ai une question:
Je veux afficher tous les dashboards ( qui sont regroupés dans des flders) sur la page d’acceuil de grafana en étant admin une idée, une solution??

Je sais faire pour un un seul dash mais pour un groupe donnée,je reste bolquée

Merci par avance

Répondre
Jérémy PASTOURET 15 juillet 2019 - 22 h 11 min

Bonsoir,
A ma connaissance, ce n’est pas possible pour le moment.
Peut-être que dans les prochaines versions, ce sera possible de le faire.

Bonne soirée.

Répondre
Max 6 mai 2020 - 16 h 49 min

Bonjour, j’ai une requête SQL qui me retourne un nombre d’éléments. Je souhaiterai à partir du widget compter le nombre d’éléments donc pour ça c’est assez simple j’ai mis le paramètre calc à count. Par contre est-ce possible d’afficher également les éléments sans devoir recréer un widget ?

Répondre
Jérémy PASTOURET 10 mai 2020 - 17 h 32 min

Bonjour,
Je ne connais pas de fonction de duplication de widget à proprement parlé.
Cependant, tu peux toujours exporter le contenu JSON d’un Widget et le l’importer dans un nouveau Widget.
C’est la solution la plus rapide que je connaisse.
Si tu en trouves une autre, pourrais-tu l’ajouter en commentaire ?

Répondre

Laisser un commentaire

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.