1. Compatibilité #
Vos requêtes PromQL fonctionnent.
Différences utiles #
MetricsQL accepte les requêtes PromQL existantes, avec quelques différences de comportement pensées pour être plus intuitives :
| Point | PromQL | MetricsQL |
|---|---|---|
Fenêtre de rate | Obligatoire : rate(x[5m]) | Facultative : rate(x) choisit la fenêtre selon le pas du graphe |
Extrapolation de increase | Résultats fractionnaires pour des compteurs entiers | Pas d'extrapolation : valeurs entières attendues |
| Nom de métrique après une fonction | Supprimé | Conservable avec keep_metric_names |
| Valeur manquante | Série absente | default 0 pour combler |
2. Fonctions supplémentaires #
Une sélection.
Exemples #
# Modèles WITH : factoriser une requête complexe
WITH (
errs = sum(rate(http_requests_total{code=~"5.."})) by (service),
total = sum(rate(http_requests_total)) by (service),
)
errs / total
# Top 5 des séries selon leur moyenne sur la période affichée
topk_avg(5, rate(node_network_receive_bytes_total))
# Plusieurs agrégats d'une fenêtre en une passe (min, max, avg)
rollup(node_load1[1h])
# Combler les trous et garder le nom
rate(http_requests_total) keep_metric_names default 0
# Manipulation de labels
label_set(up, "equipe", "plateforme")
label_map(up, "job", "node", "système", "api", "applicatif")
# Médiane de chaque série sur la plage affichée
range_median(node_load1)Erreur Courante : Si vous utilisez des fonctions MetricsQL dans des dashboards, ils ne fonctionneront plus sur un Prometheus classique. Gardez du PromQL standard pour les dashboards partagés entre plusieurs stockages.
3. Explorer avec vmui #
Requêtes, traces de requêtes et cardinalité.
Les outils de vmui #
| Onglet | Usage |
|---|---|
| Query | Requêtes avec graphe, tableau, JSON et trace d'exécution |
| Cardinality explorer | Métriques, labels et valeurs qui créent le plus de séries |
| Top queries | Requêtes les plus fréquentes et les plus lentes |
| Active queries | Requêtes en cours |
| Relabeling debug | Tester une règle de relabeling |
Bonne Pratique : L'explorateur de cardinalité est le premier outil à ouvrir quand la mémoire augmente : il montre en un clic la métrique ou le label responsable.
