Référence on PIG.CENTER

Notes de version pgBadger 13.x

Mon, 01 Jan 0001 00:00:00 +0000

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

v13.2 · 2025-12-29

Il s’agit d’une version de maintenance de pgBadger qui corrige des problèmes et applique des correctifs signalés par les utilisateurs depuis la dernière version.

Corriger la normalisation qui ne traitait pas correctement les chaînes entre guillemets simples équilibrées, y compris les guillemets échappés à l’intérieur. Remerciements à Bertrand Bourgier pour le rapport.
Corriger les exigences relatives aux espaces réservés dans la documentation.
Corriger le cas où aucune entrée d’exemple d’erreur n’était rapportée. Remerciements à john doe pour le rapport.
Corriger un problème potentiel de priorité entre ! et %s. Remerciements à Luca Santarelli et Philipp Trulson pour le rapport.
Mettre à jour le code pgFormatter à la version 5.9
Ajouter une action CI GitHub pour le test lors de la poussée de commit.
Corriger l’analyse du placeholder %r dans log_line_prefix. Remerciements à nike7o0 pour le rapport.
Corriger l’avertissement relatif à une valeur non initialisée. Remerciements à Ales Zeleny pour le rapport.
Améliorer la documentation des options SSH pour l’analyse des journaux PostgreSQL avec des exemples. Remerciements à Ulrich Konrad pour le correctif.
Ajouter la commande –ssh-sudo pour exécuter des commandes en SSH en tant que sudo. Remerciements à Andrew Jackson pour le correctif.
Corriger un problème potentiel de priorité entre ! et l’égalité de chaîne. Remerciements à Adrien Nayrat pour le rapport.
Corriger l’analyse des statistiques de pgbouncer. Remerciements à mrgtt pour le rapport.

v13.1 · 2025-03-16

Il s’agit d’une version de maintenance de pgBadger qui corrige des problèmes signalés par les utilisateurs depuis la dernière version et ajoute certaines nouvelles fonctionnalités :

Actualités

Mon, 01 Jan 0001 00:00:00 +0000

pgBackRest 2.59.1 publié

17 août 2026

La communauté pgBackRest est heureuse d’annoncer la sortie de pgBackRest 2.59.1, la dernière version de la solution fiable, facile à utiliser, de sauvegarde et de restauration, pouvant s’adapter sans heurt aux plus grandes bases de données et charges de travail.

pgBackRest prend en charge un ensemble complet de fonctionnalités pour gérer votre infrastructure de sauvegarde et de récupération, notamment : sauvegarde/restauration en parallèle, sauvegardes complètes/différentielles/sauvegardes incrémentielles, sauvegarde incrémentielle par bloc, plusieurs dépôts, restauration par delta, archivage asynchrone en parallèle, protection contre les logiciels malveillants/rançongiciels, sommes de contrôle par fichier, sommes de contrôle par page (lorsqu’activées) validées pendant la sauvegarde, plusieurs types de compression, chiffrement, reprise partielle/échouée de sauvegarde, sauvegarde depuis un serveur secondaire, prise en charge des espaces de table et des liens, prise en charge de S3/Azure/GCS/SFTP, expiration des sauvegardes, opérations locales/distantes via SSH ou TLS, configuration flexible, et bien plus encore.

Commande d'annotation (annotate)

Mon, 01 Jan 0001 00:00:00 +0000

Les annotations incluses avec la commande backup peuvent être ajoutées, modifiées ou supprimées ultérieurement à l’aide de la commande annotate.

Options de commande

Option d’annotation de sauvegarde (`--annotation`)

Ajoutez des paires clé/valeur définies par l’utilisateur à la sauvegarde.

Les utilisateurs peuvent attacher des paires clé/valeur explicatives à la sauvegarde. Cette option peut être utilisée plusieurs fois pour attacher plusieurs annotations.

Paramètres de configuration dynamique

Mon, 01 Jan 0001 00:00:00 +0000

La configuration dynamique est stockée dans le magasin de configuration distribué (DCS) et appliquée sur tous les nœuds du cluster.

Pour modifier la configuration dynamique, vous pouvez utiliser soit l’outil patronictl_edit_config , soit l’API REST de Patroni REST API .

loop_wait : nombre de secondes pendant lesquelles la boucle s’endort. Valeur par défaut : 10, valeur minimale possible : 1
ttl : durée de vie du verrou de leader (en secondes). Pensez-y comme la durée avant le déclenchement du processus de basculement automatique. Valeur par défaut : 30, valeur minimale possible : 20
retry_timeout : délai d’attente pour les nouvelles tentatives des opérations DCS et PostgreSQL (en secondes). Les problèmes DCS ou réseau de durée inférieure à cette valeur ne provoqueront pas la désactivation du leader par Patroni. Valeur par défaut : 10, valeur minimale possible : 3

[!AVERTISSEMENT]

Paramètres de configuration YAML

Mon, 01 Jan 0001 00:00:00 +0000

Global/Universel

thread_pool_size : taille du pool de threads utilisé par Patroni pour exécuter les tâches asynchrones et communiquer via l’API REST avec les autres membres lors d’une course au leader ou lors de vérifications en mode d’urgence. Valeur minimale : 5, valeur par défaut : 5.
thread_stack_size : spécifie la taille de la pile à utiliser pour les threads lancés par Patroni. La valeur doit être alignée sur 64kB. Valeur minimale : 64kB, valeur par défaut (définie par Patroni) : 512kB.
name : le nom de l’hôte. Doit être unique dans le cluster. La valeur __patroni_strict_sync_replica_placeholder__ est réservée à une utilisation interne par Patroni et ne peut pas être utilisée comme nom de nœud.
namespace : chemin dans le magasin de configuration où Patroni stockera les informations sur le cluster. Valeur par défaut : “/service”
scope : nom du cluster

Notes de version de pgBadger 12.x

Mon, 01 Jan 0001 00:00:00 +0000

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

v12.4 · 2023-12-25

Il s’agit d’une version de maintenance de pgBadger qui corrige les problèmes signalés par les utilisateurs depuis la dernière version.

Correction du rapport pgbouncer avec la version 1.21. Remerciements à Ales Zeleny pour le correctif.
Empêcher que le parallélisme du fichier Perl dépasse le nombre de fichiers. Remerciements à maliangzhu pour le signalement.
Correction du test de régression cassé depuis la version 12.3. Remerciements à ieshin pour le signalement.
Correction des cas où les entrées LOG étaient comptées comme des entrées de niveau d’erreur. Remerciements à Matti Linnanvuori pour le signalement.

v12.3 · 2023-11-27

Il s’agit d’une version de maintenance de pgBadger qui corrige des problèmes signalés par les utilisateurs depuis la dernière version. Elle introduit également quelques nouvelles fonctionnalités :

Commande d’archive (archive-get)

Mon, 01 Jan 0001 00:00:00 +0000

Cette commande est utilisée par PostgreSQL pour effectuer une restauration, une récupération jusqu’à un instant précis (PITR), ou en tant qu’alternative au streaming afin de maintenir une réplique à jour. Les segments WAL sont requis pour la récupération de PostgreSQL ou pour maintenir une réplique.

Lorsque plusieurs dépôts sont configurés, les fichiers WAL seront récupérés dans l’ordre de priorité des dépôts (par exemple repo1, repo2, etc.). En général, il est préférable que les dépôts plus rapides ou moins coûteux aient une priorité plus élevée. Si un dépôt est spécifié avec l’option --repo, seul ce dépôt sera recherché.

Configuration : pgbouncer.ini

Mon, 01 Jan 0001 00:00:00 +0000

Description

Le fichier de configuration est au format « ini ». Les noms de section sont entre [ et ]. Les lignes commençant par ; ou # sont traitées comme des commentaires et ignorées. Les caractères ; et # ne sont pas reconnus comme spéciaux lorsqu’ils apparaissent ultérieurement dans la ligne.

Paramètres génériques

fichier_journal

Spécifie le fichier de journalisation. En mode démon (-d), il faut définir soit ce paramètre, soit syslog.

Notes de version de pgBadger 11.x

Mon, 01 Jan 0001 00:00:00 +0000

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

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 :

Commande de poussée d'archive (archive-push)

Mon, 01 Jan 0001 00:00:00 +0000

Accepte un segment WAL de PostgreSQL et l’archive dans chaque dépôt défini par l’option indexée repo-path (voir la section Repository pour obtenir des informations sur la configuration des dépôts). Le segment WAL peut être envoyé immédiatement à l’archive ou stocké localement, selon la valeur de archive-async. En cas de configuration de plusieurs dépôts, archive-push tentera d’envoyer à autant de dépôts que possible.

Le archive-push est destiné à être configuré et appelé par PostgreSQL. Voir Configurer la sauvegarde d’archive pour un exemple.

Paramètres de configuration de l'environnement

Mon, 01 Jan 0001 00:00:00 +0000

Il est possible de remplacer certains paramètres de configuration définis dans le fichier de configuration Patroni à l’aide des variables d’environnement système. Ce document liste toutes les variables d’environnement prises en charge par Patroni. Les valeurs définies via ces variables ont toujours priorité sur celles définies dans le fichier de configuration Patroni.

Global/Universel

PATRONI_CONFIGURATION : il est possible de définir toute la configuration de Patroni via la variable d’environnement PATRONI_CONFIGURATION . Dans ce cas, aucune autre variable d’environnement ne sera prise en compte !
PATRONI_THREAD_POOL_SIZE : taille du pool de threads utilisé par Patroni pour exécuter les tâches asynchrones et communiquer via l’API REST avec les autres membres lors d’une course au leader ou lors de vérifications en mode d’urgence. La valeur minimale est 5, la valeur par défaut est 5.
PATRONI_THREAD_STACK_SIZE : spécifie la taille de pile à utiliser pour les threads lancés par Patroni. La valeur doit être alignée sur 64kB. La valeur minimale est 64kB, la valeur par défaut (définie par Patroni) est 512kB.
PATRONI_NAME : nom du nœud sur lequel l’instance actuelle de Patroni est en cours d’exécution. Doit être unique dans le cluster. La valeur __patroni_strict_sync_replica_placeholder__ est réservée à une utilisation interne par Patroni et ne peut pas être utilisée comme nom de nœud.
PATRONI_NAMESPACE : chemin dans le magasin de configuration où Patroni conservera les informations sur le cluster. Valeur par défaut : “/service”
PATRONI_SCOPE : nom du cluster
PG_MALLOC_ARENA_MAX : valeur personnalisée pour la variable d’environnement MALLOC_ARENA_MAX du processus postmaster. Si non définie, postmaster héritera de la valeur de MALLOC_ARENA_MAX.

Journalisation

PATRONI_LOG_TYPE : définit le format des journaux. Peut être soit plain soit json. Pour utiliser le format json, vous devez avoir installé jsonlogger . La valeur par défaut est plain.
PATRONI_LOG_LEVEL : définit le niveau général de journalisation. La valeur par défaut est INFO (voir la documentation sur le module logging de Python )
PATRONI_LOG_TRACEBACK_LEVEL : définit le niveau auquel les traces d’erreur seront visibles. La valeur par défaut est ERROR. Définissez-la sur DEBUG si vous souhaitez voir les traces d’erreur uniquement lorsque PATRONI_LOG_LEVEL=DEBUG est activé.
PATRONI_LOG_FORMAT : définit la chaîne de formatage des journaux. Si le type de journal est plain, le format doit être une chaîne. Reportez-vous à les attributs LogRecord pour obtenir la liste des attributs disponibles. Si le type de journal est json, le format peut être une liste en plus d’une chaîne. Chaque élément de la liste doit correspondre à un attribut LogRecord. Prenez garde à ce que seul le nom du champ est requis, et que les %( et ) doivent être omis. Si vous souhaitez afficher un champ de journal avec un nom de clé différent, utilisez un dictionnaire où la clé du dictionnaire est le champ de journal, et la valeur est le nom du champ que vous souhaitez afficher dans le journal. Valeur par défaut : %(asctime)s %(levelname)s: %(message)s
PATRONI_LOG_DATEFORMAT : définit la chaîne de formatage de la date et de l’heure. (voir la documentation de formatTime() )
PATRONI_LOG_STATIC_FIELDS : ajoute des champs supplémentaires au journal. Cette option n’est disponible que lorsque le type de journal est défini sur json. Exemple PATRONI_LOG_STATIC_FIELDS="{app: patroni}"
PATRONI_LOG_MAX_QUEUE_SIZE : Patroni utilise une journalisation en deux étapes. Les enregistrements de journal sont écrits dans une file mémoire et un thread distinct extrait ces enregistrements de la file pour les écrire sur stderr ou dans un fichier. La taille maximale de la file interne est limitée par défaut à 1000 enregistrements, ce qui suffit à conserver les journaux des dernières 1h20.
PATRONI_LOG_DIR : Répertoire dans lequel écrire les journaux d’application. Le répertoire doit exister et être accessible en écriture par l’utilisateur exécutant Patroni. Si vous définissez cette variable d’environnement, l’application conservera par défaut 4 fichiers de journaux de 25 Mo chacun. Vous pouvez ajuster ces valeurs de rétention à l’aide de PATRONI_LOG_FILE_NUM et PATRONI_LOG_FILE_SIZE (voir ci-dessous).
PATRONI_LOG_MODE : Permissions des fichiers de journal (par exemple, 0644). Si non spécifié, les permissions seront déterminées en fonction de la valeur actuelle de umask.
PATRONI_LOG_FILE_NUM : Nombre de journaux d’application à conserver.
PATRONI_LOG_FILE_SIZE : Taille du fichier patroni.log (en octets) qui déclenche un roulement du journal.
PATRONI_LOG_LOGGERS : Redéfinir le niveau de journalisation par module Python. Exemple PATRONI_LOG_LOGGERS="{patroni.postmaster: WARNING, urllib3: DEBUG}".
PATRONI_LOG_DEDUPLICATE_HEARTBEAT_LOGS : Si défini à true, les journaux de battement de cœur identiques successifs ne seront pas affichés. La valeur par défaut est false.

[!AVERTISSEMENT]

Configuration Patroni

Mon, 01 Jan 0001 00:00:00 +0000

Il existe 3 types de configuration Patroni :

Configuration dynamique globale pending_restart . Ces options sont stockées dans le magasin de configuration distribué (DCS) et appliquées sur tous les nœuds du cluster. La configuration dynamique peut être définie à tout moment à l’aide de l’outil patronictl_edit_config ou de l’API REST de Patroni REST API . Si les options modifiées ne font pas partie de la configuration au démarrage, elles sont appliquées de manière asynchrone (lors du prochain cycle de réveil) sur chaque nœud, qui est ensuite rechargé. Si le nœud nécessite un redémarrage pour appliquer la configuration (pour les paramètres PostgreSQL avec contexte postmaster, lorsque leurs valeurs ont changé), un indicateur spécial pending_restart indiquant cela est défini dans le fichier JSON members.data. En outre, l’état du nœud indique cela en affichant "restart_pending": true.

Référence en ligne de commande

Mon, 01 Jan 0001 00:00:00 +0000

Cette page conserve la référence de commande générée à partir de la source upstream verrouillée. Les noms d’option et le texte d’aide restent tels quels afin de pouvoir être comparés directement avec pgbadger --help.

Utilisation et options

Utilisation : pgBadger [options] fichier_journal […]

PostgreSQL log analyzer with fully detailed reports and graphs.

Arguments :

logfile can be a single log file, a list of files, or a shell command
returning a list of files. If you want to pass log content from stdin
use - as filename. Note that input from stdin will not work with csvlog.

Options :

Notes de version pgBadger 10.x

Mon, 01 Jan 0001 00:00:00 +0000

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

v10.3 · 2019-02-14

Cette version de pgBadger est une mise à jour de maintenance qui corrige certains problèmes de détection automatique du format de journalisation, ainsi qu’un autre problème de lecture des journaux de pgBouncer signalé par les utilisateurs. Une nouvelle fonctionnalité est également disponible :

The -o | --outfile option can now be used multiple time to dump
output in several format in a single command. For example:
 pgbadger -o out.html -o out.json /log/pgsql-11.log
will create two reports in html and json format saved in the
two corresponding files.

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

API REST Patroni

Mon, 01 Jan 0001 00:00:00 +0000

Patroni dispose d’une API REST riche, utilisée par Patroni lui-même lors de la course au leader, par l’outil patronictl afin d’effectuer des basculements, des basculements planifiés, des réinitialisations, des redémarrages ou des rechargements, par HAProxy ou tout autre équilibreur de charge pour effectuer des vérifications de santé HTTP, et bien entendu également utilisée pour la surveillance. Ci-dessous figure la liste des points d’accès de l’API REST de Patroni.

Points de terminaison de vérification de santé

Pour toutes les requêtes de vérification de santé GET, Patroni renvoie un document JSON indiquant l’état du nœud, accompagné du code d’état HTTP. Si vous ne souhaitez pas ou n’avez pas besoin du document JSON, vous pouvez envisager d’utiliser la méthode HEAD ou OPTIONS au lieu de GET.

Commande de sauvegarde (backup)

Mon, 01 Jan 0001 00:00:00 +0000

Lorsque plusieurs dépôts sont configurés, pgBackRest effectuera la sauvegarde vers le dépôt de priorité la plus élevée (par exemple repo1) sauf si l’option --repo est spécifiée.

pgBackRest ne dispose pas de planificateur intégré, il est donc préférable de l’exécuter depuis cron ou un autre mécanisme de planification.

Consultez Effectuer une sauvegarde pour plus de détails et d’exemples.

Options de commande

Option d’annotation de sauvegarde (`--annotation`)

Ajoutez des paires clé/valeur définies par l’utilisateur à la sauvegarde.

Référence des commandes

Mon, 01 Jan 0001 00:00:00 +0000

Introduction

Les commandes sont utilisées pour exécuter les différentes fonctions de pgBackRest. Ici, les options de commande sont listées de manière exhaustive, c’est-à-dire que chaque option applicable à une commande est indiquée avec cette commande, même si elle s’applique à une ou plusieurs autres commandes. Cela inclut toutes les options qui peuvent également être configurées dans pgbackrest.conf.

Les options non booléennes configurées dans pgbackrest.conf peuvent être réinitialisées à leur valeur par défaut en ligne de commande en utilisant le préfixe reset-. Cette fonctionnalité peut être utilisée pour effectuer une restauration directement sur un hôte de dépôt. En règle générale, pgBackRest génère une erreur car il détecte que l’hôte de base de données est distant et qu’une restauration ne peut pas être effectuée à distance. En ajoutant --reset-pg1-host en ligne de commande, pgBackRest ignore l’hôte de base de données distant et effectue la restauration localement. Il peut être nécessaire de passer un nouvel --pg1-path pour forcer la restauration à se produire dans un chemin spécifique, c’est-à-dire non pas le chemin utilisé sur l’hôte de base de données.

Notes de version de pgBadger 9.x

Mon, 01 Jan 0001 00:00:00 +0000

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

v9.2 · 2017-07-27

Cette version de pgBadger est une mise à jour de maintenance qui ajoute quelques nouvelles fonctionnalités.

Ajouter un rapport de distance entre les points de contrôle et une estimation.
Ajouter le support des mots-clés AWS Redshift dans le formateur de code SQL.
Ajouter la détection automatique du format du fichier journal en mode distant afin de permettre l’analyse distante du fichier journal de pgbouncer conjointement avec le fichier journal PostgreSQL.

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

Commande de vérification (check)

Mon, 01 Jan 0001 00:00:00 +0000

La commande check vérifie que pgBackRest et le paramètre archive_command sont correctement configurés pour l’archivage et les sauvegardes du stanza spécifié. Elle tente de vérifier tous les dépôts et bases de données configurés pour l’hôte sur lequel la commande est exécutée. Elle détecte les mauvaises configurations, en particulier celles relatives à l’archivage, qui entraînent des sauvegardes incomplètes car des segments WAL requis n’ont pas atteint l’archive. La commande peut être exécutée sur l’hôte PostgreSQL ou sur l’hôte dépôt. Elle peut également être exécutée sur l’hôte de basculement, toutefois, comme les opérations pg_switch_xlog()/pg_switch_wal() ne peuvent pas être effectuées sur le basculement, la commande ne testera que la configuration du dépôt.

Référence de configuration

Mon, 01 Jan 0001 00:00:00 +0000

Introduction

pgBackRest peut être utilisé entièrement à l’aide de paramètres en ligne de commande, mais un fichier de configuration est plus pratique pour les installations complexes ou celles qui définissent de nombreux paramètres. L’emplacement par défaut du fichier de configuration est /etc/pgbackrest/pgbackrest.conf. Si aucun fichier n’existe à cet emplacement, l’ancien emplacement par défaut de /etc/pgbackrest.conf sera vérifié.

Les types d’option suivants sont utilisés :

Chaîne : Une chaîne de texte, couramment utilisée comme identifiant, mot de passe, etc.

HAProxy 3.4.4 Documentation

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy est un proxy inverse gratuit, rapide et fiable pour la haute disponibilité, l’équilibrage de charge TCP et HTTP, ainsi que la gestion du trafic applicatif. Ce composant contient le texte intégral anglais des trois manuels principaux d’HAProxy 3.4, réorganisés sous forme d’une séquence lisible Markdown plate destinée à OINK.

Choisissez un manuel

Guide de démarrage — 9 sujets sur les concepts de répartition de charge, l’architecture HAProxy, les fonctionnalités, la dimensionnement, les versions et l’écosystème.
Manuel de configuration — 12 chapitres couvrant les proxies, les ACLs, les exemples, la journalisation, les filtres et chaque famille d’options.
Guide de gestion — 13 chapitres sur le démarrage, les rechargements, les ressources, la journalisation, les statistiques, la CLI d’exécution, le débogage et la sécurité.

Couverture édition

Manuel	Source amont	Organisation locale
Guide de démarrage	1 695 lignes	9 pages de sujet plat
Manuel de configuration	33 148 lignes	12 pages de chapitre plat
Guide de gestion	5 285 lignes	13 pages de chapitre plat

Les 34 pages de lecture sont directement situées sous la racine du composant HAProxy. Trois espaces réservés séparateurs non liés divisent les manuels dans la barre latérale sans ajouter de niveaux de répertoire ni d’arrêts de pagination.

patronictl

Mon, 01 Jan 0001 00:00:00 +0000

Patroni dispose d’une interface en ligne de commande nommée patronictl , utilisée principalement pour interagir avec l’API REST de Patroni et avec le DCS. Elle vise à simplifier l’exécution d’opérations au sein du cluster et peut être facilement utilisée par des humains ou des scripts.

Configuration

patronictl utilise trois sections de la configuration :

ctl : comment s’authentifier contre l’API REST de Patroni, et comment valider l’identité du serveur. Consulter paramètres ctl pour plus de détails ;
restapi : comment s’authentifier contre l’API REST de Patroni, et comment valider l’identité du serveur. N’est utilisé que si la configuration ctl est insuffisante. patronictl s’intéresse principalement à la section restapi.authentication (en cas de non-présence de ctl.authentication) et au paramètre restapi.cafile (en cas de non-présence de ctl.cacert). Consulter paramètres de l’API REST pour plus de détails ;
DCS (par exemple etcd) : comment contacter et s’authentifier contre le DCS utilisé par Patroni.

Ces options de configuration peuvent provenir soit de variables d’environnement, soit d’un fichier de configuration. Consultez les sections ci-dessus dans Paramètres de configuration par environnement ou Paramètres de configuration YAML pour comprendre comment définir ces options via des variables d’environnement ou un fichier de configuration.

Source Versions Téléchargement

Mon, 01 Jan 0001 00:00:00 +0000

PgBouncer 1.25

Fichier	Date	Taille	SHA256
pgbouncer-1.25.2.tar.gz	2026-05-08	865371 octets	sha256
pgbouncer-1.25.1.tar.gz	2025-12-03	864801 octets	sha256
pgbouncer-1.25.0.tar.gz	2025-11-09	863322 octets	sha256

PgBouncer 1.24

Fichier	Date	Taille	SHA256
pgbouncer-1.24.1.tar.gz	2025-04-16	717796 octets	sha256
pgbouncer-1.24.0.tar.gz	2025-01-10	706573 octets	sha256

PgBouncer 1.23

Fichier	Date	Taille	SHA256
pgbouncer-1.23.1.tar.gz	2024-08-02	700025 octets	sha256
pgbouncer-1.23.0.tar.gz	2024-07-03	694845 octets	sha256

PgBouncer 1.22

Fichier	Date	Taille	SHA256
pgbouncer-1.22.1.tar.gz	2024-03-04	677351 octets	sha256
pgbouncer-1.22.0.tar.gz	2024-01-31	670589 octets	sha256

PgBouncer 1.21

Fichier	Date	Taille	SHA256
pgbouncer-1.21.0.tar.gz	2023-10-16	668211 octets	sha256

PgBouncer 1.20

Fichier	Date	Taille	SHA256
pgbouncer-1.20.1.tar.gz	2023-08-09	638844 octets	sha256
pgbouncer-1.20.0.tar.gz	2023-07-20	638020 octets	sha256

PgBouncer 1.19

Fichier	Date	Taille	SHA256
pgbouncer-1.19.1.tar.gz	2023-05-31	623569 octets	sha256
pgbouncer-1.19.0.tar.gz	2023-05-04	616947 octets	sha256

PgBouncer 1.18

Fichier	Date	Taille	SHA256
pgbouncer-1.18.0.tar.gz	2022-12-12	600825 octets	sha256

PgBouncer 1.17

Fichier	Date	Taille	SHA256
pgbouncer-1.17.0.tar.gz	2022-03-23	598294 octets	sha256

PgBouncer 1.16

Fichier	Date	Taille	SHA256
pgbouncer-1.16.1.tar.gz	2021-11-11	591450 octets	sha256
pgbouncer-1.16.0.tar.gz	2021-08-09	592136 octets	sha256

PgBouncer 1.15

Fichier	Date	Taille	SHA256
pgbouncer-1.15.0.tar.gz	2020-11-19	588042 octets	sha256

PgBouncer 1.14

Fichier	Date	Taille	SHA256
pgbouncer-1.14.0.tar.gz	2020-06-11	578955 octets	sha256

PgBouncer 1.13

Fichier	Date	Taille	SHA256
pgbouncer-1.13.0.tar.gz	2020-04-27	574955 octets	sha256

PgBouncer 1.12

Fichier	Date	Taille	SHA256
pgbouncer-1.12.0.tar.gz	2019-10-17	567465 octets	sha256

PgBouncer 1.11

Fichier	Date	Taille	SHA256
pgbouncer-1.11.0.tar.gz	2019-08-27	571414 octets	sha256

PgBouncer 1.10

Fichier	Date	Taille	SHA256
pgbouncer-1.10.0.tar.gz	2019-07-01	480571 octets	sha256

PgBouncer 1.9

Fichier	Date	Taille	SHA256
pgbouncer-1.9.0.tar.gz	2018-08-13	469300 octets	sha256

PgBouncer 1.8

Fichier	Date	Taille	SHA256
pgbouncer-1.8.1.tar.gz	2017-12-20	465930 octets	sha256
pgbouncer-1.8.tar.gz	2017-12-19	465612 octets	sha256

PgBouncer 1.7

Fichier	Date	Taille	SHA256
pgbouncer-1.7.2.tar.gz	2016-02-26	462374 octets	sha256
pgbouncer-1.7.1.tar.gz	2016-02-18	461903 octets	sha256
pgbouncer-1.7.tar.gz	2015-12-18	459080 octets	sha256

PgBouncer 1.6

Fichier	Date	Taille	SHA256
pgbouncer-1.6.1.tar.gz	2015-09-03	431076 octets	sha256
pgbouncer-1.6.tar.gz	2015-08-01	412700 octets	sha256

PgBouncer 1.5

Fichier	Date	Taille	SHA256
pgbouncer-1.5.5.tar.gz	2015-04-09	336145 octets	sha256
pgbouncer-1.5.4.tar.gz	2012-11-28	339610 octets	sha256
pgbouncer-1.5.3.tar.gz	2012-09-12	339013 octets	sha256
pgbouncer-1.5.2.tar.gz	2012-05-29	335338 octets	sha256
pgbouncer-1.5.1.tar.gz	2012-04-17	334413 octets	sha256
pgbouncer-1.5.tar.gz	2012-01-05	411488 octets	sha256

PgBouncer 1.4

Fichier	Date	Taille	SHA256
pgbouncer-1.4.2.tgz	2011-06-16	283204 octets	sha256
pgbouncer-1.4.1.tgz	2011-04-01	282728 octets	sha256
pgbouncer-1.4.tgz	2011-01-11	231691 octets	sha256

PgBouncer 1.3

Fichier	Date	Taille	SHA256
pgbouncer-1.3.4.tgz	2010-09-09	167957 octets	sha256
pgbouncer-1.3.3.tgz	2010-05-10	167476 octets	sha256
pgbouncer-1.3.2.tgz	2010-03-15	166756 octets	sha256
pgbouncer-1.3.1.tgz	2009-07-06	161518 octets	sha256
pgbouncer-1.3.tgz	2009-02-18	160154 octets	sha256

PgBouncer 1.2

Fichier	Date	Taille	SHA256
pgbouncer-1.2.3.tgz	2008-08-08	145372 octets	sha256
pgbouncer-1.2.2.tgz	2008-08-06	145017 octets	sha256
pgbouncer-1.2.1.tgz	2008-08-04	144903 octets	sha256
pgbouncer-1.2.tgz	2008-07-29	143915 octets	sha256

PgBouncer 1.1

Fichier	Date	Taille	SHA256
pgbouncer-1.1.2.tgz	2007-12-10	122054 octets	sha256
pgbouncer-1.1.1.tgz	2007-10-26	121042 octets	sha256
pgbouncer-1.1.tgz	2007-10-09	120462 octets	sha256

PgBouncer 1.0

Fichier	Date	Taille	SHA256
pgbouncer-1.0.8.tgz	2007-06-18	93636 octets	sha256
pgbouncer-1.0.7.tgz	2007-04-19	93086 octets	sha256
pgbouncer-1.0.6.tgz	2007-04-12	92244 octets	sha256
pgbouncer-1.0.5.tgz	2007-04-11	91934 octets	sha256
pgbouncer-1.0.4.tgz	2007-04-11	91889 octets	sha256
pgbouncer-1.0.3.tgz	2007-04-11	91489 octets	sha256
pgbouncer-1.0.2.tgz	2007-03-28	90555 octets	sha256
pgbouncer-1.0.1.tgz	2007-03-15	89609 octets	sha256
pgbouncer-1.0.tgz	2007-03-13	88587 octets	sha256

Paquets binaires

Plusieurs distributions de systèmes d’exploitation proposent leur propre paquet ou port de PgBouncer. Il est donc recommandé de vérifier en premier lieu si celui-ci est déjà disponible sur votre système d’exploitation.

Commande d'expiration (expire)

Mon, 01 Jan 0001 00:00:00 +0000

pgBackRest effectue la rotation des sauvegardes complètes selon le type de rétention, qui peut être défini par un nombre ou une période de temps. Lorsqu’un nombre est spécifié, l’expiration n’est pas liée à la date de création des sauvegardes, mais au nombre de sauvegardes à conserver. Les sauvegardes différentielles sont basées sur un nombre, mais sont toujours expirées lorsque la sauvegarde complète dont elles dépendent est expirée. Les sauvegardes incrémentielles ne sont pas expirées indépendamment par rétention — elles sont toujours expirées en même temps que leur sauvegarde complète ou différentielle associée. Pour plus de détails et d’exemples, reportez-vous aux sections Rétention des sauvegardes complètes et Rétention des sauvegardes différentielles .

Notes de version

Mon, 01 Jan 0001 00:00:00 +0000

Introduction

Les numéros de version de pgBackRest se composent de deux parties : majeure et mineure. Une version majeure peut rompre la compatibilité avec la version majeure précédente, mais les versions v2 sont entièrement compatibles avec les dépôts v1 et acceptent toutes les options v1. Les versions mineures peuvent inclure des correctifs et des fonctionnalités, mais ne modifient pas le format du dépôt et s’efforcent d’éviter tout changement aux options et aux noms. La documentation de la version v1 est disponible ici . Les notes relatives à une version peuvent également contenir des « Notes supplémentaires », mais les modifications dans cette section n’ont d’impact direct que sur la documentation ou le jeu de tests et n’affectent pas le codebase de pgBackRest.

Taille et performance

Mon, 01 Jan 0001 00:00:00 +0000

Les valeurs typiques d’utilisation du processeur montrent que 15 % du temps de traitement sont consacrés à HAProxy contre 85 % au noyau en mode TCP ou HTTP fermé, et environ 30 % pour HAProxy contre 70 % pour le noyau en mode HTTP keep-alive. Cela signifie que le système d’exploitation et son réglage ont une influence forte sur les performances globales.

Questions fréquemment posées

Mon, 01 Jan 0001 00:00:00 +0000

Introduction

Les questions fréquemment posées ont pour but de fournir des précisions sur des questions spécifiques qui peuvent ou non être traitées dans le guide utilisateur, la configuration ou la référence des commandes. Si vous ne trouvez pas de réponse à votre problème particulier ici, n’oubliez pas que la liste des problèmes pgBackRest Issues List in GitHub constitue également une ressource précieuse.

Que faire si j’obtiens l’erreur « impossible de trouver le segment WAL » ?

La cause de cette erreur peut résulter de nombreux problèmes différents, dont certains peuvent être :

Formats de sortie

Mon, 01 Jan 0001 00:00:00 +0000

pgBadger sélectionne la sortie en fonction de l’extension du nom de fichier ou de -x / --extension. Utilisez -o / --outfile plus d’une fois pour générer plusieurs formats à partir du même analyse.

Format	Extension typique	Meilleur usage
HTML	`.html`	rapport interactif, lisible par l’humain avec graphiques
Texte	`.txt`	consultation en terminal et sortie archivée brute
Binaire	`.bin`	statistiques intermédiaires fusionnables et reconstructions de rapport
JSON	`.json`	intégration avec d’autres logiciels ; nécessite `JSON::XS`
CSV brut	fichier de sortie choisi	extraction orientée ligne avec `--dump-raw-csv`

HTML et texte

La sortie par défaut est out.html :

Commande d'aide (help)

Mon, 01 Jan 0001 00:00:00 +0000

Trois niveaux d’aide sont proposés. Si aucune commande n’est spécifiée, une aide générale sera affichée. Si une commande est précisée (par exemple pgbackrest help backup), une description complète de la commande sera affichée, accompagnée d’une liste des options valides. Si une option est précisée en plus d’une commande (par exemple pgbackrest help backup type), une description complète de l’option telle qu’elle s’applique à la commande sera affichée.

Options de commande

Afficher l’option d’aide (`--help`)

Affiche l’aide.

Journal des modifications

Mon, 01 Jan 0001 00:00:00 +0000

PgBouncer 1.25.x

2026-05-08 - PgBouncer 1.25.2 - “Touch humain avec une touche fraîche dans la course au titre pleine d’incertitudes

Sécurité
- Correctif CVE-2026-6664 : Une dépassement d’entier dans le code de traitement des paquets réseau de PgBouncer antérieur à la version 1.25.2 contourne une vérification de borne et peut entraîner un crash. Un attaquant distant non authentifié peut provoquer un crash de PgBouncer en envoyant un paquet d’authentification SCRAM malformé.
- Correctif CVE-2026-6665 : Le code SCRAM de PgBouncer antérieur à la version 1.25.2 ne vérifiait pas correctement la valeur de retour de strlcat() lors de la construction du contenu du message client-final SCRAM. Un serveur malveillant pouvant envoyer un message serveur-final SCRAM avec un nonce long peut déclencher un dépassement de pile.
- Correctif CVE-2026-6666 : Une référence vers un pointeur nul possible dans PgBouncer antérieur à la version 1.25.2 pouvait entraîner un crash si un serveur envoyait une réponse d’erreur sans champ SQLSTATE.
- Correctif CVE-2026-6667 : PgBouncer antérieur à la version 1.25.2 n’effectuait pas de vérification d’autorisation appropriée pour la commande KILL_CLIENT. Tous les utilisateurs ayant accès à la console d’administration, qui nécessite elle-même une authentification, pouvaient exécuter cette commande. Cette opération doit uniquement être autorisée pour les utilisateurs listés dans le paramètre admin_users.
Correctifs

Info Commande (info)

Mon, 01 Jan 0001 00:00:00 +0000

La commande info s’applique à une seule stanza ou à toutes les stanzas. La sortie texte est la valeur par défaut et fournit un résumé lisible par l’humain des sauvegardes pour la ou les stanzas demandées. Ce format peut évoluer à tout moment dans une version.

Pour une sortie lisible par machine, utilisez --output=json. La sortie JSON contient bien plus d’informations que la sortie texte et est maintenue stable, sauf en cas de bug.

Rapports d'exemple

Mon, 01 Jan 0001 00:00:00 +0000

Le contenu d’exemple a été généré par pgBadger 11.8 en mai 2022. Les exemples originaux sont stockés avec ce site, de sorte que la navigation dans le rapport, les graphiques, les styles et les scripts restent disponibles sans avoir à interroger le serveur d’origine.

Exemple	Ce qu’il illustre	Copie locale
Rapport complet	Activité PostgreSQL ainsi que les statistiques de PgBouncer	Ouvrir le rapport complet
Rapport incrémentiel	Index calendrier, agrégation hebdomadaire et pages quotidiennes	Ouvrir l’index incrémentiel
Erreurs et événements	Un rapport limité aux erreurs et aux événements opérationnels	Ouvrir le rapport d’erreurs

Rapport complet

Le rapport complet est un document HTML autonome. Utilisez la navigation en haut pour examiner les statistiques globales, les requêtes, les sessions, les connexions, les fichiers temporaires, les points de contrôle, l’activité d’autovacuum, les verrous et les graphiques spécifiques à PgBouncer.

Questions fréquemment posées

Mon, 01 Jan 0001 00:00:00 +0000

Comment se connecter à PgBouncer ?

PgBouncer agit comme un serveur Postgres, il suffit donc de configurer votre client pour qu’il se connecte au port de PgBouncer.

Comment équilibrer la charge des requêtes entre plusieurs serveurs ?

PgBouncer ne dispose pas de configuration interne multi-hôtes. Il est possible via des outils externes :

Round-robin DNS. Utilisez plusieurs adresses IP derrière un même nom DNS. PgBouncer ne résout pas le DNS à chaque nouvelle connexion. Il met en cache toutes les adresses IP et effectue le round-robin de manière interne. Note : si plus de 8 adresses IP sont associées à un même nom, le serveur DNS backend doit prendre en charge le protocole EDNS0. Voir le fichier README pour plus de détails.

Historique des versions

Mon, 01 Jan 0001 00:00:00 +0000

Le site officiel publie les annonces de version directement sur sa page d’accueil. Cette page s’arrête à la version 12.4 et répète accidentellement les versions 11.1 à 11.3 avec des dates contradictoires. Cette édition utilise comme référence canonique le dépôt upstream verrouillé ChangeLog, supprime uniquement ces rendus en double, et ajoute les versions ultérieures 13.x. Les entrées sont conservées en intégralité et triées par ordre décroissant de date au sein de chaque série.

Commande d'obtention de dépôt (repo-get)

Mon, 01 Jan 0001 00:00:00 +0000

Similaire à la commande unix cat mais fonctionne sur n’importe quel type de dépôt pris en charge. Cette commande nécessite un nom de fichier entièrement qualifié et est principalement destinée à l’administration, l’investigation et les tests. Elle n’est pas obligatoire dans une configuration normale de pgBackRest.

Si le dépôt est chiffré, repo-get déchiffrera automatiquement le fichier. Les fichiers ne sont pas automatiquement décompressés, mais la sortie peut être redirigée vers la commande de décompression appropriée, par exemple gzip -d.

Commande Liste des dépôts (repo-ls)

Mon, 01 Jan 0001 00:00:00 +0000

Similaire à la commande unix ls mais fonctionne sur tout type de dépôt pris en charge. Cette commande accepte un chemin, absolu ou relatif par rapport au chemin du dépôt défini par l’option --repo-path, et est principalement destinée à l’administration, l’investigation et les tests. Elle n’est pas obligatoire dans une configuration pgBackRest normale.

La sortie texte par défaut affiche un nom de fichier par ligne. La sortie JSON est disponible en spécifiant --output=json.

Documentation et communauté

Mon, 01 Jan 0001 00:00:00 +0000

1. Documentation disponible

La documentation complète de HAProxy est contenue dans les documents suivants. Veuillez vous assurer de consulter la documentation pertinente afin d’économiser du temps et d’obtenir la réponse la plus précise à vos besoins. Veuillez également vous abstenir d’envoyer des questions à la liste de diffusion dont les réponses sont déjà disponibles dans ces documents.

Licence et crédits

Mon, 01 Jan 0001 00:00:00 +0000

pgBadger est un logiciel libre et open source distribué sous la licence PostgreSQL. Il peut être utilisé, copié, modifié et redistribué sans frais, sous réserve du maintien des mentions de copyright et de licence.

Licence PostgreSQL

Permission to use, copy, modify, and distribute this software and its documentation for any purpose, without fee, and without a written agreement is hereby granted, provided that the above copyright notice and this paragraph and the following two paragraphs appear in all copies.

Commande de restauration (restore)

Mon, 01 Jan 0001 00:00:00 +0000

La commande de restauration sélectionne automatiquement la dernière sauvegarde du premier dépôt où des sauvegardes existent (voir Démarrage rapide - Restaurer une sauvegarde ). L’ordre dans lequel les dépôts sont vérifiés est déterminé par le pgbackrest.conf (par exemple, repo1 sera vérifié avant repo2). Pour sélectionner un dépôt spécifique, l’option --repo peut être utilisée (par exemple, --repo=1). L’option --set peut être utilisée si une sauvegarde autre que la plus récente est souhaitée.

Commande serveur (server)

Mon, 01 Jan 0001 00:00:00 +0000

Le serveur pgBackRest permet d’accéder aux hôtes distants sans utiliser le protocole SSH.

Options de commande

Option d’adresse serveur TLS (`--tls-server-address`)

Adresse du serveur TLS.

Adresse IP sur laquelle le serveur écoute les requêtes clients.

default: localhost
example: --tls-server-address=*

Option Clients autorisés du serveur TLS (`--tls-server-auth`)

Clients autorisés du serveur TLS.

2. Configuration de HAProxy

Mon, 01 Jan 0001 00:00:00 +0000

2.1. Format du fichier de configuration

Le processus de configuration d’HAProxy repose sur 3 sources majeures de paramètres :

les arguments en ligne de commande, qui ont toujours la priorité
le(s) fichier(s) de configuration, dont le format est décrit ici
l’environnement du processus en cours d’exécution, en cas de référence explicite à certaines variables d’environnement

Le fichier de configuration suit un format hiérarchique assez simple qui obéit à quelques règles fondamentales :

Commande de ping serveur (server-ping)

Mon, 01 Jan 0001 00:00:00 +0000

Pongez un serveur TLS pgBackRest pour vérifier qu’il accepte les connexions. Cette opération ne sert qu’à vérifier la disponibilité, car aucune authentification n’est tentée.

Si aucun hôte n’est spécifié en ligne de commande, l’option tls-server-host sera utilisée.

Options de commande

Option d’adresse serveur TLS (`--tls-server-address`)

Adresse du serveur TLS.

Adresse IP sur laquelle le serveur écoute les requêtes clients.

default: localhost
example: --tls-server-address=*

Option de port serveur TLS (`--tls-server-port`)

Port du serveur TLS.

3. Section globale

Mon, 01 Jan 0001 00:00:00 +0000

Les paramètres de la section « global » sont applicables à l’ensemble du processus et souvent spécifiques au système d’exploitation. Ils sont généralement définis une fois pour toutes et n’exigent pas de modification une fois correctement configurés. Certains d’entre eux ont des équivalents en ligne de commande.

Les mots-clés suivants sont pris en charge dans la section « global » :

Gestion des processus et sécurité

Commande de création de stanza (stanza-create)

Mon, 01 Jan 0001 00:00:00 +0000

La commande stanza-create doit être exécutée après la configuration du stanza dans pgbackrest.conf. Si plusieurs dépôts sont configurés, le stanza sera créé sur chacun d’eux. Les stanzas déjà créés seront ignorés, ce qui rend toujours sûr l’exécution de stanza-create, même après la configuration d’un nouveau dépôt.

Consultez Créer une stanza pour plus d’informations et un exemple.

Options de commande

Option en ligne (`--online`)

Créez sur un cluster en ligne.

4. Proxies

Mon, 01 Jan 0001 00:00:00 +0000

La configuration du proxy peut être située dans un ensemble de sections :

defaults [<name>] [ depuis <defaults_name> ]
frontal <name> [ depuis <defaults_name> ]
backend <name> [ depuis <defaults_name> ]
écouter <name> [ depuis <defaults_name> ]

Une section « frontend » décrit un ensemble de sockets d’écoute acceptant les connexions clientes.

Une section « backend » décrit un ensemble de serveurs auxquels le proxy se connectera pour acheminer les connexions entrantes.

Commande de suppression de stanza (stanza-delete)

Mon, 01 Jan 0001 00:00:00 +0000

La commande stanza-delete supprime les données du dépôt associées à un stanza.

AVERTISSEMENT :

Utilisez cette commande avec précaution — elle supprimera définitivement toutes les sauvegardes et archives du dépôt pgBackRest pour le stanza spécifié.

Pour supprimer une stanza :

Arrêtez le cluster PostgreSQL associé à la stanza (ou utilisez –force pour l’ignorer).
Exécutez la commande stop sur l’hôte où la commande stanza-delete sera exécutée.
Exécutez la commande stanza-delete.

Une fois la commande exécutée avec succès, il incombe à l’utilisateur de supprimer la stanza de tous les fichiers de configuration pgBackRest et/ou des variables d’environnement.

5. Options de liaison et de serveur

Mon, 01 Jan 0001 00:00:00 +0000

Les mots-clés « bind », « server » et « default-server » prennent en charge un certain nombre de paramètres, selon certains options de compilation et le système sur lequel HAProxy a été compilé. Ces paramètres sont généralement composés d’un mot, parfois suivi d’une valeur, écrits sur la même ligne que la directive « bind » ou « server ». Tous ces paramètres sont décrits dans cette section.

Commande de mise à jour de stanza (stanza-upgrade)

Mon, 01 Jan 0001 00:00:00 +0000

Immédiatement après la mise à niveau de PostgreSQL vers une nouvelle version majeure, le pg-path de toutes les configurations pgBackRest doit être défini sur le nouveau emplacement de la base de données, puis la commande stanza-upgrade doit être exécutée. Si plusieurs dépôts sont configurés sur l’hôte, le stanza sera mis à niveau sur chacun. Si la base de données est hors ligne, utilisez l’option --no-online.

Options de commande

Option en ligne (`--online`)

Mettre à jour un cluster en ligne.

6. Mise en cache

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy fournit un cache, conçu pour effectuer le mise en mémoire tampon de petits objets (favicon, fichiers CSS…). Il s’agit d’un cache minimaliste, à faible maintenance, qui s’exécute en mémoire RAM.

Le cache repose sur une zone mémoire partagée entre tous les threads, divisée en blocs de 1 ko.

Si un objet n’est plus utilisé, il peut être supprimé afin de stocker un nouvel objet indépendamment de sa date d’expiration. Les objets les plus anciens sont supprimés en premier lorsque l’on tente d’allouer un nouvel objet.

Commande de démarrage (start)

Mon, 01 Jan 0001 00:00:00 +0000

Si les processus pgBackRest ont été précédemment arrêtés à l’aide de la commande stop, ils peuvent être redémarrés à l’aide de la commande start. Notez qu’il ne s’agit pas d’un démarrage immédiat des processus pgBackRest, mais qu’ils sont autorisés à s’exécuter. Voir Démarrage et arrêt pour plus d’informations et d’exemples.

Options générales

Autoriser l’exécution en tant qu’utilisateur root (`--allow-root`)

Permettre à la commande de s’exécuter en tant qu’utilisateur root.

7. Listes de contrôle d'accès et extraction d'échantillon

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy est capable d’extraire des données des flux de requêtes ou de réponses, des informations client ou serveur, des tables, des informations environnementales, etc. L’opération d’extraction de ces données est appelée « récupération d’un échantillon ». Une fois récupérés, ces échantillons peuvent être utilisés à diverses fins, par exemple comme clé dans une table de persistance, mais les usages les plus courants consistent à les comparer à des données constantes prédéfinies appelées modèles.

FAQ

Mon, 01 Jan 0001 00:00:00 +0000

Dans cette section, vous trouverez les réponses aux questions les plus fréquemment posées concernant Patroni. Chaque sous-section s’efforce de se concentrer sur des types de questions différents.

Nous espérons que cela vous aidera à clarifier la majeure partie de vos questions. Si vous avez encore des interrogations ou rencontrez un problème imprévu, veuillez vous référer à chatting et reporting_bugs pour obtenir des instructions sur la manière de demander de l’aide ou de signaler des anomalies.

Commande d'arrêt (stop)

Mon, 01 Jan 0001 00:00:00 +0000

N’autorise aucun nouveau processus pgBackRest à s’exécuter. Par défaut, les processus en cours d’exécution sont autorisés à se terminer correctement. Utilisez l’option --force pour terminer les processus en cours.

Les processus pgBackRest retourneront une erreur s’ils sont exécutés après la fin de la commande d’arrêt. Consultez Démarrage et arrêt pour plus d’informations et d’exemples.

Options de commande

Option obligatoire (`--force`)

Forcer l’arrêt de tous les processus pgBackRest.

Notes de version

Mon, 01 Jan 0001 00:00:00 +0000

Version 4.1.5

Libéré le 2026-08-12

Améliorations de compatibilité

Compatibilité avec PostgreSQL 14.24, 15.19, 16.15, 17.11, 18.6 (Alexander Kukushkin)

Ajoutez le nouveau paramètre GUC output_plugin_libraries, qui restreint les plugins de décodage logique.

Améliorations

Réinitialisations de connexion de l’API REST à DEBUG au lieu de WARNING (Kyle McLaren)

Assurez-vous que les variantes courantes de « client est parti au milieu de l’écriture » sont désactivées sans affecter le traitement des erreurs réelles (non liées à la connexion).

Commande de vérification (verify)

Mon, 01 Jan 0001 00:00:00 +0000

Verify détermine si les sauvegardes et les archives présentes dans un dépôt sont valides.

Options de commande

Option de sortie (`--output`)

Type de sortie.

Les types de sortie suivants sont pris en charge :

none - Aucune vérification de sortie.
text - Informations de vérification de sortie affichées sur stdout.

default: none
example: --output=text

Définir l’option (`--set`)

Sauvegarde configurée pour vérification.

9. Filtres pris en charge

Mon, 01 Jan 0001 00:00:00 +0000

Voici la liste des filtres officiellement pris en charge, accompagnée de la liste des paramètres qu’ils acceptent. En fonction des options de compilation, certains de ces filtres pourraient être indisponibles. La liste des filtres disponibles est indiquée dans HAProxy -vv.

Voir aussi : « filter »

9.1. Trace

filtre trace [nom <name>] [redirection aléatoire] [nombre maximal de redirections <max>] [affichage hexadécimal]

Commande Version (version)

Mon, 01 Jan 0001 00:00:00 +0000

Affiche la version de pgBackRest installée.

Options de commande

Option de sortie (`--output`)

Type de sortie.

Les types de sortie suivants sont pris en charge :

text - Affiche la version installée de pgBackRest sous forme de texte.
num - Affiche la version installée de pgBackRest sous forme d’entier.

default: text
example: --output=num

10. Applications FastCGI

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy est capable d’envoyer des requêtes HTTP vers des applications FastCGI Responder. Cette fonctionnalité a été ajoutée à HAProxy 2.1. Pour cela, les serveurs doivent être configurés pour utiliser le protocole FastCGI (en utilisant le mot-clé « proto fcgi » dans la ligne du serveur) et une application FastCGI doit être configurée et utilisée par le backend gérant ces serveurs (en utilisant le mot-clé « use-fcgi-app » dans la section proxy). Plusieurs applications FastCGI peuvent être définies, mais un seul peut être utilisé à la fois par un backend.

11. Tables de persistance et pairs

Mon, 01 Jan 0001 00:00:00 +0000

Les tables de persistance dans HAProxy sont un mécanisme qui permet d’associer un certain nombre d’informations et de métriques à une clé d’un type donné, pendant une durée déterminée après la dernière mise à jour. Cela peut être vu comme une ligne à plusieurs colonnes dans un tableau, où le numéro de ligne est défini par la valeur de la clé, et chaque colonne représente un critère distinct.

12. Autres sections

Mon, 01 Jan 0001 00:00:00 +0000

Les sections décrites ci-dessous sont moins couramment utilisées et ne prennent généralement en charge qu’un petit nombre de paramètres. Il n’existe aucune relation implicite entre elles. Elles sont toutes initiales à l’aide d’un mot-clé unique. Aucune d’entre elles n’est autorisée avant une section « global ». Le support de certaines d’entre elles peut être conditionné par des options de compilation (par exemple, tout ce qui est lié au SSL).

Portes fonctionnelles

Mon, 01 Jan 0001 00:00:00 +0000

Cette page présente un aperçu des diverses options de fonctionnalité qu’un administrateur peut spécifier sur etcd.

Voir étapes du fonctionnement pour une explication des étapes d’une fonctionnalité.

Aperçu

Les portes fonctionnelles sont un ensemble de paires clé=valeur qui décrivent les fonctionnalités d’etcd. Vous pouvez activer ou désactiver ces fonctionnalités à l’aide du drapeau de ligne de commande --feature-gates sur etcd.

FAQ

Mon, 01 Jan 0001 00:00:00 +0000

etcd, général

Qu’est-ce qu’etcd ?

etcd est un magasin clé-valeur distribué cohérent. Principalement utilisé comme service de coordination indépendant dans les systèmes distribués. Conçu pour stocker de petites quantités de données pouvant tenir entièrement en mémoire.

Comment prononce-t-on etcd ?

etcd se prononce /ˈɛtsiːdiː/ et signifie « répertoire etc distribué ».

Les clients doivent-ils envoyer des requêtes au leader etcd ?

Raft est basé sur un leader ; le leader gère toutes les requêtes clients nécessitant un consensus au sein du cluster. Toutefois, le client n’a pas besoin de savoir quel nœud est le leader. Toute requête nécessitant un consensus envoyée à un suiveur est automatiquement redirigée vers le leader. Les requêtes ne nécessitant pas de consensus (par exemple, les lectures sérialisées) peuvent être traitées par n’importe quel membre du cluster.

Bibliothèques et outils

Mon, 01 Jan 0001 00:00:00 +0000

Notez que les bibliothèques et outils tiers (non hébergés sur https://github.com/etcd-io ) mentionnés ci-dessous ne sont pas testés ni entretenus par l’équipe etcd. Avant de les utiliser, les utilisateurs sont invités à les lire et à les examiner.

Outils

etcdctl - Client en ligne de commande pour etcd
etcd-dump - Utilitaire en ligne de commande pour sauvegarder/restaurer etcd.
etcd-fs - Système de fichiers FUSE pour etcd
etcddir - Synchronisation en temps réel entre etcd et un répertoire local. Fonctionne sous Windows et Linux.
etcd-browser - Éditeur web de magasin clé-valeur pour etcd utilisant AngularJS
etcd-lock - Implémentation d’élection de maître et de verrouillage lecture/écriture distribué utilisant etcd - Prend en charge la version 2
etcd-console - Éditeur web de magasin clé-valeur pour etcd utilisant PHP
etcd-viewer - Éditeur/visualiseur de magasin clé-valeur etcd écrit en Java
etcdtool - Export/Import/Edit répertoire etcd en tant que JSON/YAML/TOML et validation du répertoire à l’aide d’un schéma JSON
etcdloadtest - Client de test de charge en ligne de commande pour etcd 3.0 et versions ultérieures
etcd-tui - Une interface utilisateur moderne en mode terminal (TUI) pour interagir avec votre base de données etcd. Parcourez les clés, affichez les valeurs, filtrez les données et gérez votre cluster etcd directement depuis votre terminal.
etcdfinder - Une interface web moderne et ultra-rapide pour etcd, avec recherche instantanée. Prend en charge à la fois etcd v2 et v3.
lucas - Un visualiseur de paires clé-valeur basé sur web pour les clusters etcd3.0+ de Kubernetes.
etcd-manager - Outil graphique et client moderne, efficace, multiplateforme et gratuit pour etcd 3.x. Disponible pour Windows, Linux et Mac.
etcd-backup-restore - Utilitaire permettant de sauvegarder et de restaurer de manière périodique et incrémentielle etcd.
etcd-druid - Opérateur Kubernetes permettant de déployer des clusters etcd et de gérer les opérations de gestion de jour 2.
etcdadm - Outil en ligne de commande pour gérer un cluster etcd.
etcd-defrag - Outil de défragmentation etcd plus facile à utiliser et plus intelligent.
etcdhelper - Plugin pour la plateforme IntelliJ pour etcd.

Bibliothèques

Les sections ci-dessous listent les bibliothèques clientes etcd par langage.

Métriques

Mon, 01 Jan 0001 00:00:00 +0000

etcd utilise Prometheus pour le reporting des métriques. Ces métriques peuvent être utilisées pour la surveillance en temps réel et le débogage. etcd ne persiste pas ses métriques ; si un membre est redémarré, les métriques seront réinitialisées.

La manière la plus simple de consulter les métriques disponibles consiste à utiliser cURL sur le point de terminaison des métriques /metrics. Le format est décrit dans la documentation Prometheus .

Suivez le document de démarrage rapide de Prometheus pour mettre en place un serveur Prometheus afin de collecter les métriques etcd.

Protocole du service de découverte

Mon, 01 Jan 0001 00:00:00 +0000

Le protocole de service de découverte aide un nouveau membre etcd à découvrir tous les autres membres du cluster pendant la phase d’initialisation, en utilisant une URL de découverte partagée.

Le protocole de service de découverte n’est utilisé que pendant la phase d’amorçage du cluster, et ne peut pas être utilisé pour la reconfiguration en temps réel ou la surveillance du cluster.

Le protocole utilise un nouveau jeton de découverte pour initialiser un unique cluster etcd. Souvenez-vous qu’un jeton de découverte ne peut représenter qu’un seul cluster etcd. Dès que le protocole de découverte associé à ce jeton est lancé, même s’il échoue en cours de route, il ne doit pas être utilisé pour initialiser un autre cluster etcd.

Protocole du service de découverte

Mon, 01 Jan 0001 00:00:00 +0000

Le protocole de service de découverte aide un nouveau membre etcd à découvrir tous les autres membres du cluster pendant la phase d’initialisation, en utilisant un jeton de découverte partagé et une liste d’extrémités.

Conventions de journalisation

Mon, 01 Jan 0001 00:00:00 +0000

etcd utilise la bibliothèque zap pour la journalisation de la sortie de l’application, catégorisée en niveaux. Le niveau d’un message de journalisation est déterminé selon les conventions suivantes :

Les journaux DebugLevel sont généralement volumineux et sont habituellement désactivés en production.
- Exemples :
  - Envoyer un message normal à un pair distant
  - Écrire une entrée de journal sur le disque
InfoLevel est la priorité de journalisation par défaut.
- Exemples :
  - Configuration au démarrage
  - Effectuer un instantané
  - Ajouter un nouveau nœud au cluster
  - Ajouter un nouvel utilisateur au sous-système d’authentification
Les journaux de niveau Warn sont plus importants que ceux de niveau Info, mais ne nécessitent pas de revue humaine individuelle.

Modules Go

Mon, 01 Jan 0001 00:00:00 +0000

Le projet etcd (à partir de la version 3.5) est organisé en plusieurs modules golang hébergés dans un référentiel unique .

Les modules suivants sont disponibles :

go.etcd.io/etcd/api/v3 - contient les définitions d’API (protos et bibliothèques générées à partir de protos) qui définissent le protocole de communication entre les clients et le serveur etcd.
go.etcd.io/etcd/pkg/v3 - ensemble de packages d’utilitaires utilisés par etcd sans être spécifiques à etcd lui-même. Un package doit être placé ici uniquement s’il pourrait éventuellement être déplacé vers son propre dépôt à l’avenir. Évitez d’ajouter ici du code qui a de nombreux dépendances, car celles-ci deviendraient automatiquement des dépendances de la bibliothèque cliente (que nous souhaitons garder légère).

Glossaire

Mon, 01 Jan 0001 00:00:00 +0000

Ce document définit les différents termes utilisés dans la documentation, la ligne de commande et le code source d’etcd.

Alarme

Le serveur etcd déclenche une alarme chaque fois que le cluster nécessite une intervention opérationnelle pour rester fiable.

Authentification

L’authentification gère les autorisations d’accès des utilisateurs aux ressources etcd.

Client

Un client se connecte au cluster etcd pour émettre des requêtes de service, telles que la récupération de paires clé-valeur, l’écriture de données ou la surveillance des mises à jour.

Limites système

Mon, 01 Jan 0001 00:00:00 +0000

Limite de taille de requête

etcd est conçu pour gérer des paires clé-valeur de petite taille, typiques des métadonnées. Les requêtes plus grandes fonctionnent, mais peuvent augmenter la latence des autres requêtes. Par défaut, la taille maximale de toute requête est de 1,5 MiB. Cette limite est configurable via le drapeau --max-request-bytes du serveur etcd.

Limite de taille du stockage

La limite par défaut de taille de stockage est de 2 GiB, configurable à l’aide du drapeau --quota-backend-bytes. Une taille maximale de 8 GiB est recommandée pour les environnements normaux, et etcd émet un avertissement au démarrage si la valeur configurée la dépasse.

etcd features

Mon, 01 Jan 0001 00:00:00 +0000

Ce document présente un aperçu des fonctionnalités d’etcd afin d’aider les utilisateurs à mieux comprendre ces fonctionnalités et le processus de mise hors service associé. Si vous souhaitez en savoir plus sur la manière dont les fonctionnalités sont développées dans etcd, veuillez consulter ces guides de développement .

Les fonctionnalités d’etcd sont classées en trois états : expérimentales, stables et non sécurisées. Vous pouvez obtenir la liste des fonctionnalités en exécutant etcd --help.

Référence de l'API

Mon, 01 Jan 0001 00:00:00 +0000

Cette référence d’API est générée automatiquement à partir des fichiers nommés .proto.

service `Auth` (api/etcdserverpb/rpc.proto)

Méthode	Type de requête	Type de réponse	Description
AuthEnable	AuthEnableRequest	AuthEnableResponse	AuthEnable active l’authentification.
AuthDisable	AuthDisableRequest	AuthDisableResponse	AuthDisable désactive l’authentification.
AuthStatus	AuthStatusRequest	AuthStatusResponse	AuthStatus affiche l’état de l’authentification.
Authenticate	AuthenticateRequest	AuthenticateResponse	Authenticate traite une requête d’authentification.
UserAdd	AuthUserAddRequest	AuthUserAddResponse	UserAdd ajoute un nouvel utilisateur. Le nom d’utilisateur ne peut pas être vide.
UserGet	AuthUserGetRequest	AuthUserGetResponse	UserGet obtient les informations détaillées d’un utilisateur.
UserList	AuthUserListRequest	AuthUserListResponse	UserList obtient la liste de tous les utilisateurs.
UserDelete	AuthUserDeleteRequest	AuthUserDeleteResponse	UserDelete supprime un utilisateur spécifié.
UserChangePassword	AuthUserChangePasswordRequest	AuthUserChangePasswordResponse	UserChangePassword modifie le mot de passe d’un utilisateur spécifié.
UserGrantRole	AuthUserGrantRoleRequest	AuthUserGrantRoleResponse	UserGrant accorde un rôle à un utilisateur spécifié.
UserRevokeRole	AuthUserRevokeRoleRequest	AuthUserRevokeRoleResponse	UserRevokeRole retire un rôle à un utilisateur spécifié.
RoleAdd	AuthRoleAddRequest	AuthRoleAddResponse	RoleAdd ajoute un nouveau rôle. Le nom de rôle ne peut pas être vide.
RoleGet	AuthRoleGetRequest	AuthRoleGetResponse	RoleGet obtient les informations détaillées sur un rôle.
RoleList	AuthRoleListRequest	AuthRoleListResponse	RoleList obtient la liste de tous les rôles.
RoleDelete	AuthRoleDeleteRequest	AuthRoleDeleteResponse	RoleDelete supprime un rôle spécifié.
RoleGrantPermission	AuthRoleGrantPermissionRequest	AuthRoleGrantPermissionResponse	RoleGrantPermission accorde une permission sur une clé ou une plage spécifique à un rôle spécifié.
RoleRevokePermission	AuthRoleRevokePermissionRequest	AuthRoleRevokePermissionResponse	RoleRevokePermission retire une permission sur une clé ou une plage spécifique à un rôle spécifié.

service `Cluster` (api/etcdserverpb/rpc.proto)

Méthode	Type de requête	Type de réponse	Description
MemberAdd	MemberAddRequest	MemberAddResponse	MemberAdd ajoute un membre au cluster.
MemberRemove	MemberRemoveRequest	MemberRemoveResponse	MemberRemove supprime un membre existant du cluster.
MemberUpdate	MemberUpdateRequest	MemberUpdateResponse	MemberUpdate met à jour la configuration du membre.
MemberList	MemberListRequest	MemberListResponse	MemberList liste tous les membres du cluster.
MemberPromote	MemberPromoteRequest	MemberPromoteResponse	MemberPromote promeut un membre de type apprenant Raft (non votant) en membre votant Raft.

service `KV` (api/etcdserverpb/rpc.proto)

Méthode	Type de requête	Type de réponse	Description
Range	RangeRequest	RangeResponse	Range récupère les clés dans la plage depuis le magasin clé-valeur.
Put	PutRequest	PutResponse	Put insère la clé donnée dans le magasin clé-valeur. Une requête Put incrémente la révision du magasin clé-valeur et génère un événement dans l’historique des événements.
DeleteRange	DeleteRangeRequest	DeleteRangeResponse	DeleteRange supprime la plage donnée depuis le magasin clé-valeur. Une requête de suppression incrémente la révision du magasin clé-valeur et génère un événement de suppression dans l’historique des événements pour chaque clé supprimée.
Txn	TxnRequest	TxnResponse	Txn traite plusieurs requêtes dans une seule transaction. Une requête Txn incrémente la révision du magasin clé-valeur et génère des événements avec la même révision pour chaque requête terminée. Il est interdit de modifier la même clé plusieurs fois au sein d’une même transaction.
Compact	CompactionRequest	CompactionResponse	Compact compresse l’historique des événements dans le magasin clé-valeur etcd. Le magasin clé-valeur doit être régulièrement compacté, sinon l’historique des événements continuera de croître indéfiniment.

service `Lease` (api/etcdserverpb/rpc.proto)

Méthode	Type de requête	Type de réponse	Description
LeaseGrant	LeaseGrantRequest	LeaseGrantResponse	LeaseGrant crée un bail qui expire si le serveur ne reçoit pas de demande de maintien de vie dans un délai défini. Toutes les clés associées au bail expireront et seront supprimées si le bail expire. Chaque clé expirée génère un événement de suppression dans l’historique des événements.
LeaseRevoke	LeaseRevokeRequest	LeaseRevokeResponse	LeaseRevoke révoque un bail. Toutes les clés associées au bail expireront et seront supprimées.
LeaseKeepAlive	LeaseKeepAliveRequest	LeaseKeepAliveResponse	LeaseKeepAlive maintient le bail actif en transmettant en continu des demandes de maintien de vie du client vers le serveur et des réponses de maintien de vie du serveur vers le client.
LeaseTimeToLive	LeaseTimeToLiveRequest	LeaseTimeToLiveResponse	LeaseTimeToLive récupère les informations relatives au bail.
LeaseLeases	LeaseLeasesRequest	LeaseLeasesResponse	LeaseLeases liste tous les bails existants.

service `Maintenance` (api/etcdserverpb/rpc.proto)

Méthode	Type de requête	Type de réponse	Description
Alarme	AlarmRequest	AlarmResponse	Alarme active, désactive et interroge les alarmes relatives à l’intégrité du cluster.
Statut	StatusRequest	StatusResponse	Statut obtient l’état du membre.
Défragmentation	DefragmentRequest	DefragmentResponse	Défragmentation défragmente la base de données du membre backend afin de récupérer de l’espace de stockage.
Hachage	HashRequest	HashResponse	Hachage calcule le hachage de l’espace de clés backend entier, y compris les clés, les bails et les autres compartiments dans le stockage. Conçu uniquement à des fins de test ! Ne pas compter sur cette fonctionnalité en production avec des transactions en cours, car l’opération Hachage ne détient pas de verrous MVCC. Utilisez plutôt l’API “HashKV” pour vérifier la cohérence du compartiment “key”.
HachageKV	HashKVRequest	HashKVResponse	HachageKV calcule le hachage de toutes les clés MVCC jusqu’à une révision donnée. Il ne parcourt que le compartiment “key” dans le stockage backend.
Instantané	SnapshotRequest	SnapshotResponse	Instantané envoie un instantané de l’ensemble du backend depuis un membre vers un client via un flux.
Transfert du leader	MoveLeaderRequest	MoveLeaderResponse	Transfert du leader demande au nœud leader actuel de transférer son leadership au destinataire.
Mise à jour vers une version inférieure	DowngradeRequest	DowngradeResponse	Mise à jour vers une version inférieure demande une mise à jour vers une version inférieure, vérifie la faisabilité ou annule la mise à jour vers une version inférieure sur la version du cluster. Prise en charge depuis etcd 3.5.

service `Watch` (api/etcdserverpb/rpc.proto)

Méthode	Type de requête	Type de réponse	Description
Surveillance	WatchRequest	WatchResponse	La surveillance observe les événements survenus ou survenant. Les entrées et sorties sont des flux ; le flux d’entrée sert à créer et annuler des observateurs, tandis que le flux de sortie envoie les événements. Une seule requête RPC de surveillance peut surveiller plusieurs plages de clés, en diffusant les événements de plusieurs surveillance simultanément. L’historique complet des événements peut être surveillé à partir de la dernière révision de compactage.

message `AlarmMember` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
memberID	memberID est l’identifiant du membre associé à l’alarme déclenchée.	uint64
alarm	alarm est le type d’alarme qui a été déclenchée.	AlarmType

message `AlarmRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
action	action est le type de requête d’alarme à émettre. L’action peut être GET pour obtenir les états d’alarme, ACTIVATE pour activer une alarme, ou DEACTIVATE pour désactiver une alarme activée.	AlarmAction
memberID	memberID est l’identifiant du membre associé à l’alarme. Si memberID est 0, la requête d’alarme concerne tous les membres.	uint64
alarm	alarm est le type d’alarme à prendre en compte pour cette requête.	AlarmType

message `AlarmResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader
alarms	alarms est une liste d’alertes associées à la requête d’alerte.	(slice de) AlarmMember

message `AuthDisableRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option

message `AuthDisableResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthEnableRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option

message `AuthEnableResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleAddRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
name	name est le nom du rôle à ajouter au système d’authentification.	string

message `AuthRoleAddResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleDeleteRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
role		chaîne de caractères

message `AuthRoleDeleteResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleGetRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
role		chaîne de caractères

message `AuthRoleGetResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
header		ResponseHeader
perm		(tranche de) authpb.Permission

message `AuthRoleGrantPermissionRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
name	name est le nom du rôle auquel la permission sera accordée.	string
perm	perm est la permission à accorder au rôle.	authpb.Permission

message `AuthRoleGrantPermissionResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleListRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option

message `AuthRoleListResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader
roles		(tranche de) string

message `AuthRoleRevokePermissionRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
role		string
key		bytes
range_end		bytes

message `AuthRoleRevokePermissionResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthStatusRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option

message `AuthStatusResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader
enabled		bool
authRevision	authRevision est la révision actuelle du magasin d’authentification	uint64

message `AuthUserAddRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
name		string
password		string
options		authpb.UserAddOptions
hashedPassword		string

message `AuthUserAddResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserChangePasswordRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
name	name est le nom de l’utilisateur dont le mot de passe est modifié.	string
password	password est le nouveau mot de passe de l’utilisateur. Notez que ce champ sera supprimé au niveau de l’API.	string
hashedPassword	hashedPassword est le nouveau mot de passe de l’utilisateur. Notez que ce champ sera initialisé au niveau de l’API.	string

message `AuthUserChangePasswordResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserDeleteRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
name	name est le nom de l’utilisateur à supprimer.	string

message `AuthUserDeleteResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserGetRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
name		string

message `AuthUserGetResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader
roles		(tranche de) string

message `AuthUserGrantRoleRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
user	user est le nom de l’utilisateur auquel il faut attribuer un rôle donné.	string
role	role est le nom du rôle à attribuer à l’utilisateur.	string

message `AuthUserGrantRoleResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserListRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option

message `AuthUserListResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader
users		(tranche de) string

message `AuthUserRevokeRoleRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
name		string
role		string

message `AuthUserRevokeRoleResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthenticateRequest` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
name		string
password		string

message `AuthenticateResponse` (api/etcdserverpb/rpc.proto)

Champ	Description	Type
(versionpb.etcd_version_msg)		option
header		ResponseHeader
token	le jeton est un jeton autorisé pouvant être utilisé dans les RPC suivants	string

message `CompactionRequest` (api/etcdserverpb/rpc.proto)

CompactionRequest compacte le magasin clé-valeur jusqu’à une révision donnée. Toutes les clés obsolètes dont la révision est inférieure à la révision de compactage seront supprimées.

Référence API : concurrence

Mon, 01 Jan 0001 00:00:00 +0000

Cette référence d’API est générée automatiquement à partir des fichiers nommés .proto.

service `Lock` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Le service de verrouillage expose des fonctionnalités de verrouillage côté client sous forme d’une interface gRPC.

Méthode	Type de requête	Type de réponse	Description
Lock	LockRequest	LockResponse	Lock acquiert un verrou partagé distribué sur un verrou nommé donné. En cas de succès, elle retourne une clé unique qui reste existante tant que le verrou est détenu par l’appelant. Cette clé peut être utilisée conjointement avec des transactions afin de garantir en toute sécurité que les mises à jour sur etcd ne s’effectuent qu’en tenant le verrou. Le verrou est détenu jusqu’à ce que Unlock soit appelé sur la clé ou que le bail associé au propriétaire expire.
Unlock	UnlockRequest	UnlockResponse	Unlock prend une clé retournée par Lock et libère la possession du verrou. Le prochain appelant de Lock en attente du verrou est alors réveillé et obtient la possession du verrou.

message `LockRequest` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Champ	Description	Type
name	name est l’identifiant de la verrouille partagée distribuée à acquérir.	bytes
lease	lease est l’ID du bail qui sera attaché à la possession du verrou. Si le bail expire ou est révoqué et qu’il détient actuellement le verrou, celui-ci est automatiquement libéré. Les appels à Lock avec le même bail seront traités comme une seule acquisition ; verrouiller deux fois avec le même bail est sans effet.	int64

message `LockResponse` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Champ	Description	Type
header		etcdserverpb.ResponseHeader
key	key est une clé qui existera dans etcd pendant toute la durée où l’appelant du verrou détient le verrou. Les utilisateurs ne doivent pas modifier cette clé, sinon le verrou peut présenter un comportement indéfini.	bytes

message `UnlockRequest` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Champ	Description	Type
key	key est la clé d’acquisition du verrou octroyée par Lock.	bytes

message `UnlockResponse` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Champ	Description	Type
header		etcdserverpb.ResponseHeader

service `Election` (server/etcdserver/api/v3election/v3electionpb/v3election.proto)

Le service d’élection expose des fonctionnalités d’élection côté client sous forme d’une interface gRPC.

Options de configuration

Mon, 01 Jan 0001 00:00:00 +0000

Vous pouvez configurer etcd à l’aide des éléments suivants :

Options en ligne de commande
Variables d’environnement : chaque option a une variable d’environnement correspondante dont le nom est identique, mais préfixé par ETCD_ et écrit en majuscules et [en notation snake case][]. Par exemple, --some-flag sera ETCD_SOME_FLAG.
Fichier de configuration

Avertissement

Avertissement : Si vous mélangez des options de configuration, les règles suivantes s’appliquent.

Les indicateurs en ligne de commande ont la priorité sur les variables d’environnement.
Si vous fournissez un fichier de configuration, tous les indicateurs en ligne de commande et les variables d’environnement sont ignorés.

Drapeaux de ligne de commande

Les indicateurs sont présentés ci-dessous selon le format --flag-name DEFAULT_VALUE.

Recommandations matérielles

Mon, 01 Jan 0001 00:00:00 +0000

etcd fonctionne généralement correctement avec des ressources limitées à des fins de développement ou de test ; il est courant de développer avec etcd sur un ordinateur portable ou une machine cloud peu coûteuse. Toutefois, lors de l’exécution de clusters etcd en production, certaines recommandations matérielles sont utiles pour une administration appropriée. Ces suggestions ne sont pas des règles strictes ; elles constituent un bon point de départ pour un déploiement productif robuste. Comme toujours, les déploiements doivent être testés avec des charges simulées avant d’être mis en production.

Plateformes prises en charge

Mon, 01 Jan 0001 00:00:00 +0000

Support tiers

etcd s’exécute sur différentes plates-formes, mais les garanties qu’il fournit dépendent du niveau de prise en charge de la plate-forme :

Niveau 1 : entièrement pris en charge par les mainteneurs [etcd][] ; etcd est garanti pour passer tous les tests, y compris les tests fonctionnels et de robustesse.
Niveau 2 : etcd est garanti pour passer les tests d’intégration et les tests bout en bout, mais pas nécessairement les tests fonctionnels ou de robustesse.
Niveau 3 : etcd est garanti pour être compilé, peut être légèrement testé (ou non), et doit donc être considéré comme instable.

Prise en charge actuelle

Le tableau suivant répertorie les plateformes actuellement prises en charge ainsi que leur niveau de prise en charge correspondant pour etcd :

Benchmarks

Mon, 01 Jan 0001 00:00:00 +0000

Benchmarks

Les benchmarks etcd seront publiés régulièrement et suivis pour chaque version ci-dessous :

Benchmarks d’utilisation mémoire

Il enregistre l’utilisation mémoire attendue dans différents scénarios.

etcd v2.2.0-rc

Benchmark de l'utilisation de la mémoire de stockage

Mon, 01 Jan 0001 00:00:00 +0000

Deux composants du stockage etcd consomment de la mémoire physique. Le processus etcd alloue un index en mémoire afin d’accélérer la recherche des clés. La mémoire tampon de pages, gérée par le système d’exploitation, stocke les données récemment accessibles sur disque pour une réutilisation rapide.

L’index en mémoire stocke toutes les clés dans une structure de données arbre B , accompagnées de pointeurs vers les données sur disque (les valeurs). Chaque clé dans l’arbre B peut contenir plusieurs pointeurs, chacun faisant référence à une version différente de sa valeur. La consommation mémoire théorique de l’index en mémoire peut donc être approximée par la formule :

Benchmark de l'utilisation mémoire de la surveillance

Mon, 01 Jan 0001 00:00:00 +0000

Note

Les fonctionnalités de surveillance sont en développement actif, et leur utilisation mémoire peut évoluer au cours de ce développement. Nous ne prévoyons pas d’augmentation significative au-delà des valeurs indiquées ci-dessous.

Un objectif principal d’etcd est de prendre en charge un très grand nombre d’observateurs effectuant une surveillance massivement étendue. etcd vise à supporter O(10k) clients, O(100K) flux de surveillance (O(10) flux par client) et O(10M) surveillance totale (O(100) surveillance par flux). La mémoire consommée par chaque surveillance individuelle représente la plus grande partie de l’utilisation globale d’etcd, et constitue donc le point focal des optimisations actuelles et futures.

Benchmarking d'etcd v3

Mon, 01 Jan 0001 00:00:00 +0000

Machines physiques

Type de machine GCE n1-highcpu-2

1 disque SSD local dédiqué monté sous /var/lib/etcd
1 disque lent dédié pour le système d’exploitation
1,8 Go de mémoire
2 processeurs
version etcd 2.2.0

etcd cluster

1 membre etcd en mode démonstration v3

Test

Utilisez l’outil de benchmark etcd v3 .

Performances

lecture d’une seule clé

taille de la clé en octets	nombre de clients	QPS de lecture	latence au 90e percentile (ms)
256	1	2716	0,4
256	64	16623	6,1
256	256	16622	21,7

Les performances sont presque identiques à celles obtenues avec un gestionnaire de serveur vide.

Benchmarking etcd v2.2.0-rc-memory

Mon, 01 Jan 0001 00:00:00 +0000

Machine physique

Type de machine GCE n1-standard-2

1 disque SSD local dédié monté sous /var/lib/etcd
1 disque lent dédié pour le système d’exploitation
7,5 Go de mémoire
2 processeurs

etcd

etcd Version: 2.2.0-rc.0+git
Git SHA: 103cb5c
Go Version: go1.5
Go OS/Arch: linux/amd64

Test

Démarrez un cluster etcd composé de 3 membres, chacun utilisant 2 cœurs.

Benchmarking etcd v2.2.0-rc

Mon, 01 Jan 0001 00:00:00 +0000

Machine physique

Type de machine GCE n1-highcpu-2

1 disque SSD local dédié monté sous /var/lib/etcd
1 disque lent dédié pour le système d’exploitation
1,8 Go de mémoire
2 processeurs

etcd cluster

3 membres etcd 2.2.0-rc, chacun exécuté sur une seule machine.

Versions détaillées :

etcd Version: 2.2.0-alpha.1+git
Git SHA: 59a5a7e
Go Version: go1.4.2
Go OS/Arch: linux/amd64

En outre, nous utilisons 3 membres etcd 2.1.0 en phase alpha pour constituer le cluster et obtenir des performances de base. La tête du commit d’etcd est située à c7146bd5 , identique à celle utilisée dans benchmark etcd 2.1 .

Benchmarking d'etcd v2.2.0

Mon, 01 Jan 0001 00:00:00 +0000

Machines physiques

Type de machine GCE n1-highcpu-2

1 disque SSD local dédié monté en répertoire de données etcd
1 disque lent dédié pour le système d’exploitation
1,8 Go de mémoire
2 processeurs

etcd cluster

3 membres etcd 2.2.0, chacun exécuté sur une machine unique.

Versions détaillées :

etcd Version: 2.2.0
Git SHA: e4561dd
Go Version: go1.5
Go OS/Arch: linux/amd64

Test

Initialisez une autre machine, en dehors du cluster etcd, puis exécutez l’outil de benchmark HTTP hey avec un correctif de réutilisation de connexion pour envoyer des requêtes à chaque membre du cluster etcd. Consultez les instructions de benchmark pour obtenir le correctif et les étapes permettant de reproduire nos procédures.

Test de performance d'etcd v2.1.0

Mon, 01 Jan 0001 00:00:00 +0000

Machines physiques

Type de machine GCE n1-highcpu-2

1 disque SSD local dédié monté sous /var/lib/etcd
1 disque lent dédié pour le système d’exploitation
1,8 Go de mémoire
2 processeurs
version etcd 2.1.0 alpha

etcd cluster

3 membres etcd, chacun exécuté sur une machine unique

Test

Initialisez une autre machine et utilisez l’outil de benchmark HTTP hey pour envoyer des requêtes à chaque membre etcd. Consultez le guide de manipulation du benchmark pour des instructions détaillées.

Référence on PIG.CENTER

Notes de version pgBadger 13.x

v13.2 · 2025-12-29

v13.1 · 2025-03-16

Actualités

pgBackRest 2.59.1 publié

Commande d'annotation (annotate)

Options de commande

Option d’annotation de sauvegarde (--annotation)

Paramètres de configuration dynamique

Paramètres de configuration YAML

Global/Universel

Notes de version de pgBadger 12.x

v12.4 · 2023-12-25

v12.3 · 2023-11-27

Commande d’archive (archive-get)

Configuration : pgbouncer.ini

Description

Paramètres génériques

fichier_journal

Notes de version de pgBadger 11.x

v11.8 · 2022-04-08

Commande de poussée d'archive (archive-push)

Paramètres de configuration de l'environnement

Global/Universel

Journalisation

Configuration Patroni

Référence en ligne de commande

Utilisation et options

Notes de version pgBadger 10.x

v10.3 · 2019-02-14

API REST Patroni

Points de terminaison de vérification de santé

Commande de sauvegarde (backup)

Options de commande

Option d’annotation de sauvegarde (--annotation)

Référence des commandes

Introduction

Notes de version de pgBadger 9.x

v9.2 · 2017-07-27

Commande de vérification (check)

Référence de configuration

Introduction

HAProxy 3.4.4 Documentation

Choisissez un manuel

Couverture édition

patronictl

Configuration

Source Versions Téléchargement

PgBouncer 1.25

PgBouncer 1.24

PgBouncer 1.23

PgBouncer 1.22

PgBouncer 1.21

PgBouncer 1.20

PgBouncer 1.19

PgBouncer 1.18

PgBouncer 1.17

PgBouncer 1.16

PgBouncer 1.15

PgBouncer 1.14

PgBouncer 1.13

PgBouncer 1.12

PgBouncer 1.11

PgBouncer 1.10

PgBouncer 1.9

PgBouncer 1.8

PgBouncer 1.7

PgBouncer 1.6

PgBouncer 1.5

PgBouncer 1.4

PgBouncer 1.3

PgBouncer 1.2

PgBouncer 1.1

PgBouncer 1.0

Paquets binaires

Commande d'expiration (expire)

Notes de version

Introduction

Taille et performance

Option d’annotation de sauvegarde (`--annotation`)

Option d’annotation de sauvegarde (`--annotation`)

Afficher l’option d’aide (`--help`)

Option d’adresse serveur TLS (`--tls-server-address`)

Option Clients autorisés du serveur TLS (`--tls-server-auth`)

Option d’adresse serveur TLS (`--tls-server-address`)

Option de port serveur TLS (`--tls-server-port`)

Option en ligne (`--online`)

Option en ligne (`--online`)

Autoriser l’exécution en tant qu’utilisateur root (`--allow-root`)

Option obligatoire (`--force`)

Option de sortie (`--output`)

Définir l’option (`--set`)

Option de sortie (`--output`)