👀 2) Observabilité & Baseline

Slow Query Log (my.cnf)

Configuration recommandée pour capturer les requêtes pertinentes sans saturer le disque.

# /etc/my.cnf.d/server.cnf
[mysqld]
slow_query_log = 1
slow_query_log_file = /var/lib/mysql/mariadb-slow.log
long_query_time = 0.5
log_queries_not_using_indexes = 1
log_output = FILE
log_slow_verbosity = 'query_plan,full'
min_examined_row_limit = 100

Vous pouvez l'activer à chaud (sans redémarrage) :

> SET GLOBAL slow_query_log = 1;
> SET GLOBAL long_query_time = 0.5;

log_output: FILE vs TABLE

Où stocker les logs ? FILE est presque toujours le meilleur choix.

Performance Schema

Vérifiez que les "consumers" de base sont actifs. Ils le sont généralement par défaut sur MariaDB 10.5+.

> SELECT * FROM performance_schema.setup_consumers
  WHERE NAME LIKE 'events_statements_history'
     OR NAME LIKE 'events_waits_current';

Outil n°1: pt-query-digest

L'outil de référence (Percona Toolkit) pour analyser les slow logs.

Exemple d'utilisation

# Analyse simple
pt-query-digest /var/lib/mysql/mariadb-slow.log

# Analyse et sauvegarde du rapport
pt-query-digest ...-slow.log > baseline_48h.txt

# Top 5 des requêtes, triées par temps total
pt-query-digest ...-slow.log --limit 5 --order-by Query_time:sum

Outil n°2: mysqldumpslow

Outil plus simple, inclus avec MariaDB, mais moins puissant que `pt-query-digest`.

# Top 10 requêtes triées par temps moyen
mysqldumpslow -t 10 -s at /var/lib/mysql/mariadb-slow.log

Exemple de Rapport (pt-query-digest)

Ce que vous cherchez : les "Top 3" requêtes qui consomment le plus de temps *cumulé*.

# 1. Résumé du profil (9.6k requêtes)
Total: 9.6k, Time: 300.20s, Executed 1.12k times

# 2. Requête la plus coûteuse (58% du temps total !)
# Rank 1, Query ID 0xABC...
Total: 175.10s (58.3%), Executed 300 times
Query_time avg: 0.58s, max: 2.10s
Rows_sent avg: 1.2k, Rows_examined avg: 8.1M
SELECT ... FROM users JOIN posts ...

Analyse de l'exemple

Le rapport ci-dessus est une alerte rouge :
• Rows_examined avg: 8.1M : La requête scanne 8 millions de lignes.
• Rows_sent avg: 1.2k : Elle n'en renvoie que 1200.
Conclusion: C'est la priorité n°1. Il manque un index sur la clause JOIN ou WHERE.

La Stack: Prometheus & Grafana

Permet de corréler les événements. Ex: "Le CPU a 100% *parce que* les Threads_created ont explosé à ce moment-là."

• mysqld_exporter (Agent)
  Se connecte à MariaDB et expose des milliers de métriques (issues de SHOW GLOBAL STATUS et P_S).
• Prometheus (Base de données)
  "Scrape" (récupère) les métriques de l'exporter toutes les 15s.
• Grafana (Visualisation)
  Interroge Prometheus et affiche les graphiques.

Dashboards recommandés (Grafana.com):
• "MySQL Overview" (par Percona)
• "MySQL InnoDB Metrics"

KPIs Clés & Seuils d'Alerte

Ce sont les métriques à surveiller en priorité sur vos dashboards.