PromQL est un langage de requête permettant de sélectionner et d’agréger les séries temporelles stockées par Prometheus.

Il existe des bonnes pratiques à propos de la nomenclature des métriques et des labels, consulter la documentation officielle à l'URL https://prometheus.io/docs/practices/naming/

application_variable_unités_type

La métrique a un type, par exemple counter. Une métrique de type counter (compteur) à la particularité de ne pouvoir que croître.

Dans le cas du compteur, plutôt que d'afficher directement sa valeur courante, il peut être plus pertinent de l'utiliser pour calculer son taux (ou sa fréquence d'apparition) qui peut être plus représentatif de sa vitesse d’accroissement.

La fonction rate() du PromQL permet de facilement répondre a ce type de besoin:

rate(traefik_entrypoint_requests_total{job="routing",entrypoint!="METRICS"}[5m])

Dasn cet exemple:

• La métrique est traefik_entrypoint_requests_total
• Les labels sont listés entre crochets job et entrypoint

PromQL permet de grouper les séries temporelles par labels grace à sa fonction sum():

sum( rate(traefik_entrypoint_requests_total{job="routing",entrypoint!="METRICS"}[5m])) by(entrypoint)

• https://grafana.com/tutorials/grafana-fundamentals/