# Notes de version de pgBadger 11.x

> Notes de version complètes de la série pgBadger 11.x

---

Index LLMS : [llms.txt](/fr/llms.txt)

---

Ces entrées conservent l’intégralité de l'historique des modifications upstream pour pgBadger 11.x, du plus récent au plus ancien.

## v11.8 · 2022-04-08 {#v11-8}

Cette version de pgBadger corrige certains problèmes signalés par les utilisateurs au cours des trois derniers mois, en particulier deux correctifs concernant la détection des nouvelles entrées de journal en mode incrémentiel.

  * Corriger la détection des nouvelles entrées de journal avec horodatage lorsque le format milliseconde (%m) ou époque (%n) était utilisé dans log_line_prefix.
  * Corriger la détection des nouvelles entrées de journal dans le fichier local lorsque le mode multiprocessus n'était pas utilisé.

Voici la liste complète des modifications et des remerciements :

  - Revue complète et simplification de la détection des modifications dans le fichier journal.
  - Rapports des messages « impossible de (recevoir|envoyer) des données (du|au) client » dans les rapports Événements. Remerciements à Adrien Nayrat pour le signalement.
  - Correction d'un problème d'analyse lorsque le nom d'une requête préparée contient le caractère « : ». Remerciements à aleszeleny pour le signalement.
  - Correction de la détection des nouvelles entrées de journal avec horodatage lorsque les millisecondes (%m) ou l'époque (%n) sont utilisées. Remerciements à aleszeleny pour le signalement.
  - Correction de la détection des nouvelles entrées de journal dans un fichier local lorsque le mode multiprocessus n'était pas utilisé. Remerciements à aleszeleny pour le signalement.
  - Correction de la détection des nouvelles entrées de journal dans les fichiers distants via SSH. Remerciements à Luca Ferrari pour le signalement.
  - Correction des données incorrectes dans le nom d'utilisateur du rapport « Connexions par utilisateur ». Remerciements à caseyandgina pour le signalement.
  - Correction de la commande SSH lors de l'utilisation d'une URI, les options SSH étaient manquantes. Remerciements à Luca Ferrari pour le signalement.
  - Prise en charge du placeholder queryid %Q. Remerciements à Adrien Nayrat pour le correctif.
  - Correction d'une faute de frappe dans une phrase d'erreur. Remerciements à Luca Ferrari pour le correctif.
  - Rapport du message : « le processus serveur a été terminé par un signal » dans le rapport Événements. Remerciements à Avi Vallarapu pour le signalement.
  - doc : correction du nom de fichier pour la commande incrémentale hebdomadaire. Remerciements à Théophile Helleboid pour le correctif.
  - t/04_advanced.t : correction du test syslog. Remerciements à Christoph Berg pour le correctif.

## v11.7 · 2022-01-23 {#v11-7}

Cette version de pgBadger corrige certains problèmes signalés par les utilisateurs au cours des cinq derniers mois, ainsi que certaines améliorations :

* Ajouter une nouvelle option --no-progressbar pour ne pas l’afficher tout en conservant les autres sorties.
* Ajouter une nouvelle option --day-report permettant de régénérer un rapport HTML pour une journée spécifique. Comme l’option --month-report, mais uniquement pour une journée. Elle nécessite la présence des répertoires de sortie incrémentielle et de tous les fichiers binaires nécessaires. La valeur doit être une date au format : YYYY-MM-DD
* Améliorer l’analyse des journaux Heroku logplex et cloudsql au format JSON.

Voici la liste complète des modifications et des remerciements :

- Mettre à jour les guides de contribution et le fichier Makefile.PL afin d'améliorer la cohérence, la clarté et les dépendances. Merci à diffuse pour le correctif.
- Corriger l'utilisation du fichier de dernière analyse (--last-parsed) en mode binaire. Merci à wibrt pour le signalement.
- Ajouter un test de régression pour l'utilisation de --last-parsed et corriger le test de régression sur le rapport pour les fichiers temporaires uniquement.
- Corriger le titre du graphique session par hôte. Merci à Norbert Bede pour le signalement.
- Corriger le numéro de semaine lors du calcul des rapports hebdomadaires lorsque les options --iso-week-number et --incremental sont activées. Merci à hansgv pour le signalement.
- Ajouter l'option --no-progressbar pour ne pas l'afficher tout en conservant les autres sorties. Merci à seidlmic pour la demande de fonctionnalité.
- Empêcher l'affichage excessif de lignes au format inconnu en mode débogage pour les fichiers JSON multilignes.
- Corriger l'analyse du journal JSON en ligne simple cloudsql. Merci à Thomas Leclaire pour le signalement.
- Corriger le résumé des fichiers temporaires avec log_temp_files uniquement.
- Afficher un message de débogage avec -v même si -q ou --quiet est utilisé.
- Corriger la détection automatique du fichier jsonlog.
- Corriger l'analyse du fichier journal cloudsql. Merci à Luc Lamarle pour le signalement.
- Corriger l'extraction du PID dans parse_json_input. Merci à Francois Scala pour le correctif.
- Ajouter une nouvelle option --day-report avec une valeur au format : AAAA-MM-JJ, pouvant être utilisée pour reconstruire un rapport HTML pour la journée spécifiée. Merci à Thomas Leclaire pour la demande de fonctionnalité.
- Corriger le compteur de requêtes dans la barre de progression. Merci à Guillaume Lelarge pour le signalement.
- Corriger les requêtes incomplètes stockées pour les rapports top bind et prepare.
- Corriger la normalisation de l'identifiant d'objet, dans certains cas les chiffres étaient remplacés par un ?.
- Corriger les requêtes normalisées non formatées lorsque des commentaires sont présents au début.
- Corriger le format multiligne dans stderr lorsque --dbname est utilisé. Merci à Guillaume Lelarge pour le signalement.
- Corriger la non-génération de rapports en mode incrémental lorsque --dbname est utilisé. Merci à Dudley Perkins pour le signalement.
- Ne plus interrompre l'exécution si un fichier binaire n'est pas compatible, passer au fichier suivant. Merci à Thomas Leclaire pour la suggestion.
- Corriger le changement de format Heroku logplex dans le parseur pgBadger. Merci à François Pietka pour le signalement.

## v11.6 · 2021-09-04 {#v11-6}

Cette version de pgBadger corrige certains problèmes signalés par les utilisateurs au cours des sept derniers mois, ainsi que certaines améliorations :

  * Ajouter la détection de l'identifiant de requête dans log_line_prefix, nouvelle fonctionnalité disponible depuis PG14. Remerciements à Florent Jardin pour le signalement.
  * Ajouter des tests de régression avancés avec exclusion de base de données et la fonctionnalité d'explosion. Remerciements à MigOps Inc pour le correctif.
  * Appliquer le traitement multiprocessus à la génération du rapport lorsque --explode est utilisé. Remerciements à MigOps Inc pour le correctif et à Thomas Leclaire pour la demande de fonctionnalité.
  * Ajouter --iso-week-number en mode incrémentiel, les semaines du calendrier commencent un lundi et respectent le numéro de semaine ISO 8601, compris entre 01 et 53, où la semaine 1 est la première semaine qui contient au moins 4 jours dans la nouvelle année. Remerciements à Alex Muntada pour la demande de fonctionnalité.
  * Ajouter l'option de ligne de commande --keep-comments pour ne pas supprimer les commentaires des requêtes normalisées. Utile si vous souhaitez distinguer des requêtes normalisées identiques. Remerciements à Stefan Corneliu Petrea pour la demande de fonctionnalité.
  * Ignorer les lignes INFO introduites dans le fichier journal par des logiciels tiers. Remerciements à David Piscitelli pour le signalement.
  * Ajouter la compatibilité avec les fichiers journaux PostgresPro incluant le numéro de ligne et la taille en octets suivant la durée d'exécution de l'instruction. Remerciements à panatamann pour le signalement.
  * Analyser les horodatages contenant des T pour permettre l'utilisation des timestamps issus de journalctl. Remerciements à Graham Christensen pour le correctif.
  * Améliorer le portage sous Windows. Remerciements à Bertrand Bourgier pour les correctifs.

Note importante :

  *  Attendre que --iso-week-number devienne la valeur par défaut dans la prochaine version majeure et que l'option --start-monday soit supprimée, car la semaine commencera toujours un lundi. La possibilité de faire commencer les rapports hebdomadaires un dimanche sera supprimée afin de simplifier le code.

Voici la liste complète des modifications et des remerciements :

  - Corriger la duplication du message d'avertissement :
      "la base de données ... doit être vidée dans un délai de ... transactions".
    Remerciements à Christophe Courtois pour le signalement.
  - Corriger l'utilisation d'une variable non initialisée. Remerciements à phiresky pour le signalement.
  - Améliorer la détection de l'identifiant de requête, qui peut être négatif, ainsi que sa lecture
    depuis les fichiers CSV.
  - Corriger le cas où le dernier fichier en mode incrémentiel est toujours analysé, même s'il avait déjà été traité. Remerciements à Thomas Leclaire pour le signalement.
  - Mettre à jour l'expression régulière du format syslog pour gérer le cas où l'indicateur de session contient un seul entier au lieu de deux entiers séparés par un tiret. Remerciements à Timothy Alexander pour le correctif.
  - Corriger l'option --exclude-db afin de créer quand même le rapport associé avec les journaux JSON. Remerciements à MigOps Inc pour le correctif et à Thomas Leclaire pour le signalement.
  - Ajouter un test de régression concernant la version défectueuse de Storable.
  - Corriger l'utilisation d'une valeur non initialisée dans l'itérateur de substitution en mode incrémentiel lors de la génération du rapport hebdomadaire. Remerciements à Thomas Leclaire, Michael Vitale, Sumeet Shukla et Stefan Corneliu Petrea pour le signalement.
  - Ajouter l'option 'g' pour remplacer tous les paramètres liés. Remerciements à Nicolas Lutic et Sébastien Lardiere pour le correctif.
  - Améliorations de la documentation. Remerciements à Stefan Petrea pour le correctif.
  - Corriger le calcul de fuseau horaire dans le journal des modifications. Remerciements à Stefan Petrea pour le correctif.
  - Corriger le filtre de journal par heure de début/fin.
  - Corriger l'association erronée des lignes orphelines pour les requêtes multilignes avec un filtre sur la base de données. Remerciements à Abhishek Mehta pour le signalement.
  - Corriger les rapports en mode incrémentiel lorsque le paramètre --dbname est partiellement ignoré avec l'option "explode" (-E). Remerciements à lrevest pour le signalement.
  - Mettre à jour les ressources JavaScript.
  - Corriger l'affichage du menu avant le passage en mode hamburger lorsque l'écran est réduit. Remerciements à Guillaume Lelarge pour le signalement.
  - Corriger le traitement des valeurs de paramètres liés sur plusieurs lignes dans le journal, qui n'était pas correctement pris en charge.
  - Appliquer la même correction que celle du correctif précédent dans pgFormatter.
  - Corriger une autre utilisation d'une valeur non initialisée dans l'itérateur de substitution issu du code de pgFormatter. Remerciements à Christophe Courtois pour le signalement.
  - Corriger la normalisation des requêtes. Remerciements à Jeffrey Beale pour le correctif.
  - S'assurer que toutes les instructions se terminent par un point-virgule lorsque --dump-all-queries est utilisé. Remerciements à Christian pour le signalement.
  - Corriger une faute de frappe et l'initialisation du type de fin de ligne avec plusieurs fichiers journaux.
  - Ajouter la détection automatique du type de fin de ligne pour corriger le décalage LAST_PARSED lorsque le type EOL est sur 2 octets (cas Windows). Remerciements à Bertrand Bourgier pour le correctif.
  - Corriger le portage de get_day_of_week() sous Windows où strftime %u n'est pas pris en charge. Remerciements à Bertrand Bourgier pour le correctif.
  - Corriger le portage sous Windows qui appelait l'utilitaire perl pl2bat.bat pour créer un pgBadger.bat corrompu en raison de la manière dont __DATA__ était lu dans pgBadger. Remerciements à Bertrand Bourgier pour le correctif.
  - Corriger le filtre par heure de début/fin et ajouter un test de régression pour les filtres de timestamp. Remerciements à Alexis Lahouze et plmayekar pour le signalement.
  - Corriger l'utilisation d'une valeur non initialisée dans la correspondance de motif introduite par la mise à jour de pgFormatter. Remerciements à arlt pour le signalement.

## v11.5 · 2021-02-18 {#v11-5}

Cette version de pgBadger corrige certains problèmes signalés par les utilisateurs au cours des trois derniers mois, ainsi que certaines améliorations :

  * Ajouter un rapport sur le temps d'inactivité des sessions, calculé à l'aide de :
        « temps total des sessions - temps total des requêtes / nombre de sessions »
    Cela nécessite que les options log_connection et log_disconnection soient activées, ainsi que log_min_duration_statement = 0 (toutes les requêtes sont journalisées)
    pour obtenir une valeur fiable. Ce rapport permet de connaître la quantité de temps d'inactivité perdue, et d'évaluer si un mode de transaction avec pooler serait utile.
    Ce rapport est disponible dans l'onglet « Sessions » du rapport « Statistiques globales »
    et dans l'onglet « Sessions » des rapports « Activité générale » (par heure).
  * Ajouter la masquage des valeurs numériques, remplacées par 4 chiffres aléatoires.
  * Mettre à jour le formateur SQL basé sur pgFormatter 5.0.

Voici la liste complète des modifications et des remerciements :

  - Corriger l'analyse des instructions multilignes cloudsql. Remerciements à Jon Young pour le rapport.
  - Ajouter un test de régression pour l'anonymisation.
  - Corriger l'anonymisation cassée par le troncature maxlength. Remerciements à artl pour le rapport.
  - Ajouter l'anonymisation des paramètres dans les rapports sur les préparations et liaisons coûteuses en temps. Remerciements à arlt pour le rapport.
  - Ajouter la prise en charge des microsecondes dans le préfixe de ligne de journal logplex. Remerciements à Ross Gardiner pour le rapport.
  - Ajouter un rapport sur le temps d'inactivité des sessions. Remerciements à Guillaume Lelarge pour la demande de fonctionnalité.
  - Compléter le correctif pour prendre en charge les lignes multilignes au format jsonlog.

## v11.4 · 2020-11-24 {#v11-4}

Cette version de pgBadger corrige certains problèmes signalés par les utilisateurs au cours des quatre derniers mois. Elle améliore le support des informations de journalisation de PostgreSQL 13 et ajoute quelques nouvelles fonctionnalités :

  * Ajouter des informations complètes sur l'autovacuum dans le rapport « Vacuums par table » concernant l'utilisation du tampon (accès réussis, échoués, modifiés), les sauts dus aux verrous, les sauts dus au gel et l'utilisation du WAL (enregistrements, images de pages entières, octets). Dans le rapport « Tuples supprimés par table », ajouter également les informations suivantes sur l'autovacuum : tuples restants, tuples non encore supprimables et pages restantes. Ces informations ne sont disponibles que dans l'onglet « Table ».
  * Ajouter un nouveau rapport de répartition concernant les causes de démarrage des points de contrôle.
  * Ajouter la détection du nom d'application à partir des traces d'autorisation de connexion.

Voici la liste complète des modifications et des remerciements :

  - Corriger une faute de frappe dans un message d'erreur. Remerciements à Vidar Tyldum pour le correctif.
  - Corriger le portage sous Windows avec l'erreur : « impossible de charger des données binaires incompatibles ».
    Remerciements à Eric Brawner pour le signalement.
  - Corriger une faute de frappe sur l'option --html-outdir dans l'utilisation et la documentation de pgBadger.
    Remerciements à Vidar Tyldum pour le correctif.
  - Corriger la détection automatique du format jsonlog/cloudsql. Remerciements à Jon Young
    pour le signalement.
  - Corriger l'analyse des logs CSV avec PG v13. Remerciements à Kanwei Li pour le signalement
    et à Kaarel Moppel pour le correctif.
  - Corriger le tri des requêtes générant le rapport des fichiers temporaires les plus nombreux.
    Remerciements à Sebastien Lardiere pour le signalement.
  - Ajouter la trace de la version de pgBadger en mode débogage.

## v11.3 · 2020-07-26 {#v11-3}

Cette version de pgBadger corrige plusieurs problèmes signalés par les utilisateurs au cours des quatre derniers mois. Elle introduit également certaines nouvelles fonctionnalités et de nouveaux options en ligne de commande :

  * Ajouter la détection automatique des horodatages UTC afin d'éviter d'appliquer un fuseau horaire aux graphiques.
  * Ajouter le support du format de journal JSON de GCP CloudSQL.
  * Ajouter une nouvelle option --dump-all-queries pour utiliser pgBadger afin d'extraire toutes les requêtes dans un fichier texte, aucun rapport n'est généré, uniquement la liste complète des instructions trouvées dans le journal PostgreSQL. Les paramètres liés sont insérés dans les requêtes à leur position respective.
  * Ajouter une nouvelle option -Q | --query-numbering utilisée pour numéroter les requêtes dans la sortie lors de l'utilisation des options --dump-all-queries ou --normalized-only..
  * Ajouter une nouvelle option de ligne de commande --tempdir pour définir le répertoire où les fichiers temporaires seront écrits. Utile sur les systèmes qui n'autorisent pas l'écriture dans /tmp..
  * Ajouter l'option de ligne de commande --ssh-port pour définir le port SSH si ce n'est pas le port par défaut 22. La notation URI prend également en charge la spécification du port SSH en utilisant la forme suivante :
        ssh://192.168.1.100:2222//var/log/postgresql-11.log

Voici la liste complète des modifications et des remerciements :

  - Corriger les rapports incrémentiels pour le format de journal jsonlog/cloudsql. Merci à Ryan DeShone pour le rapport
  - Ajouter la détection automatique de l'horodatage UTC afin d'éviter d'appliquer un fuseau horaire détecté automatiquement aux graphiques. Avec une heure UTC, le JavaScript appliquera le fuseau horaire local. Merci à Brett Stauner pour le rapport.
  - Corriger l'analyse incrémentielle des journaux journalctl qui ne fonctionnait pas à partir de la deuxième exécution. Merci à Paweł Koziol pour le correctif.
  - Corriger le chemin vers le fichier de ressources lorsque -X et -E sont utilisés. Merci à Ryan DeShone pour le rapport.
  - Corriger le rapport d'activité générale concernant les requêtes de lecture/écriture. Merci à alexandre-sk5 pour le rapport.
  - Ajouter un message de débogage lorsque le mode parallèle n'est pas utilisé.
  - Corriger la logique elsif dans la détection de la taille du fichier et l'espace supplémentaire introduit dans la commande journalctl lorsque l'option --since est ajoutée. Merci à Pawel Koziol pour le correctif.
  - Corriger l'erreur « pas un descripteur de fichier valide ». Merci à Pawel Koziol pour le rapport.
  - Corriger le mode incrémentiel avec les fichiers RDS. Merci à Ildefonso Camargo, nodje et John Walsh pour le rapport.
  - Ajouter une nouvelle option -Q | --query-numbering utilisée pour numéroter les requêtes dans la sortie lors de l'utilisation des options --dump-all-queries ou --normalized-only.. Cela peut être utile pour extraire des requêtes multilignes du fichier de sortie à l'aide d'un script externe. Merci à Shantanu Oak pour la demande de fonctionnalité.
  - Corriger l'analyse des journaux json cloudsql lorsque log_min_duration_statement est activé. Merci à alexandre-sk5 pour le rapport.
  - Corriger la clé de hachage erronée pour les utilisateurs dans les journaux RDS. Merci à vosmax pour le rapport.
  - Corriger l'erreur liée à la modification d'une valeur de tableau non créable. Merci à John Walsh et Mark Fletcher pour le rapport.
  - Ajouter le support du format de journal json GCP CloudSQL, le format de journal (-f) est jsonlog. Merci à Thomas Poindessous pour la demande de fonctionnalité.
  - Ajouter une nouvelle option --dump-all-queries permettant d'utiliser pgBadger pour exporter toutes les requêtes dans un fichier texte, aucun rapport n'est généré, uniquement la liste complète des instructions trouvées dans le journal PostgreSQL. Les paramètres liés aux requêtes sont insérés à leur position respective. Aucun tri sur les requêtes uniques n'est effectué, toutes les requêtes sont journalisées. Merci à Shantanu Oak pour la demande de fonctionnalité.
  - Ajouter la documentation pour l'option --dump-all-queries.
  - Corriger le rapport vacuum pour les nouvelles versions de PG. Merci à Alexey Timanovsky pour le rapport.
  - Ajouter une nouvelle option de ligne de commande --no-process-info pour désactiver le changement du titre du processus afin d'aider à identifier le processus pgBadger, certains systèmes ne le permettent pas. Merci à Akshay2378 pour le rapport.
  - Ajouter une nouvelle option de ligne de commande --tempdir pour définir le répertoire où les fichiers temporaires seront écrits. Valeur par défaut :
        File::Spec->tmpdir() || '/tmp'
      Peut être utile sur les systèmes qui n'autorisent pas l'écriture dans /tmp.. Merci à Akshay2378 pour le rapport.
  - Corriger les noms de fichiers compressés non pris en charge contenant des espaces et/ou des crochets. Merci à Alexey Timanovsky pour le rapport.
  - Ajouter une option de ligne de commande --ssh-port utilisée pour définir le port SSH si ce n'est pas le port par défaut 22. La notation URI ajoute également le support de la spécification du port SSH en utilisant la forme :
        ssh://192.168.1.100:2222//var/log/postgresql-11.log
      Merci à Augusto Murri pour la demande de fonctionnalité.

## v11.2 · 2020-03-11 {#v11-2}

Cette version de pgBadger corrige plusieurs problèmes signalés par les utilisateurs au cours des six derniers mois. Elle introduit également quelques nouvelles fonctionnalités :

  * Ajouter le support et la détection automatique du format de journal AWS Redshift.
  * Ajouter le support du nouveau format de journal de pgbouncer 1.11.
  * Gérer les formats de compression zstd et lz4.
  * Permettre de séparer entièrement la construction des statistiques et celle du rapport HTML en mode incrémentiel, sans avoir à lire un fichier journal. Par exemple, il est possible d'exécuter pgBadger chaque heure comme suit :
        pgbadger -I -O "/out-dir/data" --noreport /var/log/postgresql*.log
    
Il crée simplement les fichiers binaires de données dans "/out-dir/data", puis, par exemple, vous pouvez générer des rapports chaque soir pour la journée suivante dans un répertoire séparé `/out-dir/reports` :
        pgbadger -I -l "/out-dir/data/LAST_PARSED" -H "/out-dir/reports" /out-dir/data/2020/02/19/*.bin
    
    Cela nécessite de définir le chemin vers les informations analysées pour la dernière fois, le chemin où les rapports HTML seront écrits et le fichier binaire de données de la journée.

Il existe également de nouvelles options de ligne de commande :

  * Ajoute une nouvelle option de ligne de commande --explain-url utilisée pour remplacer l'URL de l'outil d'explication graphique. L'URL par défaut est :
        http://explain.depesz.com/?is_public=0&is_anon=0&plan=
    
    Si vous souhaitez utiliser une installation locale de PgExplain ou un autre outil.
    pgBadger ajoutera le plan au format texte, échappé, à la fin de l'URL.

  * Ajoutez l'option --no-week pour indiquer à pgBadger de ne pas générer de rapports hebdomadaires en mode incrémentiel. Utile si cela prend trop de temps et de ressources.

  * Ajoutez l'option de ligne de commande --command afin de pouvoir définir une commande
    que pgBadger exécutera pour récupérer les entrées de journal sur stdin.
    pgBadger ouvrira un tube vers la commande et analysera les entrées de journal
    générées par celle-ci. Par exemple :
      pgbadger -f stderr --command 'cat /var/log/postgresql.log'
    
    ce qui revient à exécuter pgBadger en spécifiant directement le fichier journal en argument. L'intérêt de cette option est évident si vous devez modifier le fichier journal en temps réel ou si les entrées de journal sont extraites d’un programme ou générées à partir d’une base de données. Par exemple :

      pgbadger -f csv --command 'psql dbname -c "COPY jrn_log TO STDOUT (FORMAT CSV)"'
    
  * Ajoutez l'option de ligne de commande --noexplain pour empêcher pgBadger de parser et de rapporter les plans d'exécution écrits dans le journal par l'extension auto_explain. Cela est utile si vous utilisez une version de PostgreSQL inférieure à 9.0, où pgBadger génère des rapports corrompus lorsqu'un plan d'exécution est présent dans le journal.

Compatibilité descendante :

  -  Par défaut, pgBadger tronque les requêtes jusqu'à 100000 caractères.
      Cette valeur arbitraire peut être ajustée à l'aide de l'option --maxlength..
      Le comportement précédent consistait à ne pas tronquer les requêtes, mais cela pouvait entraîner une utilisation excessive des ressources. Limiter la taille par défaut est plus sûr, et la limite de taille permet généralement d'éviter le troncature dans la majorité des cas. Toutefois, les requêtes ne seront pas reformattées si elles dépassent 25000 caractères.

Voici la liste complète des modifications et des remerciements :

  - Correction de l'option --exclude-client non fonctionnelle. Remerciements à John Walsh pour le signalement.
  - Ajout d'un test de régression pour l'analyse des fichiers journaux RDS et --exclude-client.
  - Correction de la barre de progression pour les fichiers journaux de pgbouncer. L'étiquette « queries » est désormais « stats » pour les fichiers journaux de pgbouncer.
  - Ajout de l'option en ligne de commande --explain-url permettant de remplacer l'URL de l'outil d'explication graphique. Remerciements à Christophe Courtois pour la demande de fonctionnalité.
  - Ajout du support du nouveau format de fichier journal de pgbouncer 1.11. Remerciements à Dan Aksenov pour le signalement.
  - Gestion des formats de compression zstd et lz4. Remerciements à Adrien Nayrat pour le correctif.
  - Ajout du support et de la détection automatique du format de fichier journal AWS Redshift. Remerciements à Bhuvanesh pour la demande de fonctionnalité.
  - Mise à jour de la documentation concernant le format de fichier journal Redshift.
  - Ajout de la nouvelle option --no-week pour indiquer à pgBadger de ne pas générer de rapports hebdomadaires en mode incrémentiel. Remerciements à cleverKermit17 pour la demande de fonctionnalité.
  - Correction d'un motif de correspondance sur le chemin du fichier qui provoquait une panne de pgBadger sous Windows.
  - Correction du problème #554 concernant les paramètres d'instruction encodés en cyrillique et autres, qui n'étaient pas correctement rapportés dans le rapport HTML même avec un jeu de caractères personnalisé. La régression avait été introduite par une correction de l'erreur Perl bien connue « Wide character in print ». Le correctif a été annulé et une nouvelle option en ligne de commande : --wide-char est désormais disponible pour restaurer ce comportement. Ajoutez cette option à votre commande pgbadger si vous obtenez le message « Wide character in print ». Ajout d'un test de régression avec des encodages cyrillique et français. Remerciements à 4815162342lost et yethee pour le signalement.
  - Mise à jour de la documentation pour indiquer que lc_messages = 'en_US.UTF-8' est également valide. Remerciements à nodje pour le signalement.
  - Mise à jour de la documentation concernant --maxlength dont la taille par défaut de troncature est désormais 100000 et plus pas de troncature par défaut. Remerciements à nodje pour le signalement.
  - Correction du calcul de rétention à la frontière d'année. Remerciements à Fabio Pereira pour le correctif.
  - Correction de l'analyse du format de fichier journal RDS. Remerciements à Kadaffy Talavera pour le signalement.
  - Empêcher la génération d'un fichier d'index vide en mode incrémentiel lorsque aucune nouvelle entrée de journal n'est présente. Remerciements à Kadaffy Talavera pour le signalement.
  - Correction de la documentation non à jour. Remerciements à Eric Hanson pour le correctif.
  - Correction du paramètre en ligne de commande de -no-explain à -noexplain.. Remerciements à Indrek Toom pour le correctif.
  - Passer à la taille de fichier par défaut lorsque totalsize n'est pas disponible. Remerciements à Adrien Nayrat pour le correctif.
  - Correction de certaines dates dans les exemples. Remerciements à Greg Clough pour le correctif.
  - Utilisation de l'expression régulière des extensions de fichiers compressés dans les tests restants et extraction de l'extension .bin dans une condition séparée.
  - Gestion des formats de compression zstd et lz4. Remerciements à Adrien Nayrat pour le correctif.
  - Correction de l'appel restant de SIGUSR2 sous Windows. Remerciements à inrap pour le signalement.
  - Correction de la barre de progression avec les fichiers journaux de taille indéterminée.
  - Ajout de la nouvelle option en ligne de commande --command permettant de définir une commande que pgBadger exécutera pour récupérer les entrées de journal sur stdin. Remerciements à Justin Pryzby pour la demande de fonctionnalité.
  - Ajout de la nouvelle option en ligne de commande --noexplain pour empêcher pgBadger d'analyser et de rapporter les plans d'exécution écrits dans le journal par l'extension auto_explain. Cela est utile si vous utilisez une version de PostgreSQL inférieure à 9.0, où pgBadger génère des rapports corrompus lorsqu'un plan d'exécution est présent dans le journal. Remerciements à Massimo Sala pour la demande de fonctionnalité.
  - Correction de l'analyse des fichiers journaux RDS lorsque le préfixe est défini en ligne de commande. Remerciements à Bing Zhao pour le signalement.
  - Correction du mode incrémentiel avec le format de fichier journal RDS. Remerciements à Bing Zhao pour le signalement.
  - Correction possible de l'analyse des fichiers journaux RDS. Remerciements à James van Lommel et Simon Dobner pour le signalement.
  - Correction de la classification des requêtes et ajout d'un test de régression. Remerciements à alexanderlaw pour le signalement.
  - Correction de l'anonymisation des caractères simples dans les clauses IN. Remerciements à Massimo Sala pour le signalement.
  - Correction de l'analyse des fichiers journaux RDS pour les lignes sans informations client/utilisateur/base de données. Remerciements à Konrad pour le signalement.

## v11.1 · 2019-09-16 {#v11-1}

Cette version de pgBadger corrige plusieurs problèmes signalés par les utilisateurs depuis trois mois. Elle introduit également certaines nouvelles fonctionnalités et rapports :

  - Ajouter un rapport des N requêtes les plus coûteuses en temps durant les étapes de préparation ou d'analyse.
  - Ajouter un rapport des N requêtes les plus coûteuses en temps durant l'étape de liaison.
  - Ajouter un rapport des durées des différentes parties d'une requête : préparation/liason/exécution.
      Affiché dans un nouvel onglet « Durée » du rapport des statistiques globales. Exemple :
        Durée totale de la requête : 6m16s
        Durée totale de la préparation/analyse : 45s564ms
        Durée totale de la liaison : 4m46s
        Durée totale de l'exécution : 44s71m
      Cela corrige également le rapport précédent de « Durée totale de la requête », qui ne rapportait que la durée totale d'exécution.
  - Ajouter le support des formats de journaux RDS et CloudWatch, détectés automatiquement. Vous pouvez utiliser -f rds si pgBadger n'est pas en mesure de détecter automatiquement le format du journal.
  - Ajouter une nouvelle option de configuration --month-report afin de pouvoir générer des rapports incrémentiels mensuels.
  - Restaurer le support du système d'exploitation Windows.

Il existe également quelques corrections de bogues et améliorations de fonctionnalités.

  - Ajouter la documentation Markdown générée automatiquement dans README.md à l'aide de l'outil pod2markdown. Si la commande n'est pas disponible, le fichier ne sera tout simplement pas généré. Merci à Derek Yang pour le correctif.
  - Traduire l'action WITH en CTE, correction d'un bug de régression introduit dans la dernière version.
  - Corriger la prise en charge du système d'exploitation Windows.
  - Ajouter la prise en charge des formats de journaux RDS et CloudWatch, utiliser -f si pgBadger n'est pas en mesure de détecter automatiquement ce format de journal. Merci à peruuparkar pour la demande de fonctionnalité.
  - Corriger l'option -f | --format qui n'était pas appliquée à tous les fichiers extraits de la liste de paramètres, où la détection automatique du format de journal échouait ; le format était pris à partir du premier fichier analysé. Merci à Levente Birta pour le signalement.
  - Mettre à jour le fichier de documentation source pour remplacer la référence à pgBadger v7.x par v11. Merci à Will Buckner pour le correctif.
  - Limite la taille d'affichage des requêtes les plus fréquentes afin d'éviter de remplir toute la page avec des requêtes très longues. Merci à ilias ilisepe1 pour le correctif.
  - Corriger le débordement des requêtes et des détails dans les requêtes les plus lentes.
  - Corriger les URI SSH pour les fichiers, répertoires et caractères génériques. Merci à tbussmann pour le correctif.
  - Corriger les exemples d'URI dans la documentation. Merci à tbussmann pour le correctif.
  - Masquer le message d'utilisation du fichier de sortie par défaut lorsque --rebuild est utilisé.
  - Ajouter une ligne vide supplémentaire à la sortie de la fonction usage() afin d'éviter que la documentation POD ne soit coupée lors de la compilation.
  - Réappliquer la description de l'option --exclude-client dans la documentation. Merci à Christoph Berg pour le signalement.

## v11.0 · 2019-06-25 {#v11-0}

Cette version de pgBadger introduit de nouvelles fonctionnalités majeures et corrige certains problèmes signalés par les utilisateurs au cours des quatre derniers mois. Nouvelles fonctionnalités :

  - Regrouper les requêtes liées au curseur (DECLARE, CLOSE, FETCH, MOVE) dans un nouveau type de requête CURSOR.
  - Ajouter les requêtes top bind générant un plus grand nombre de fichiers temporaires.
    Nécessite que log_connection et log_disconnection soient activés.
  - Ajouter l'option en ligne de commande --exclude-client afin de pouvoir exclure les entrées de journal pour une IP cliente spécifique. Peut être utilisée plusieurs fois.
  - Permettre l'utilisation de l'heure uniquement dans les filtres --begin et --end.
  - Ajouter les options -H et --html-dir afin de pouvoir définir un chemin différent où écrire le rapport HTML en mode incrémentiel. Les fichiers binaires restent dans le répertoire défini par l'option -O, --outdir.
  - Ajouter l'option -E | --explode afin de diviser le rapport principal en un rapport par base de données. Les informations globales non liées à une base sont ajoutées au rapport de la base postgres.
  - Ajouter le rapport par base de données en mode incrémentiel. En ce mode, un sous-répertoire par base de données sera créé, avec des rapports incrémentiels dédiés.
  - Ajouter le support du format logplex de Heroku pour PostgreSQL. Les journaux peuvent être analysés à l'aide de :

      heroku logs -p postgres | pgbadger -f logplex -o heroku.html -

  - Lorsqu'une requête dépasse 10 Ko, on limite d'abord la taille de tous les paramètres de chaîne de caractères constants à 30 caractères, puis on tronque la requête à 10 Ko. Cela empêche pgBadger de consommer du temps ou de bloquer avec des requêtes très longues, par exemple lors de l'insertion de données bytea. La limite de 10 Ko peut être ajustée à l'aide du paramètre en ligne de commande --maxlength. La normalisation ou le troncature de la requête à la valeur maxlength n'est effectuée qu'après cette première étape de limitation de taille.

Cette nouvelle version rompt la compatibilité descendante avec les anciens fichiers binaires ou JSON. Cela signifie également que le mode incrémentiel ne pourra pas lire les anciens fichiers binaires. Si vous souhaitez mettre à jour pgBadger tout en conservant vos anciens rapports, veillez à effectuer la mise à jour au début d'une nouvelle semaine, sinon le rapport hebdomadaire sera corrompu. pgBadger affichera un avertissement et ignorera simplement le fichier binaire ancien.

Il existe également quelques corrections de bogues et améliorations de fonctionnalités.

  - Ajouter un avertissement concernant la version et ignorer le chargement du fichier binaire incompatible.
  - Mettre à jour le formateur de code pour pgFormatter 4.0.
  - Corriger le blocage de pgBadger sous le système d'exploitation Windows. Remerciements à JMLessard pour le rapport.
  - Mettre à jour le script tools/pgbadger_tools pour assurer la compatibilité avec le nouveau format binaire introduit dans pgBadger v11.
  - Ajouter les requêtes bindées les plus fréquentes générant le plus de fichiers temporaires. Cette collecte est possible uniquement si les options log_connection et log_disconnection sont activées dans postgresql.conf. Remerciements à Ildefonso Camargo pour la demande de fonctionnalité.
  - Corriger la détection automatique du fuseau horaire. Remerciements à massimosala pour la correction.
  - Supprimer certains graphiques restants lorsque --nograph est utilisé.
  - Forcer l'utilisation de l'extension .txt lorsque --normalized-only est utilisé.
  - Corriger l'affichage des rapports d'auto-vacuum/analyze au format logplex. Remerciements à Konrad zichul pour le rapport.
  - Corriger l'utilisation de la barre de progression sous le système d'exploitation Windows. Remerciements à JMLessard pour le rapport.
  - Utiliser une variable `$prefix_vars{'t_time'} pour stocker l'heure du journal. Remerciements à Luca Ferrari pour le correctif.
  - Mettre à jour l'aide et la documentation pour supprimer la commande perl des appels à pgBadger. Remerciements à Luca Ferrari pour le correctif.
  - Utiliser begin et end avec des heures sans date. Remerciements à Luca Ferrari pour le correctif.
  - Ajouter quelques corrections mineures d'orthographe et de grammaire dans le fichier readme. Remerciements à ofni yratilim pour le correctif.
  - Corriger les chemins distants utilisant SSH. Remerciements à Luca Ferrari pour le correctif.
  - Mettre à jour les tests de régression pour qu'ils fonctionnent avec la nouvelle structure introduite par la fonctionnalité de rapport par base de données.
  - Corriger les secondes fractionnaires dans tous les paramètres begin et end. Remerciements à Luca Ferrari pour le correctif.
  - Corriger l'URL de la documentation. Remerciements à Kara Mansel pour le rapport.
  - Corriger l'analyse de auto_explain.
    Ajouter plus d'informations sur l'option -U pouvant être utilisée plusieurs fois.
    Remerciements à Douglas J Hunley pour le rapport.
  - Nombreuses améliorations du rapport HTML / CSS. Remerciements à Pierre Giraud pour les correctifs.
  - Mettre à jour le fichier de ressources.
  - Ajouter un test de régression pour le format logplex.
  - Ajouter le support du format logplex de Heroku. Vous devriez pouvoir analyser ces journaux comme suit :
        heroku logs -p postgres | pgBadger -f logplex -o heroku.html -
    ou si vous avez déjà enregistré la sortie dans un fichier :
        pgBadger heroku.log
    Le format logplex est détecté automatiquement comme tout autre format pris en charge.
    pgBadger comprend les préfixes par défaut suivants pour log_line_prefix :
        database = %d connection_source = %r sql_error_code = %e
    ou simplement :
        sql_error_code = %e
    Faites-moi savoir s'il existe d'autres préfixes par défaut. Le préfixe peut toujours être défini à l'aide de l'option -p | --prefix de pgBadger :
        pgBadger --p 'base = %d source = %r sql_state = %e' heroku.log
    par exemple.
    Remerciements à Anthony Sosso pour la demande de fonctionnalité.
  - Corriger l'aide de pgBadger pour les URI.
  - Corriger l'utilisation incorrecte des caractères génériques dans les URI SSH introduite dans le correctif précédent.
    Remerciements à Tobias Bussmann pour le rapport.
  - Permettre les URI contenant des espaces dans le chemin du fichier journal. Remerciements à Tobias Bussmann pour le rapport.
  - Corriger les exemples d'URI dans la documentation. Remerciements à Tobias Bussmann pour le correctif.
  - Corriger t/02_basics.t pour qu'il ne faille pas si le test syslog prend plus de 10 secondes. Remerciements à Christoph Berg pour le correctif.

---

Liens inverses :

- [Historique des versions](/fr/docs/pgbadger/releases/)
