PostgreSQLLa base de données la plus sophistiquée au monde.
Documentation PostgreSQL 15.6 » Administration du serveur » Superviser l'activité de la base de données » Le système de statistiques cumulatives

28.2. Le système de statistiques cumulatives

PostgreSQL's cumulative statistics system supports collection and reporting of information about server activity. Presently, accesses to tables and indexes in both disk-block and individual-row terms are counted. The total number of rows in each table, and information about vacuum and analyze actions for each table are also counted. If enabled, calls to user-defined functions and the total time spent in each one are counted as well.

PostgreSQL est également capable de renvoyer des informations dynamiques en temps réel sur ce qu'il se passe exactement dans le système, comme la commande exacte en cours d'exécution par d'autres processus serveur et les autres connexions qui existent dans le système. Cette fonctionnalité est indépendante du système de statistiques cumulatives.

28.2.1. Configuration de la récupération de statistiques

Comme la récupération de statistiques ajoute un temps supplémentaire à l'exécution de la requête, le système peut être configuré pour récupérer ou non des informations. Ceci est contrôlé par les paramètres de configuration qui sont normalement initialisés dans postgresql.conf (voir Chapitre 20 pour plus de détails sur leur initialisation).

Le paramètre track_activities active la collecte d'informations sur la commande en cours d'exécution pour n'importe quel processus serveur.

Le paramètre track_counts contrôle si les statistiques cumulatives sont récupérées pour les accès aux tables et index.

Le paramètre track_functions active le calcul de statistiques sur l'utilisation des fonctions définies par l'utilisateur.

Le paramètre track_io_timing active la collecte des temps de lecture et d'écriture de blocs.

Le paramètre track_wal_io_timing active la collecte des temps d'écriture des journaux de transactions.

Normalement, ces paramètres sont configurés dans postgresql.conf de façon à ce qu'ils s'appliquent à tous les processus serveur, mais il est possible de les activer/désactiver sur des sessions individuelles en utilisant la commande SET (pour empêcher les utilisateurs ordinaires de cacher leur activité à l'administrateur, seuls les superutilisateurs sont autorisés à modifier ces paramètres avec SET).

Cumulative statistics are collected in shared memory. Every PostgreSQL process collects statistics locally, then updates the shared data at appropriate intervals. When a server, including a physical replica, shuts down cleanly, a permanent copy of the statistics data is stored in the pg_stat subdirectory, so that statistics can be retained across server restarts. In contrast, when starting from an unclean shutdown (e.g., after an immediate shutdown, a server crash, starting from a base backup, and point-in-time recovery), all statistics counters are reset.

Une transaction peut aussi voir des statistiques propres à son activité (qui ne sont pas encore transmises au collecteur) dans les vues pg_stat_xact_all_tables, pg_stat_xact_sys_tables, pg_stat_xact_user_tables et pg_stat_xact_user_functions. Ces informations se mettent à jour en continu pendant l'exécution de la transaction.

28.2.2. Visualiser les statistiques

Plusieurs vues prédéfinies, listées à Tableau 28.1, sont disponibles pour montrer l'état courant du système. Il existe aussi plusieurs autres vues, listées à Tableau 28.2, qui montrent les statistiques accumulées. De manière alternative, il est possible de créer des vues personnalisées qui utilisent les fonctions statistiques sous-jacentes, comme discuté à Section 28.2.24.

When using the cumulative statistics views and functions to monitor collected data, it is important to realize that the information does not update instantaneously. Each individual server process flushes out accumulated statistics to shared memory just before going idle, but not more frequently than once per PGSTAT_MIN_INTERVAL milliseconds (1 second unless altered while building the server); so a query or transaction still in progress does not affect the displayed totals and the displayed information lags behind actual activity. However, current-query information collected by track_activities is always up-to-date.

Un autre point important est que, lorsqu'un processus serveur se voit demander d'afficher une des statistiques accumulées, accessed values are cached until the end of its current transaction in the default configuration. So the statistics will show static information as long as you continue the current transaction. Similarly, information about the current queries of all sessions is collected when any such information is first requested within a transaction, and the same information will be displayed throughout the transaction. This is a feature, not a bug, because it allows you to perform several queries on the statistics and correlate the results without worrying that the numbers are changing underneath you. When analyzing statistics interactively, or with expensive queries, the time delta between accesses to individual statistics can lead to significant skew in the cached statistics. To minimize skew, stats_fetch_consistency can be set to snapshot, at the price of increased memory usage for caching not-needed statistics data. Conversely, if it's known that statistics are only accessed once, caching accessed statistics is unnecessary and can be avoided by setting stats_fetch_consistency to none. You can invoke pg_stat_clear_snapshot() to discard the current transaction's statistics snapshot or cached values (if any). The next use of statistical information will (when in snapshot mode) cause a new snapshot to be built or (when in cache mode) accessed statistics to be cached.

A transaction can also see its own statistics (not yet flushed out to the shared memory statistics) in the views pg_stat_xact_all_tables, pg_stat_xact_sys_tables, pg_stat_xact_user_tables, and pg_stat_xact_user_functions. These numbers do not act as stated above; instead they update continuously throughout the transaction.

Certaines des informations des vues statistiques dynamiques montrées dans Tableau 28.1 sont à accès restreint. Les utilisateurs ordinaires peuvent seulement voir toutes les informations sur leur propres sessions (les sessions appartenant à un rôle dont ils sont membres). Les lignes des autres sessions auront de nombreuses colonnes à NULL. Notez néanmoins que l'existence d'une session et ses propriétés générales, tel que l'utilisateur et la base de données, sont visibles à tous les utilisateurs. Les superutilisateurs et les rôles disposant des droits du rôle interne pg_read_all_stats (voir aussi Section 22.5) peuvent accéder à toutes les informations sur les sessions.

Tableau 28.1. Vues statistiques dynamiques

Nom de la vueDescription
pg_stat_activity Une ligne par processus serveur, montrant les informations liées à l'activité courante du processus, comme l'état et la requête en cours. Voir pg_stat_activity pour plus de détails.
pg_stat_replicationUne ligne par processus d'envoi de WAL, montrant les statistiques sur la réplication vers le serveur standby connecté au processus. Voir pg_stat_replication pour les détails.
pg_stat_wal_receiverSeulement une ligne, affichant des statistiques sur le récepteur WAL à partir du serveur ayant ce récepteur. Voir pg_stat_wal_receiver pour les détails.
pg_stat_recovery_prefetchOnly one row, showing statistics about blocks prefetched during recovery. See pg_stat_recovery_prefetch for details.
pg_stat_subscriptionAu moins une ligne par souscription, affichant des informations sur les processus workers de souscription. Voir pg_stat_subscription pour plus de détails.
pg_stat_sslUne ligne par connexion (régulière et de réplication), montrant des informations sur le chiffrement SSL utilisé pour ces connexions. Voir pg_stat_ssl pour les détails.
pg_stat_gssapiUne ligne par connexion (standard et réplication), montrant des informations sur l'authentification et le chiffrement GSSAPI utilisés sur cette connexion. Voir pg_stat_gssapi pour les détails.
pg_stat_progress_analyzeUne ligne pour chaque connexion (incluant celles des processus autovacuum worker) exécutant un ANALYZE, pour indiquer le progrès actuel. Voir Section 28.4.1.
pg_stat_progress_create_indexUne ligne pour chaque processus serveur exécutant un CREATE INDEX ou un REINDEX, affichant la progression actuelle. Voir Section 28.4.2.
pg_stat_progress_vacuumUne ligne pour chaque processus (incluant les processus autovacuum worker) exécutant un VACUUM, affichant le progrès en cours. Voir Section 28.4.3.
pg_stat_progress_clusterUne ligne pour chaque processus serveur exécutant CLUSTER ou VACUUM FULL, affichant le progrès en cours. Voir Section 28.4.4.
pg_stat_progress_basebackupUne ligne pour chaque processus walsender envoyant une sauvegarde de base, en affichant le progrès actuel. Voir Section 28.4.5.
pg_stat_progress_copyUne ligne pour chaque processus en cours d'exécution de COPY, affichant le progrès actuel. Voir Section 28.4.6.

Tableau 28.2. Vues sur les statistiques récupérées

Nom de la vueDescription
pg_stat_archiverUne seule ligne, montrant les statistiques sur l'activité du processus d'archivage des journaux de transactions. Voir pg_stat_archiver pour les détails.
pg_stat_bgwriterUne seule ligne, montrant les statistiques d'activité du processus d'écriture d'arrière-plan. Voir pg_stat_bgwriter pour plus de détails.
pg_stat_walUne seule ligne, montrant les statistiques d'activité WAL. Voir pg_stat_wal pour plus de détails.
pg_stat_databaseUne ligne par base de données, montrant les statistiques globales des bases. Voir pg_stat_database pour plus de détails.
pg_stat_database_conflicts Une ligne par base de données, montrant les statistiques au niveau de la base concernant les requêtes annulées à cause de conflits avec les serveurs standby en restauration. Voir pg_stat_database_conflicts pour plus de détails.
pg_stat_all_tables Une ligne par table de la base de données courante, montrant les statistiques d'accès de chaque table spécifiquement. Voir pg_stat_all_tables pour plus de détails.
pg_stat_sys_tablesIdentique à pg_stat_all_tables, sauf que seules les tables systèmes sont affichées
pg_stat_user_tablesIdentique à pg_stat_all_tables, sauf que seules les tables utilisateurs sont affichées
pg_stat_xact_all_tablesSimilaire à pg_stat_all_tables, mais décompte les actions prises dans la transaction en cours (qui ne sont pas encore pris en compte dans la vue pg_stat_all_tables et les vues du même type). Les colonnes correspondant au nombre de lignes vivantes et mortes, ainsi que celles pour les actions du VACUUM et de l'ANALYZE ne sont pas présentes dans cette vue
pg_stat_xact_sys_tablesIdentique à pg_stat_xact_all_tables, sauf que seules les tables systèmes sont affichées
pg_stat_xact_user_tablesIdentique à pg_stat_xact_all_tables, sauf que seules les tables utilisateurs sont affichées
pg_stat_all_indexes Une ligne par index de la base de données courante, montrant les statistiques d'accès de chaque index spécifiquement. Voir pg_stat_all_indexes pour plus de détails.
pg_stat_sys_indexesIdentique à pg_stat_all_indexes, sauf que seules les tables systèmes sont affichées
pg_stat_user_indexesIdentique à pg_stat_all_indexes, sauf que seules les tables utilisateurs sont affichées
pg_statio_all_tables Une ligne par table de la base de données courante, montrant les statistiques d'entrées/sorties de chaque table spécifiquement. Voir pg_statio_all_tables pour plus de détails.
pg_statio_sys_tablesIdentique à pg_statio_all_tables, sauf que seules les tables systèmes sont affichées
pg_statio_user_tablesIdentique à pg_statio_all_tables, sauf que seules les tables utilisateur sont affichées
pg_statio_all_indexes Une ligne par index de la base de données courante, montrant les les statistiques d'entrées/sorties de chaque index spécifiquement. Voir pg_statio_all_indexes pour plus de détails.
pg_statio_sys_indexesIdentique à pg_statio_all_indexes, sauf que seuls les index systèmes sont affichés
pg_statio_user_indexesIdentique à pg_statio_all_indexes, sauf que seuls les index utilisateur sont affichés
pg_statio_all_sequences Une ligne par séquence de la base de données courante, montrant les statistiques d'entrées/sorties de chaque séquence spécifiquement. Voir pg_statio_all_sequences pour plus de détails.
pg_statio_sys_sequencesIdentique à pg_statio_all_sequences, sauf que seules les séquences système sont affichées (actuellement, aucune séquence système n'est définie, donc cette vue est toujours vide)
pg_statio_user_sequencesIdentique à pg_statio_all_sequences, sauf que seules les séquences utilisateur sont affichées
pg_stat_user_functions Une ligne par fonction suivie, montrant les statistiques d'exécution de cette fonction. Voir pg_stat_user_functions pour plus de détails.
pg_stat_xact_user_functionsSimilaire à pg_stat_user_functions, mais compte seulement les appels pendant la transaction en cours (qui ne sont pas encore inclus dans pg_stat_user_functions)
pg_stat_slruUne ligne par SLRU, affichant les statistiques des opérations. Voir pg_stat_slru pour les détails.
pg_stat_replication_slotsUne ligne par slot de réplication, affichant les statistiques de l'utilisation du slot de réplication. Voir pg_stat_replication_slots pour les détails.
pg_stat_subscription_statsOne row per subscription, showing statistics about errors. See pg_stat_subscription_stats for details.

Les statistiques par index sont particulièrement utiles pour déterminer les index utilisés et leur efficacité.

Les vues pg_statio_ sont principalement utiles pour déterminer l'efficacité du cache tampon. Quand le nombre de lectures disques réelles est plus petit que le nombre de récupérations valides par le tampon, alors le cache satisfait la plupart des demandes de lecture sans faire appel au noyau. Néanmoins, ces statistiques ne nous donnent pas l'histoire complète : à cause de la façon dont PostgreSQL gère les entrées/sorties disque, les données qui ne sont pas dans le tampon de PostgreSQL pourraient toujours résider dans le tampon d'entrées/sorties du noyau et pourraient, du coup, être toujours récupérées sans nécessiter une lecture physique. Les utilisateurs intéressés pour obtenir des informations plus détaillées sur le comportement des entrées/sorties dans PostgreSQL sont invités à utiliser les vues statistiques de PostgreSQL avec les outils du système d'exploitation permettant une vue de la gestion des entrées/sorties par le noyau.

28.2.3. pg_stat_activity

La vue pg_stat_activity aura une ligne par processus serveur, montrant des informations liées à l'activité courante de ce processus.

Tableau 28.3. Vue pg_stat_activity

Type

Description

datid oid

OID de la base de données auquel ce processus serveur est connecté

datname name

Nom de la base de données auquel ce processus serveur est connecté

pid integer

Identifiant du processus serveur

leader_pid integer

Identifiant du processus du leader pour une requête parallélisée si ce si ce processus est un worker. NULL si ce processus est le leader ou ne participe pas à une requête parallélisée.

usesysid oid

OID de l'utilisateur connecté à ce processus serveur

usename name

Nom de l'utilisateur connecté à ce processus serveur

application_name text

Nom de l'application connectée à ce processus serveur

client_addr inet

Adresse IP du client pour ce processus serveur. Si ce champ est vide, cela indique soit que le client est connecté via un socket Unix sur la machine serveur soit qu'il s'agit d'un processus interne tel qu'autovacuum.

client_hostname text

Nom d'hôte du client connecté, comme reporté par une recherche DNS inverse sur client_addr. Ce champ ne sera rempli que pour les connexions IP, et seulement quand log_hostname est activé.

client_port integer

Numéro de port TCP que le client utilise pour communiquer avec le processus serveur, ou -1 si un socket Unix est utilisé.

backend_start timestamp with time zone

Heure de démarrage du processus. Pour les processus backends, c'est l'heure où le client s'est connecté au serveur.

xact_start timestamp with time zone

Heure de démarrage de la transaction courante du processus, ou NULL si aucune transaction n'est active. Si la requête courante est la première de sa transaction, cette colonne a la même valeur que la colonne query_start.

query_start timestamp with time zone

Heure à laquelle la requête active a été démarrée, ou si state ne vaut pas active, quand la dernière requête a été lancée.

state_change timestamp with time zone

Heure à laquelle l'état (state) a été modifié en dernier

wait_event_type text

Type de l'événement pour lequel le processus est en attente  sinon NULL. Voir Tableau 28.4.

wait_event text

Nom de l'événement d'attente si le processus est en attente, NULL dans le cas contraire. Voir Tableau 28.5 jusqu'à Tableau 28.13.

state text

État général du processus serveur. Les valeurs possibles sont :

  • active : le processus serveur exécute une requête.

  • idle : le processus serveur est en attente d'une commande par le client.

  • idle in transaction : le processus serveur est en transaction, mais n'est pas en train d'exécuter une requête.

  • idle in transaction (aborted) : l'état est similaire à idle in transaction, à la différence qu'une des instructions de la transaction a généré une erreur.

  • fastpath function call : le processus serveur exécute une fonction fast-path.

  • disabled : cet état est affiché si track_activities est désactivé pour ce processus serveur.

backend_xid xid

Identifiant de transaction de haut niveau de ce processus, si disponible.

backend_xmin xid

L'horizon xmin de ce processus.

query_id bigint

L'identifiant de la requête la plus récente du processus. Si state vaut active, alors cette colonne indique l'identifiant de la requête en cours d'exécution. Pour les autres états, cette colonne indique l'identifiant de la dernière requête exécutée par le processus. Les identifiants de requêtes ne sont pas calculés par défaut, ainsi cette colonne peut être nulle sauf si le paramètre compute_query_id est activé ou si un module tiers calculant les identifiants de requêtes est configuré.

query text

Texte de la requête la plus récente pour ce processus serveur. Si state vaut active, alors ce champ affiche la requête en cours d'exécution. Dans tous les autres cas, il affichera la dernière requête à avoir été exécutée. Par défaut, le texte de la requête est tronqué à 1024 octets. Cette valeur peut être modifiée avec le paramètre track_activity_query_size.

backend_type text

Type du processus actuel. Les types possibles sont autovacuum launcher, autovacuum worker, logical replication launcher, logical replication worker, parallel worker, background writer, client backend, checkpointer, archiver, startup, walreceiver, walsender et walwriter. De plus, les background workers enregistrés par les extensions pourraient avoir des types supplémentaires.


Note

Les colonnes wait_event et state sont indépendantes. Si un processus serveur est dans l'état active, il pourrait, ou non, être en attente (waiting) d'un événement. Si l'état est active et si wait_event est différent de NULL, cela signifie qu'une requête est en cours d'exécution, mais que cette exécution est bloquée quelque part dans le système.

Tableau 28.4. Types de Wait Event

Type de Wait EventDescription
Activity Le processus serveur est en attente. Ce type d'événement indique un processus attendant une activité dans sa boucle de traitement principal. wait_event identifie le point d'attente spécifique ; voir Tableau 28.5.
BufferPinLe processus serveur est en attente d'un accès exclusif à un tampon de données. Les attentes de ce type peuvent être prolongées si un autre processus détient un curseur ouvert qui a lu des données du tampon en question. Voir Tableau 28.6.
ClientLe processus serveur est en attente d'activité sur un socket connecté à une application utilisateur. De ce fait, le serveur s'attend à une action indépendante de ses processus internes. wait_event identifie le point d'attente spécifique ; voir Tableau 28.7.
ExtensionLe processus serveur est en attente d'une condition définie par une extension. Voir Tableau 28.8.
IOLe processus serveur est en attente de la fin d'une opération I/O. wait_event identifie le point d'attente spécifique ; voir Tableau 28.9.
IPCLe processus serveur est en attente d'une interaction avec un autre processus serveur. wait_event identifie le point d'attente spécifique ; voir Tableau 28.10.
LockLe processus serveur est un attente d'un verrou lourd. Les verrous lourds, aussi connus sous le nom de verrous du gestionnaire ou simplement verrous, protègent principalement les objets SQL comme les tables. Néanmoins, ils sont aussi utilisés pour assurer l'exclusion mutuelle pour certaines opérations internes comme l'agrandissement d'une relation. wait_event identifie le type de verrou en attente ; voir Tableau 28.11.
LWLockLe processus serveur est en attente d'un verrou léger. La plupart de ces types de verrou protègent une structure de données spécifique en mémoire partagée. wait_event contient un nom identifiant le but de ce verrou léger. (Certains verrous ont des noms spécifiques ; les autres font partie d'un groupe de verrous, chacun ayant le même but.) Voir Tableau 28.12.
TimeoutLe processus serveur est en attente de l'expiration d'un délai. wait_event identifie le point d'attente spécifique ; voir Tableau 28.13.

Tableau 28.5. Wait Events de type Activity

Wait Event ActivityDescription
ArchiverMainEn attente dans la boucle principale du processus archiver.
AutoVacuumMainEn attente dans la boucle principale du processus autovacuum launcher.
BgWriterHibernateEn attente du processus background writer, en hibernation.
BgWriterMainEn attente dans la boucle principale du processus background writer.
CheckpointerMainEn attente dans la boucle principale du processus checkpointer.
LogicalApplyMainEn attente dans la boucle principale du processus logical replication apply.
LogicalLauncherMainEn attente dans la boucle principale du processus logical replication launcher.
RecoveryWalStreamEn attente dans la boucle principale du processus startup pour l'arrivée des WAL durant la réplication en flux.
SysLoggerMainEn attente dans la boucle principale du processus syslogger.
WalReceiverMainEn attente dans la boucle principale du processus WAL receiver.
WalSenderMainEn attente dans la boucle principale du processus WAL sender.
WalWriterMainEn attente dans la boucle principale du processus WAL writer.

Tableau 28.6. Wait Events de type BufferPin

Wait Event BufferPinDescription
BufferPinEn attente de l'acquisition d'un verrou exclusif sur un tampon.

Tableau 28.7. Wait Events de type Client

Wait Event ClientDescription
ClientReadEn attente d'une lecture de données provenant du client.
ClientWriteEn attente d'écriture de données vers le client.
GSSOpenServerEn attente de lecture de données provenant du client lors de l'établissement d'une session GSSAPI.
LibPQWalReceiverConnectEn attente de WAL receiver pour établir une connexion vers un serveur distant.
LibPQWalReceiverReceiveEn attente de WAL receiver pour recevoir des données provenant d'un serveur distant.
SSLOpenServerEn attente de SSL lors d'une tentative de connexion.
WalSenderWaitForWALEn attente de l'envoi des WAL au processus WAL sender.
WalSenderWriteDataEn attente de toute activité pendant le traitement des réponses provenant du WAL receiver dans le processus WAL sender.

Tableau 28.8. Wait Events de type Extension

Wait Event ExtensionDescription
ExtensionEn attente d'une extension.

Tableau 28.9. Wait Events de type IO

Wait Event IODescription
BaseBackupReadEn attente que la sauvegarde de base lise un fichier.
BaseBackupSyncEn attente que les données écrites par une sauvegarde de base atteignent un stockage durable.
BaseBackupWriteEn attente que la sauvegarde de base écrive un fichier.
BufFileReadEn attente d'une lecture d'un fichier en cache.
BufFileWriteEn attente d'une écriture dans un fichier en cache.
BufFileTruncateEn attente de la troncature d'un fichier en cache.
ControlFileReadEn attente d'une lecture à partir du fichier pg_control.
ControlFileSyncEn attente que le fichier pg_control atteigne un stockage stable.
ControlFileSyncUpdateEn attente qu'une mise à jour du fichier pg_control atteigne un stockage stable.
ControlFileWriteEn attente d'une écriture dans le fichier pg_control.
ControlFileWriteUpdateEn attente d'une écriture pour mettre à jour le fichier pg_control.
CopyFileReadEn attente d'une lecture lors d'une opération de copie de fichier.
CopyFileWriteEn attente d'une écriture lors d'une opération de copie de fichier.
DSMFillZeroWriteEn attente du remplissage d'un fichier de mémoire partagée dynamique avec des zéros.
DataFileExtendEn attente de l'agrandissement d'un fichier de données.
DataFileFlushEn attente que le fichier de données atteigne un stockage stable.
DataFileImmediateSyncEn attente d'une synchronisation immédiate d'un fichier de données vers un stockage stable.
DataFilePrefetchEn attente d'une prélecture asynchrone à partir d'un fichier de données.
DataFileReadEn attente d'une lecture à partir d'un fichier de données.
DataFileSyncEn attente de modifications dans un fichier de données pour atteindre un stockage stable.
DataFileTruncateEn attente de la troncature d'un fichier de données.
DataFileWriteEn attente de l'écriture d'un fichier de données.
LockFileAddToDataDirReadEn attente d'une lecture lors de l'ajout d'une ligne dans le fichier de verrouillage du répertoire des données.
LockFileAddToDataDirSyncEn attente que les données atteignent un stockage stable lors de l'ajout d'une ligne dans le fichier de verrouillage du répertoire des données.
LockFileAddToDataDirWriteEn attente d'une écriture lors de l'ajout d'une ligne dans le fichier de verrouillage du répertoire des données.
LockFileCreateReadEn attente d'une lecture lors de la création du fichier de verrouillage du répertoire des données.
LockFileCreateSyncEn attente des données pour atteindre un stockage stable lors de la création du fichier de verrouillage du répertoire des données.
LockFileCreateWriteEn attente d'une écriture lors de la création du fichier de verrouillage du répertoire des données.
LockFileReCheckDataDirReadEn attente d'une lecture lors de la vérification du fichier de verrouillage du répertoire des données.
LogicalRewriteCheckpointSyncEn attente que les correspondances de réécriture logique atteignent un stockage stable lors d'un checkpoint.
LogicalRewriteMappingSyncEn attente que les données de correspondance atteignent un stockage stable lors d'une réécriture logique.
LogicalRewriteMappingWriteEn attente d'une écriture des données de correspondance lors d'une réécriture logique.
LogicalRewriteSyncEn attente que les correspondances de réécriture logique atteignent un stockage stable.
LogicalRewriteTruncateEn attente de la troncature de données de correspondance lors d'une réécriture logique.
LogicalRewriteWriteEn attente d'une écriture des correspondances de réécriture logique.
RelationMapReadEn attente d'une lecture du fichier de carte des relations.
RelationMapSyncEn attente que le fichier de carte des relations atteigne un stockage stable.
RelationMapWriteEn attente d'une écriture dans le fichier de carte des relations.
ReorderBufferReadEn attente d'une lecture lors de la gestion des tampons réordonnés.
ReorderBufferWriteEn attente d'une écriture lors de la gestion des tampons réordonnés.
ReorderLogicalMappingReadEn attente d'une lecture d'une correspondance logique lors de la gestion des tampons réordonnés.
ReplicationSlotReadEn attente d'une lecture d'un fichier de contrôle d'un slot de réplication.
ReplicationSlotRestoreSyncEn attente que le fichier de contrôle du slot de réplication atteigne un stockage stable pour le restaurer en mémoire.
ReplicationSlotSyncEn attente que le fichier de contrôle du slot de réplication atteigne un stockage stable.
ReplicationSlotWriteEn attente de l'écriture d'un fichier de contrôle du slot de réplication.
SLRUFlushSyncEn attente que les données SLRU atteignent un stockage stable lors d'un checkpoint ou d'un arrêt de base.
SLRUReadEn attente d'une lecture d'une page SLRU.
SLRUSyncEn attente que les données SLRU atteignent un stockage stable suivant l'écriture d'une page.
SLRUWriteEn attente d'une écriture d'une page SLRU.
SnapbuildReadEn attente d'une lecture d'une image d'un catalogue historique sérialisé.
SnapbuildSyncEn attente qu'une image d'un catalogue historique sérialisé atteigne un stockage stable.
SnapbuildWriteEn attente d'une écriture d'une image d'un catalogue historique sérialisé.
TimelineHistoryFileSyncEn attente qu'un fichier d'historique des timelines soit reçu via la réplication en flux pour atteindre un stockage stable.
TimelineHistoryFileWriteEn attente de l'écriture d'un fichier d'historique des timelines reçu via la réplication en flux.
TimelineHistoryReadEn attente de la lecture d'un fichier d'historique des timelines.
TimelineHistorySyncEn attente qu'un fichier d'historique des timelines nouvellement créé atteigne un stockage stable.
TimelineHistoryWriteEn attente de l'écriture d'un fichier d'historique des timelines nouvellement créé.
TwophaseFileReadEn attente de la lecture d'un fichier d'état pour le 2PC.
TwophaseFileSyncEn attente que le fichier d'état pour le 2PC atteigne un stockage stable.
TwophaseFileWriteEn attente d'une écriture d'un fichier d'état pour le 2PC.
VersionFileSyncEn attente que le fichier version atteigne un stockage stable lors de la création d'une base.
VersionFileWriteEn attente d'une écriture du fichier version lors de la création d'une base.
WALBootstrapSyncEn attente que le WAL atteigne un stockage stable lors du bootstrapping.
WALBootstrapWriteEn attente d'un écriture d'une page WAL lors du bootstrapping.
WALCopyReadEn attente d'une lecture lors de la création d'un nouveau segment WAL en copiant un WAL existant.
WALCopySyncEn attente d'un nouveau segment WAL copié un WAL existant pour atteindre un stockage stable.
WALCopyWriteEn attente d'une écriture lors de la création d'un nouveau segment WAL en en copiant un existant.
WALInitSyncEn attente que le fichier WAL nouvellement initialisé atteigne un stockage stable.
WALInitWriteEn attente d'une écriture lors de l'initialisation d'un nouveau fichier WAL.
WALReadEn attente d'une lecture à partir d'un fichier WAL.
WALSenderTimelineHistoryReadEn attente d'une lecture à partir d'un fichier d'historique des timelines lors qu'une commande de timeline d'un walsender.
WALSyncEn attente qu'un fichier WAL atteigne un stockage stable.
WALSyncMethodAssignEn attente que les données atteignent un stockage stable lors de l'affectation d'une nouvelle méthode de synchronisation des WAL.
WALWriteEn attente d'une écriture dans un fichier WAL.

Tableau 28.10. Wait Events de type IPC

Wait Event IPCDescription
AppendReadyEn attente que les nœuds enfants d'un nœud Append soit prêt.
ArchiveCleanupCommandWaiting for archive_cleanup_command to complete.
ArchiveCommandWaiting for archive_command to complete.
BackendTerminationEn attente de la fin d'un autre processus.
BackupWaitWalArchiveEn attente que les fichiers WAL requis pour une sauvegarde soient correctement archivés.
BgWorkerShutdownEn attente de l'arrêt du background worker.
BgWorkerStartupEn attente du démarrage du background worker.
BtreePageEn attente que le numéro de page requis pour continuer un parcours parallélisé d'un index B-tree soit disponible.
BufferIOEn attente que les opérations I/O se terminent.
CheckpointDoneEn attente de la fin d'un checkpoint.
CheckpointStartEn attente du démarrage d'un checkpoint.
ExecuteGatherEn attente de l'activité d'un processus fils lors de l'exécution du nœud Gather.
HashBatchAllocateEn attente qu'un participant d'un Parallel Hash alloue une table de hachage.
HashBatchElectEn attente de l'élection d'un participant d'un Parallel Hash pour allouer une table de hachage.
HashBatchLoadEn attente que les autres participants d'un Parallel Hash finissent de charger une table de hachage.
HashBuildAllocateEn attente qu'un participant élu d'un Parallel Hash alloue la table de hachage initiale.
HashBuildElectEn attente de l'élection d'un participant à un Parallel Hash pour allouer la table de hachage.
HashBuildHashInnerEn attente que les autres participants à un Parallel Hash finissent le hachage de la relation interne.
HashBuildHashOuterEn attente que les autres participants à un Parallel Hash finissent le partitionnement de la relation externe.
RegisterSyncRequestAttente lors de l'envoi des demandes de synchronisation au checkpointer car la queue de demandes est remplie.
HashGrowBatchesAllocateEn attente qu'un participant élu à un Parallel Hash alloue plus de batches.
HashGrowBatchesDecideEn attente de l'élection d'un participant à un Parallel Hash pour décider de l'agrandissement futur du batch.
HashGrowBatchesElectEn attente de l'élection d'un participant à un Parallel Hash pour participer à l'allocation d'un plus grand nombre de batches.
HashGrowBatchesFinishEn attente de l'élection d'un participant à un Parallel Hash pour décider de l'agrandissement futur du batch.
HashGrowBatchesRepartitionEn attente que les autres participants d'un Parallel Hash terminent le repartitionement.
HashGrowBucketsAllocateEn attente qu'un participant élu à un Parallel Hash fissent l'allocation d'un plus grand nombre de buckets.
HashGrowBucketsElectEn attente de l'élection d'un participant à un Parallel Hash pour allouer plus de buckets.
HashGrowBucketsReinsertEn attente que les autres participants d'un Parallel Hash finissent d'insérer des lignes dans les nouveaux buckets.
LogicalSyncDataEn attente qu'un serveur distant de réplication logique envoie les données pour la synchronisation initiale de la table.
LogicalSyncStateChangeEn attente qu'un serveur distant de réplication logique change l'état.
MessageQueueInternalEn attente qu'un autre processus soit attaché à une queue de messages partagé.
MessageQueuePutMessageEn attente de l'écriture d'un message de protocole dans une queue de messages partagé.
MessageQueueReceiveEn attente de la réception d'octets à partir d'une queue de messages partagé.
MessageQueueSendEn attente de l'envoi d'octets vers une queue de messages partagé.
ParallelBitmapScanEn attente que le parcours parallélisé de bitmap soit initialisé.
ParallelCreateIndexScanEn attente que les workers parallélisés d'un CREATE INDEX finissent le parcours de la table.
ParallelFinishEn attente que les workers parallélisés finissent le traitement.
ProcArrayGroupUpdateEn attente que le leader du groupe efface l'identifiant de transaction à la fin d'une opération parallélisée.
ProcSignalBarrierEn attente qu'un événement barrier soit traité par tous les processus serveurs.
PromoteEn attente de la promotion du standby.
RecoveryConflictSnapshotEn attente de la résolution du conflit de restauration pour un nettoyage par VACUUM.
RecoveryConflictTablespaceEn attente de la résolution du conflit de restauration suite à la suppression d'un tablespace.
RecoveryEndCommandWaiting for recovery_end_command to complete.
RecoveryPauseEn attente de la remise en route de la restauration.
ReplicationOriginDropEn attente que l'origine de réplication devienne inactive, pour qu'elle puisse être supprimée.
ReplicationSlotDropEn attente que le slot de réplication devienne inactif pour qu'il puisse être supprimé.
RestoreCommandWaiting for restore_command to complete.
SafeSnapshotEn attente de l'obtention d'une image valide pour une transaction READ ONLY DEFERRABLE.
SyncRepEn attente de la confirmation d'un serveur distant pour une réplication synchrone.
WalReceiverExitEn attente que le processus wal receiver quitte.
WalReceiverWaitStartEn attente que le processus de démarrage envoie les données d'initialisation pour la réplication en flux.
XactGroupUpdateEn attente du leader pour la mise à jour du statut de transaction à la fin d'une opération parallélisée.

Tableau 28.11. Wait Events de type Lock

Wait Event LockDescription
advisoryEn attente de l'acquisition d'un verrou informatif.
extendEn attente de l'agrandissement d'une relation.
frozenidEn attente de la mise à jour de pg_database.datfrozenxid et pg_database.datminmxid.
objectEn attente de l'acquisition d'un verrou sur un objet de la base qui n'est pas une relation.
pageEn attente de l'acquisition d'un verrou sur une page d'une relation.
relationEn attente de l'acquisition d'un verrou sur une relation.
spectokenEn attente de l'acquisition d'un verrou d'insertion spéculatif.
transactionidEn attente de la fin d'une transaction.
tupleEn attente de l'acquisition d'un verrou sur une ligne.
userlockEn attente de l'acquisition d'un verrou utilisateur.
virtualxidEn attente de l'acquisition d'un verrou sur un identifiant de transaction virtuel.

Tableau 28.12. Wait Events de type LWLock

Wait Event LWLockDescription
AddinShmemInitEn attente de la gestion d'une allocation d'espace de l'extension dans la mémoire partagée.
AutoFileEn attente de la mise à jour du fichier postgresql.auto.conf.
AutovacuumEn attente de la lecture ou de la mise à jour de l'état courant des workers de l'autovacuum.
AutovacuumScheduleEn attente de l'assurance qu'une table sélectionnée pour l'autovacuum a toujours besoin d'être traité.
BackgroundWorkerEn attente de la lecture ou de la mise à jour de l'état du background worker.
BtreeVacuumEn attente de la lecture ou de la mise à jour des informations liées au vacuum pour un index B-tree.
BufferContentEn attente de l'accès à une page de données en mémoire.
BufferMappingEn attente de l'association d'un bloc de données avec un tampon dans le cache.
CheckpointerCommEn attente de la gestion des demandes de fsync.
CommitTsEn attente de la lecture ou la mise à jour de la dernière valeur pour l'horodatage de la validation d'une transaction.
CommitTsBufferEn attente des I/O sur un tampon SLRU d'horodatage de validation de transaction.
CommitTsSLRUEn attente de l'accès au cache SLRU d'horodatage de validation de transaction.
ControlFileEn attente de la lecture ou de la mise à jour du fichier pg_control ou de la création d'un nouveau fichier WAL.
DynamicSharedMemoryControlEn attente de lecture ou de la mise à jour des informations d'allocation de mémoire partagée dynamique.
LockFastPathEn attente de la lecture ou mise à jour des informations du verrou fast-path d'un processus.
LockManagerEn attente de la lecture ou mise à jour des informations sur les verrous « heavyweight ».
LogicalRepWorkerEn attente de la lecture ou de la mise à jour de l'état des workers de réplication logique.
MultiXactGenEn attente de la lecture ou de la mise à jour de l'état des identifiants partagés de multi-transactions.
MultiXactMemberBufferEn attente des I/O sur un tampon SLRU pour les membres multixact.
MultiXactMemberSLRUEn attente de l'accès au cache SLRU des membres multixact.
MultiXactOffsetBufferEn attente des I/O sur un tampon SLRU des décalages multixact.
MultiXactOffsetSLRUEn attente de l'accès au cache SLRU des décalages multixact.
MultiXactTruncationEn attente de la lecture ou de la troncature des informations multixact.
NotifyBufferEn attente des I/O sur un tampon SLRU pour les messages NOTIFY.
NotifyQueueEn attente de la lecture ou de la mise à jour des messages NOTIFY.
NotifyQueueTailEn attente de la mise à jour de la limite sur le stockage des messages NOTIFY.
NotifySLRUEn attente de l'accçs à un cache SLRU des messages NOTIFY.
OidGenEn attente de l'allocation d'un nouvel OID.
OldSnapshotTimeMapEn attente de la lecture ou de la mise à jour des informations sur le contrôle des images.
ParallelAppendEn attente de la sélection du prochain sous-plan dans l'exécution d'un nœud Parallel Append.
ParallelHashJoinEn attente de la synchronisation des workers lors de l'exécution d'un plan Parallel Hash Join.
ParallelQueryDSAEn attente de l'allocation de la mémoire partagée dynamique pour une requête parallélisée.
PerSessionDSAEn attente de l'allocation de la mémoire partagée dynamique pour une requête parallélisée.
PerSessionRecordTypeEn attente de l'accès aux informations d'une requête parallélisée sur les types composites.
PerSessionRecordTypmodEn attente de l'accès aux informations d'une requête parallélisée sur les modificateurs de type qui identifient les types de record anonymes.
PerXactPredicateListEn attente de l'accès à la liste des verrous de prédicat détenus par la transaction sérialisable actuelle lors d'une requête parallélisée.
PredicateLockManagerEn attente de l'accès aux informations de verrou de prédicat utilisées par les transactions sérialisables.
ProcArrayEn attente de l'accès aux structures de données partagées (typiquement, pour obtenir une image ou pour récupérer l'identifiant de transaction d'une session).
RelationMappingEn attente de la lecture ou de la mise à jour d'un fichier pg_filenode.map (utilisé pour tracer les affectations de numéros de fichiers de certains catalogues systèmes).
RelCacheInitEn attente de la lecture ou de la mise à jour du fichier d'initialisation du cache des relations, pg_internal.init.
ReplicationOriginEn attente de la création, de la suppression ou de l'utilisation d'une origine de réplication.
ReplicationOriginStateEn attente de la lecture ou la mise à jour de la progression d'une origine de réplication.
ReplicationSlotAllocationEn attente de l'allocation ou de la libération d'un slot de réplication.
ReplicationSlotControlEn attente de la lecture ou de la mise à jour d'un état d'un slot de réplication.
ReplicationSlotIOEn attente des I/O sur un slot de réplication.
SerialBufferEn attente des I/O sur un tampon SLRU pour la gestion des conflits des transactions sérialisables.
SerializableFinishedListEn attente de l'accès à la liste des transactions sérialisées terminées.
SerializablePredicateListEn attente de l'accès à la liste des verrous de prédicat détenus par les transactions sérialisées.
PgStatsDSAWaiting for stats dynamic shared memory allocator access
PgStatsHashWaiting for stats shared memory hash table access
PgStatsDataWaiting for shared memory stats data access
SerializableXactHashEn attente de la lecture ou de la mise à jour des informations sur les transactions sérialisables.
SerialSLRUEn attente de l'accès au cache SLRU de gestion des conflits pour les transactions sérialisées.
SharedTidBitmapEn attente de l'accès à une bitmap partagé de TID lors d'un parcours d'index bitmap parallélisé.
SharedTupleStoreEn attente de l'accès à un stockage de ligne partagé lors d'une requête parallélisée.
ShmemIndexEn attente de la recherche ou de l'allocation d'espace en mémoire partagée.
SInvalReadEn attente de la récupération de messages en provenance de la queue d'invalidation des catalogues partagées.
SInvalWriteEn attente de l'ajout d'un message dans la queue d'invalidation des catalogues partagées.
SubtransBufferEn attente des I/O sur un tampon SLRU d'une sous-transaction.
SubtransSLRUEn attente de l'accès à un cache SLRU de sous-transaction.
SyncRepEn attente de la lecture ou de la mise à jour d'informations sur l'état de la réplication synchrone.
SyncScanEn attente de la sélection de l'emplacement de démarrage d'un parcours synchronisé de table.
TablespaceCreateEn attente de la création ou suppression d'un tablespace.
TwoPhaseStateEn attente de la lecture ou de la mise à jour de l'état des transactions préparées.
WALBufMappingEn attente du remplacement d'un bloc dans le cache des WAL.
WALInsertEn attente de l'insertion de données WAL dans un tampon mémoire.
WALWriteEn attente que les tampons WAL soient écrits sur disque.
WrapLimitsVacuumEn attente de la mise à jour des limites sur la consommation des identifiants de transaction et des identifiants multixact.
XactBufferEn attente des I/O sur un tampon SLRU de statut de transaction.
XactSLRUEn attente de l'accès au cache SLRU de statut de transaction.
XactTruncationEn attente de l'exécution de pg_xact_status ou de la mise à jour du plus ancien identifiant de transaction disponible.
XidGenEn attente de l'allocation d'un nouvel identifiant de transaction.

Note

Les extensions peuvent ajouter des types LWLock à la liste affichée dans le Tableau 28.12. Dans certains cas, le nom affecté par une extension ne sera pas disponible dans tous les processus serveurs ; donc un wait event de type LWLock pourrait être rapporté comme simplement une « extension » plutôt que comme le nom affecté par l'extension.

Tableau 28.13. Wait Events de type Timeout

Wait Event TimeoutDescription
BaseBackupThrottleEn attente pendant la sauvegarde de base lors de la limitation de l'activité.
CheckpointWriteDelayEn attente entre les écritures d'un checkpoint.
PgSleepEn attente suite à un appel à pg_sleep ou à une fonction du même type.
RecoveryApplyDelayEn attente de l'application des WAL lors de la restauration à cause du paramétrage d'un délai.
RecoveryRetrieveRetryIntervalEn attente de la restauration quand les données WAL ne sont pas disponibles quelque soit la source (pg_wal, archive ou flux).
VacuumDelayEn attente de la fin d'un délai du VACUUM après dépassement d'un délai.
VacuumTruncateWaiting to acquire an exclusive lock to truncate off any empty pages at the end of a table vacuumed.

Voici un exemple pour voir les wait events :

SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event is NOT NULL;

 pid  | wait_event_type | wait_event
------+-----------------+------------
 2540 | Lock            | relation
 6644 | LWLock          | ProcArray
(2 rows)
    

28.2.4. pg_stat_replication

La vue pg_stat_replication contiendra une ligne par processus d'envoi de WAL, montrant des statistiques sur la réplication avec le serveur standby connecté au processus. Seuls les serveurs standby directement connectés sont listés ; aucune information n'est disponible concernant les serveurs standby en aval.

Tableau 28.14. Vue pg_stat_replication

Type

Description

pid integer

Identifiant du processus d'envoi des WAL

usesysid oid

OID de l'utilisateur connecté à ce processus

usename name

Nom de l'utilisateur connecté à ce processus

application_name text

Nom de l'application qui est connectée à ce processus

client_addr inet

Adresse IP du client connecté à ce processus. Si ce champ est NULL, ceci signifie que le client est connecté via un socket Unix sur la machine serveur.

client_hostname text

Nom de l'hôte du client connecté, comme renvoyé par une recherche DNS inverse sur client_addr. Ce champ sera uniquement non NULL pour les connexions IP, et seulement si log_hostname est activé.

client_port integer

Numéro du port TCP que le client utilise pour la communication avec ce processus, ou -1 si un socket Unix est utilisée.

backend_start timestamp with time zone

Heure à laquelle ce processus a été démarré, exemple, lorsque le client s'est connecté à ce processus expéditeur de WALs.

backend_xmin xid

L'horizon xmin de ce serveur standby renvoyé par hot_standby.

state text

État courant du processus walsender. Les valeurs possibles sont :

  • startup : Le processus walsender est en cours de démarrage.

  • catchup : Le secondaire connecté au processus walsender est en cours de rattrapage du primaire.

  • streaming : Ce processus walsender envoie les modifications au serveur secondaire connecté depuis que ce dernier a rattrapé le primaire.

  • backup : Ce processus walsender est en train d'envoyer une sauvegarde.

  • stopping : Ce processus walsender est en cours d'arrêt.

sent_lsn pg_lsn

La position de la dernière transaction envoyée sur cette connexion

write_lsn pg_lsn

La position de la dernière transaction écrite sur disque par ce serveur standby

flush_lsn pg_lsn

La position de la dernière transaction vidée sur disque par ce serveur standby

replay_lsn pg_lsn

La position de la dernière transaction rejouée dans la base de données par ce serveur standby

write_lag interval

Durée passée entre le vidage local des WAL récents et la réception de notification que ce serveur secondaire les a bien écrites (mais pas encore vidées ou appliquées). Ceci peut être utilisé pour mesurer le délai que le niveau remote_write de synchronous_commit coûterait lors de la validation si ce serveur était configuré comme un serveur secondaire synchrone.

flush_lag interval

Durée passée entre le vidage local des WAL récents et la réception de notification que ce serveur secondaire les a bien écrites et vidées sur disque (mais pas encore appliquées). Ceci peut être utilisé pour mesurer le délai que le niveau on de synchronous_commit coûterait lors de la validation si ce serveur était configuré comme un serveur secondaire synchrone.

replay_lag interval

Durée passée entre le vidage local des WAL récents et la réception de notification que ce serveur secondaire les a bien écrites, vidées sur disque et appliquées. Ceci peut être utilisé pour mesurer le délai que le niveau remote_apply de synchronous_commit coûterait lors de la validation si ce serveur était configuré comme un serveur secondaire synchrone.

sync_priority integer

Priorité de ce serveur standby pour être choisi comme le serveur standby synchrone dans une réplication synchrone basée sur la priorité. Ceci n'a pas d'effet sur une réplication synchrone basée sur un quorum.

sync_state text

État synchrone de ce serveur standby. Les valeurs possibles sont :

  • async : Ce serveur standby est asynchrone.

  • potential : Ce serveur standby est maintenant asynchrone, mais peut potentiellement devenir synchrone si un des synchrones échoue.

  • sync : Ce serveur standby est synchrone.

  • quorum : Ce serveur standby est considéré comme un candidat dans les standbys avec quorum.

reply_time timestamp with time zone

Horodatage d'envoi du dernier message de réponse reçu par le standby


Les délais rapportés dans la vue pg_stat_replication sont des mesures de temps prises pour l'écriture, le vidage sur disque et le rejeu des données récentes des WAL et pour que le serveur d'envoi soit mis au courant. Ces durées représentent le délai de validation qui a été (ou aurait été) introduit par chaque niveau de validation synchrone si le serveur distant était configuré comme un standby synchrone. Pour un standby asynchrone, la colonne replay_lag renvoie une approximation du délai avant que les transactions récentes deviennent visibles aux requêtes. Si le serveur standby a complètement rattrapé le serveur d'envoi et qu'il n'y a plus d'activité en écriture (donc plus de nouveaux enregistrements dans les journaux de transactions), les délais mesurés le plus récemment continueront à être affichés pendant un court instant, puis seront mis à NULL.

Les délais fonctionnent automatiquement pour la réplication physique. Les plugins de décodage logique pourraient émettre des messages de trace. S'ils ne le font pas, le mécanisme de trace affichera simplement une valeur NULL.

Note

Les délais rapportés ne sont pas des prédictions du temps pris par le serveur standby pour rattraper le serveur d'envoi en constatant le taux actuel de rejeu. Un tel système afficherait des temps similaires alors que de nouveaux journaux de transactions seraient générés, mais différeraient lorsque le serveur deviendrait inactif. En particulier, quand le serveur standby a complètement rattrapé le serveur d'envoi, pg_stat_replication affiche le temps pris pour écrire, vider sur disque et rejouer l'emplacement de l'enregistrement le plus récemment rapporté plutôt que zéro comme certains utilisateurs pourraient s'y attendre. Ceci est cohérent avec le but de mesurer les délais de la validation synchrone et de la visibilité des transactions pour les transactions récentes en écriture. Pour réduire la confusion pour les utilisateurs s'attendant à un autre modèle de retard, les colonnes de retard sont réinitialisées à NULL après un court moment sur un système entièrement à jour et complètement inactif. Les systèmes de supervision devraient choisir s'ils souhaitent représenter ces colonnes comme des données manquantes, des données à zéro, ou continuer à afficher la dernière valeur connue.

28.2.5. pg_stat_replication_slots

La vue pg_stat_replication_slots contiendra une ligne par slot de réplication logique, montrant les statistiques de son utilisation.

Tableau 28.15. pg_stat_replication_slots View

Type de la colonne

Description

slot_name text

Un identifiant, unique à l'instance, pour le slot de réplication

spill_txns bigint

Nombre de transactions déversées sur disque une fois que la mémoire utilisée par le décodage logique pour décoder les changements depuis les WAL, a dépassé logical_decoding_work_mem. Le compteur est incrémenté pour à la fois les transactions de plus haut niveau et les sous-transactions.

spill_count bigint

Nombre de fois où des transactions sont déversées sur disque pendant le décodage des changements des WAL pour ce slot. Ce compteur est incrémenté chaque fois qu'une transaction est déversée, et une même transaction peut déverser plusieurs fois.

spill_bytes bigint

Quantité de données de transaction décodées déversées sur disque pendant le décodage des changements des WAL pour ce slot. Ce compteur et ceux liés au déversement sur disque peuvent être utilisés pour mesurer les E/S qui se produisent lors du décodage logique et permettre d'optimiser logical_decoding_work_mem.

stream_txns bigint

Nombre de transactions en cours envoyées au plugin de sortie de décodage logique après que la mémoire utilisée par le décodage logique pour décoder les changements depuis les WAL pour ce slot a dépassé logical_decoding_work_mem. Le flux de réplication ne fonctionne qu'avec les transactions de plus haut niveau (les sous-transactions ne sont pas envoyées indépendemment), ainsi le compteur n'est pas incrémenté pour les sous-transactions.

stream_countbigint

Nombre de fois ou des transactions en cours sont envoyées au plugin de sortie de décodage logique lors du décodage des changements depuis les WAL pour ce slot. Ce compteur est incrémenté chaque fois qu'une transaction est envoyée, et la même transaction peut être envoyée plusieurs fois.

stream_bytesbigint

Quantité de données de transactions décodées pour les transactions en cours envoyées par flux au plugin de sortie de décodage logique pendant que des changements sont décodés pour ce slot depuis les WAL. Ce compteur et les compteurs similaires liés pour ce slot peuvent être utilisés pour optimiser logical_decoding_work_mem.

total_txns bigint

Nombre de transactions décodées envoyées au plugin de sortie de décodage pour ce slot. Cela ne comprend que les transactions de plus haut niveau pour ce slot, et ce compteur n'est pas incrémenté pour les sous-transactions. Notez que cela inclut les transactions qui sont envoyées par flux et/ou déversées sur disque.

total_bytesbigint

Quantité de données de transactions décodées pour envoyer les transactions au plugin de sortie de décodage pendant que les changements sont décodés depuis les WAL pour ce slot. Notez que cela inclut les transactions qui sont envoyées par flux et/ou déversées sur disque.

stats_reset timestamp with time zone

Date où ces statistiques ont été remises à zéro.


28.2.6. pg_stat_wal_receiver

La vue pg_stat_wal_receiver contiendra seulement une ligne, affichant les statistiques du walreceiver du serveur de connexion.

Tableau 28.16. Vue pg_stat_wal_receiver

Type

Description

pid integer

Identifiant du processus de réception des enregistrements de transaction

status text

Statut d'activité du processus walreceiver

receive_start_lsn pg_lsn

Première position dans le journal de transaction utilisée quand walreceiver a été démarré

receive_start_tli integer

Première ligne de temps utilisée quand walreceiver a été démarré

written_lsn pg_lsn

Dernier emplacement dans les journaux de transactions ayant déjà été reçu et écrit sur disque, mais non vidé du cache. Ceci ne doit pas être utilisé pour des vérifications sur l'intégrité des données.

flushed_lsn pg_lsn

Dernier emplacement dans les journaux de transactions ayant déjà été reçu et écrit sur disque, et le cache vidé, la valeur initiale de ce champ étant le premier emplacement utilisé lorsque le processus walreceiver a été démarré.

received_tli integer

Numéro de la ligne de temps de la dernière position des journaux de transactions, déjà reçue et écrite sur disque, la valeur initiale de ce champ étant la ligne de temps de la première position dans les journaux de transactions utilisée lors du démarrage du walreceiver

last_msg_send_time timestamp with time zone

Horodatage d'envoi du dernier message reçu à partir du walsender

last_msg_receipt_time timestamp with time zone

Horodatage de la réception du dernier message à partir du walsender

latest_end_lsn pg_lsn

Dernière position de transaction reportée par le walsender associé

latest_end_time timestamp with time zone

Horodatage de la dernière position de transaction reportée par le walsender associé

slot_name text

Nom du slot de réplication utilisé par ce walreceiver

sender_host text

Hôte de l'instance PostgreSQL auquel ce processus « wal receiver » est connecté. Il peut s'agir d'un nom d'hôte, d'une adresse IP ou d'un chemin d'accès à un répertoire si la connexion se fait via un socket Unix (dans ce dernier cas, il est facile de le distinguer car il s'agira toujours d'un chemin absolu débutant par le caractère (/).)

sender_port integer

Numéro de port de l'instance PostgreSQL auquel wal receiver est connecté.

conninfo text

Chaîne de connexion utilisée par ce wal receiver, les informations sensibles au niveau sécurité sont cachés.


28.2.7. pg_stat_recovery_prefetch

The pg_stat_recovery_prefetch view will contain only one row. The columns wal_distance, block_distance and io_depth show current values, and the other columns show cumulative counters that can be reset with the pg_stat_reset_shared function.

Tableau 28.17. pg_stat_recovery_prefetch View

Column Type

Description

stats_reset timestamp with time zone

Time at which these statistics were last reset

prefetch bigint

Number of blocks prefetched because they were not in the buffer pool

hit bigint

Number of blocks not prefetched because they were already in the buffer pool

skip_init bigint

Number of blocks not prefetched because they would be zero-initialized

skip_new bigint

Number of blocks not prefetched because they didn't exist yet

skip_fpw bigint

Number of blocks not prefetched because a full page image was included in the WAL

skip_rep bigint

Number of blocks not prefetched because they were already recently prefetched

wal_distance int

How many bytes ahead the prefetcher is looking

block_distance int

How many blocks ahead the prefetcher is looking

io_depth int

How many prefetches have been initiated but are not yet known to have completed


28.2.8. pg_stat_subscription

La vue pg_stat_subscription contiendra une ligne par souscription du worker principal (avec le PID NULL si le processus worker n'est pas en cours d'exécution), et des lignes supplémentaires pour les workers gérant la copie initiale de données des tables souscrites.

Tableau 28.18. Vue pg_stat_subscription

Type

Description

subid oid

OID de la souscription

subname name

Nom de la souscription

pid integer

Identifiant du processus worker de la souscription

relid oid

OID de la relation que le processus worker synchronise ; NULL pour le processus worker apply principal

received_lsn pg_lsn

Dernier emplacement de journal de transactions reçu, la valeur initiale de ce champ étant 0

last_msg_send_time timestamp with time zone

Horodatage d'envoi du dernier message reçu à partir du walsender original

last_msg_receipt_time timestamp with time zone

Horodatage de réception du dernier message reçu du walsender original

latest_end_lsn pg_lsn

Dernier emplacement des journaux de transactions rapporté par le walsender original

latest_end_time timestamp with time zone

Horodatage du dernier emplacement de journal de transactions rapporté par le walsender original


28.2.9. pg_stat_subscription_stats

The pg_stat_subscription_stats view will contain one row per subscription.

Tableau 28.19. pg_stat_subscription_stats View

Column Type

Description

subid oid

OID of the subscription

subname name

Name of the subscription

apply_error_count bigint

Number of times an error occurred while applying changes

sync_error_count bigint

Number of times an error occurred during the initial table synchronization

stats_reset timestamp with time zone

Time at which these statistics were last reset


28.2.10. pg_stat_ssl

La vue pg_stat_ssl contiendra une ligne par backend ou processus d'envoi de WAL, montrant des statistiques sur l'usage de SSL dans cette connexion. Elle peut être jointe à pg_stat_activity ou pg_stat_replication sur la colonne pid pour obtenir plus de détails sur la connexion.

Tableau 28.20. Vue pg_stat_ssl

Type

Description

pid integer

ID du processus backend ou du processus d'envoi de WAL

ssl boolean

True si SSL est utilisé dans cette connexion

version text

Version de SSL utilisée, ou NULL si SSL n'est pas utilisé pour cette connexion

cipher text

Nom du chiffrement SSL utilisé, ou NULL si SSL n'est pas utilisé pour cette connexion

bits integer

Nombre de bits dans l'algorithme de chiffrement utilisé, ou NULL si SSL n'est pas utilisé pour cette connexion

client_dn text

Champ Distinguished Name (DN) utilisé par le certificat du client, ou NULL si aucun certificat client n'a été fourni ou si SSL n'est pas utilisé pour cette connexion. Ce champ est tronqué si le champ DN est plus long que NAMEDATALEN (64 caractères dans une compilation standard).

client_serial numeric

Numéro de série du certificat client ou NULL si aucun certificat n'a été fourni ou si le SSL n'est pas utilisé dans cette connexion. La combinaison du numéro de série du certification et de l'émetteur du certificat identifie de façon unique un certificat (sauf si l'émetteur réutilise par erreur les numéros de série).

issuer_dn text

DN de l'émetteur du certificat client ou NULL si aucun certificat client n'a été fourni ou si le SSL n'est pas utilisé dans cette connexion. Ce champ est tronqué comme client_dn.


28.2.11. pg_stat_gssapi

La vue pg_stat_gssapi contient une ligne par processus serveur, affichant des informations sur l'utilisation de GSSAPI pour cette connexion. Elle peut être jointe à pg_stat_activity ou pg_stat_replication sur la colonne pid pour obtenir plus de détails sur la connexion.

Tableau 28.21. Vue pg_stat_gssapi

Type

Description

pid integer

Identifiant du processus serveur

gss_authenticated boolean

True si l'authentification GSSAPI a été utilisée pour cette connexion

principal text

Principal utilisé pour authentifier cette connexion, ou NULL si GSSAPI n'a pas été utilisé pour authentifier cette connexion. Ce champ est tronqué si le principal est plus long que NAMEDATALEN (64 caractères dans une construction standard).

encrypted boolean

True si le chiffrement GSSAPI est utilisé avec cette connexion


28.2.12. pg_stat_archiver

La vue pg_stat_archiver aura toujours une seule ligne contenant les données du processus d'archivage de l'instance.

Tableau 28.22. Vue pg_stat_archiver

Type

Description

archived_count bigint

Nombre de journaux de transactions archivés avec succès

last_archived_wal text

Nom du plus récent journal de transaction archivé avec succès

last_archived_time timestamp with time zone

Horodatage de la plus récente opération d'archivage réussie

failed_count bigint

Nombre d'échecs d'archivage de journaux de transactions

last_failed_wal text

Nom du journal de transactions correspondant au plus récent archivage échoué

last_failed_time timestamp with time zone

Horodatage de la plus récente opération d'archivage échouée

stats_reset timestamp with time zone

Horodatage de la dernière réinitialisation de ces statistiques


Normally, WAL files are archived in order, oldest to newest, but that is not guaranteed, and does not hold under special circumstances like when promoting a standby or after crash recovery. Therefore it is not safe to assume that all files older than last_archived_wal have also been successfully archived.

28.2.13. pg_stat_bgwriter

La vue pg_stat_bgwriter aura toujours une ligne unique, contenant les données globales de l'instance.

Tableau 28.23. Vue pg_stat_bgwriter

Type

Description

checkpoints_timed bigint

Nombre de checkpoints planifiés ayant été effectués

checkpoints_req bigint

Nombre de checkpoints demandés ayant été effectués

checkpoint_write_time double precision

Temps total passé dans la partie des checkpoints où les fichiers sont écrits sur disque, en millisecondes.

checkpoint_sync_time double precision

Temps total passé dans la partie des checkpoints où les fichiers sont synchronisés sur le disque, en millisecondes.

buffers_checkpoint bigint

Nombre de tampons écrits durant des checkpoints

buffers_clean bigint

Nombre de tampons écrits par le processus background writer (processus d'écriture en tâche de fond)

maxwritten_clean bigint

Nombre de fois que le processus background writer a arrêté son parcours de nettoyage pour avoir écrit trop de tampons

buffers_backend bigint

Nombre de tampons écrits directement par un processus serveur

buffers_backend_fsync bigint

Nombre de fois qu'un processus serveur a du exécuter son propre appel à fsync (normalement le processus background writer gère ces appels même quand le processus serveur effectue sa propre écriture)

buffers_alloc bigint

Nombre de tampons alloués

stats_reset timestamp with time zone

Dernière fois que ces statistiques ont été réinitialisées


28.2.14. pg_stat_wal

La vue pg_stat_wal a toujours une ligne, contenant les données sur l'activité des journaux de transaction de l'instance.

Tableau 28.24. pg_stat_wal View

Type de la colonne

Description

wal_records bigint

Nombre total d'enregistrements générés dans les journaux de transaction

wal_fpi bigint

Nombre total d'images de pages complètes générées dans les journaux de transactions

wal_bytes numeric

Quantité totale de journaux de transactions générés en octets.

wal_buffers_full bigint

Nombre de fois où des données de journaux de transactions ont été écrites sur disque parce que le cache des journaux de transactions était rempli

wal_write bigint

Nombre de fois où les tampons de journaux de transactions ont été écrits sur disque via des appels à XLogWrite. Voir Section 30.5 pour plus d'informations sur la fonction interne de journaux de transactions XLogWrite.

wal_sync bigint

Nombre de fois où les fichiers des journaux de transactions ont été synchronisés sur disque via des appels à issue_xlog_fsync (si fsync est à on et wal_sync_method vaut soit fdatasync, fsync soit fsync_writethrough), sinon zéro. Voir Section 30.5 pour plus d'informations sur la fonction interne des journaux de transaction issue_xlog_fsync.

wal_write_time double precision

Temps total dépensé à l'écriture du cache des journaux de transactions sur disque via des appels à XLogWrite, en millisecondes (si track_wal_io_timing est activé, sinon zéro). Cela inclut le temps de synchronisation quand wal_sync_method vaut soit open_datasync soit open_sync.

wal_sync_time double precision

Temps total dépensé à synchroniser les fichiers des journaux de transactions vers le disque via des appels à issue_xlog_fsync, en millisecondes (si track_wal_io_timing est activé, et fsync vaut on, et wal_sync_method vaut soit fdatasync, soit fsync soit fsync_writethrough). Sinon zéro.

stats_reset timestamp with time zone

Date où ces statistiques ont été remises à zéro


28.2.15. pg_stat_database

La vue pg_stat_database ne contiendra qu'une ligne pour chaque base de données dans l'instance, plus une pour les objets partagés, montrant ses statistiques globales.

Tableau 28.25. Vue pg_stat_database

Type

Description

datid oid

OID d'une base de données, ou 0 pour les objets partagés

datname name

Nom de cette base de données, or NULL pour les objets partagés

numbackends integer

Nombre de processus serveur actuellement connectés à cette base de données, ou NULL pour les objets partagés. C'est la seule colonne de cette vue qui renvoie une valeur reflétant l'état actuel ; toutes les autres colonnes renvoient les valeurs accumulées depuis la dernière réinitialisation

xact_commit bigint

Nombre de transactions de cette base de données qui ont été validées

xact_rollback bigint

Nombre de transactions de cette base de données qui ont été annulées

blks_read bigint

Nombre de blocs disques lus dans cette base de données

blks_hit bigint

Nombre de fois que des blocs disques étaient déjà dans le cache tampon, et qu'il n'a donc pas été nécessaire de les lire sur disque (cela n'inclut que les accès dans le cache tampon de PostgreSQL, pas dans le cache de fichiers du système d'exploitation).

tup_returned bigint

Number of live rows fetched by sequential scans and index entries returned by index scans in this database

tup_fetched bigint

Number of live rows fetched by index scans in this database

tup_inserted bigint

Nombre de lignes insérées par des requêtes dans cette base de données

tup_updated bigint

Nombre de lignes mises à jour par des requêtes dans cette base de données

tup_deleted bigint

Nombre de lignes supprimées par des requêtes dans cette base de données

conflicts bigint

Nombre de requêtes annulées à cause de conflits avec la restauration dans cette base de données. (Les conflits n'arrivent que sur des serveurs de standby ; voir pg_stat_database_conflicts pour plus de détails.)

temp_files bigint

Nombre de fichiers temporaires créés par des requêtes dans cette base de données. Tous les fichiers temporaires sont comptabilisés, quel que soit la raison de la création du fichier temporaire (par exemple, un tri ou un hachage) et quel que soit la valeur du paramètre log_temp_files.

temp_bytes bigint

Quantité totale de données écrites dans des fichiers temporaires par des requêtes dans cette base de données. Tous les fichiers temporaires sont comptabilisés, quel que soit la raison de la création de ce fichier temporaire, et de la valeur du paramètre log_temp_files.

deadlocks bigint

Nombre de verrous mortels détectés dans cette base de données

checksum_failures bigint

Nombre d'échecs pour la vérification des sommes de contrôle détectés sur cette base de données (ou sur un objet partagé), ou NULL si les sommes de contrôle ne sont pas activées.

checksum_last_failure timestamp with time zone

Horodatage du dernier échec de vérification de somme de contrôle pour un bloc détecté dans cette base (ou sur un objet partagé), ou NULL si les sommes de contrôle ne sont pas activés.

blk_read_time double precision

Temps passé à lire des blocs de donnée dans des fichiers par des processus serveur dans cette base de données, en millisecondes (si track_io_timing est activé, sinon zéro)

blk_write_time double precision

Temps passé à écrire des blocs de données dans des fichiers par les processus serveur dans cette base de données, en millisecondes (si track_io_timing est activé, sinon zéro)

session_time double precision

Temps passé à écrire par les sessions de cette base de données, en millisecondes (notez que les statistiques sont seulement mises à jour quand l'état d'une session change, ainsi si des sessions ont été inactives longtemps, ce temps d'inactivité ne sera pas inclus)

active_time double precision

Temps passé à exécuter des expressions SQL dans cette base de données, en millisecondes (ceci correspond à l'état actif ainsi qu'à l'appel de fonction fastpath dans pg_stat_activity)

idle_in_transaction_time double precision

Temps passé inactif dans une transaction dans cette base de données, en millisecondes (cela correspond aux états inactif dans une transaction (« idle in transaction ») et inactif dans une transaction (annulé) (« idle in transaction (aborted) ») dans pg_stat_activity)

sessions bigint

Nombre total de sessions établies dans cette base de données

sessions_abandoned bigint

Nombre de sessions dans cette base de données qui ont été terminées parce que la connexion au client a été perdue

sessions_fatal bigint

Nombre de sessions dans cette base de données qui ont été terminées par des erreurs fatales

sessions_killed bigint

Nombre de sessions dans cette base de données qui ont été terminées par l'intervention d'un opérateur

stats_reset timestamp with time zone

Dernière fois que ces statistiques ont été réinitialisées


28.2.16. pg_stat_database_conflicts

Avertissement

Utiliser pg_stat_reset() réinitialise aussi les compteurs que l'autovacuum utilise pour déterminer quand déclencher une opération VACUUM ou une opération ANALYZE. Réinitialiser ces compteurs peut empêcher l'autovacuum de réaliser un travail pourtant nécessaire, ce qui entrainerait comme conséquence une fragmentation des tables ou des statistiques obsolètes sur les données des tables. Un ANALYZE sur la base est recommandé après avoir réinitialisé les statistiques.

La vue pg_stat_database_conflicts contiendra une ligne par base de données, montrant des statistiques au niveau de chaque base de données concernant les requêtes annulées survenant à cause de conflits avec la restauration sur des serveurs standby. Cette vue contiendra seulement des informations sur les serveurs standby, dans la mesure où aucun conflit ne survient sur les serveurs primaires.

Tableau 28.26. Vue pg_stat_database_conflicts

Type

Description

datid oid

OID de la base de données

datname name

Nom de cette base de données

confl_tablespace bigint

Nombre de requêtes dans cette base de données qui ont été annulées suite à la suppression de tablespaces

confl_lock bigint

Nombre de requêtes dans cette base de données qui ont été annulées suite à des délais dépassés sur des verrouillages

confl_snapshot bigint

Nombre de requêtes dans cette base de données qui ont été annulées à cause d'instantanés trop vieux

confl_bufferpin bigint

Nombre de requêtes dans cette base de données qui ont été annulées à cause de tampons verrouillés

confl_deadlock bigint

Nombre de requêtes dans cette base de données qui ont été annulées à cause de deadlocks


28.2.17. pg_stat_all_tables

La vue pg_stat_all_tables contiendra une ligne par table dans la base de données courante (incluant les tables TOAST), montrant les statistiques d'accès pour cette table spécifiquement. Les vues pg_stat_user_tables et pg_stat_sys_tables contiennent les mêmes informations, mais filtrent respectivement les tables utilisateurs et les tables systèmes.

Tableau 28.27. Vue pg_stat_all_tables

Type

Description

relid oid

OID d'une table

schemaname name

Nom du schéma dans lequel se trouve cette table

relname name

Nom de cette table

seq_scan bigint

Nombre de parcours séquentiels initiés sur cette table

seq_tup_read bigint

Nombre de lignes vivantes rapportées par des parcours séquentiels

idx_scan bigint

Nombre de parcours d'index initiés sur cette table

idx_tup_fetch bigint

Nombre de lignes vivantes rapportées par des parcours d'index

n_tup_ins bigint

Nombre de lignes insérées

n_tup_upd bigint

Nombre de lignes mises à jour (y compris les lignes mises à jour par HOT)

n_tup_del bigint

Nombre de lignes supprimées

n_tup_hot_upd bigint

Nombre de lignes mises à jour par HOT (c’est-à-dire sans mises à jour d'index nécessaire)

n_live_tup bigint

Nombre estimé de lignes vivantes

n_dead_tup bigint

Nombre estimé de lignes mortes

n_mod_since_analyze bigint

Nombre estimé de lignes modifiées depuis le dernier ANALYZE sur cette table

n_ins_since_vacuum bigint

Nombre estimé de lignes insérées depuis le dernier VACUUM sur cette table

last_vacuum timestamp with time zone

Dernière fois qu'une opération VACUUM manuelle a été faite sur cette table (sans compter  VACUUM FULL)

last_autovacuum timestamp with time zone

Dernière fois que le démon autovacuum a exécuté une opération VACUUM sur cette table

last_analyze timestamp with time zone

Dernière fois qu'une opération ANALYZE a été lancée manuellement sur cette table

last_autoanalyze timestamp with time zone

Dernière fois que le démon autovacuum a exécuté une opération ANALYZE sur cette table

vacuum_count bigint

Nombre de fois qu'une opération VACUUM manuelle a été lancée sur cette table (sans compter VACUUM FULL)

autovacuum_count bigint

Nombre de fois que le démon autovacuum a exécuté une opération VACUUM manuelle

analyze_count bigint

Nombre de fois qu'une opération ANALYZE manuelle a été lancée sur cette table

autoanalyze_count bigint

Nombre de fois que le démon autovacuum a exécuté une opération ANALYZE sur cette table


28.2.18. pg_stat_all_indexes

La vue pg_stat_all_indexes contiendra une ligne pour chaque index dans la base de données courante, montrant les statistiques d'accès sur cet index spécifiquement. Les vues pg_stat_user_indexes et pg_stat_sys_indexes contiennent la même information, mais sont filtrées pour ne montrer respectivement que les index utilisateurs et les index système.

Tableau 28.28. Vue pg_stat_all_indexes

Type

Description

relid oid

OID de la table pour cet index

indexrelid oid

OID de cet index

schemaname name

Nom du schéma dans lequel se trouve cet index

relname name

Nom de la table pour cet index

indexrelname name

Nom de cet index

idx_scan bigint

Nombre de parcours d'index initiés par cet index

idx_tup_read bigint

Nombre d'entrées d'index retournées par des parcours sur cet index

idx_tup_fetch bigint

Nombre de lignes vivantes de la table rapportées par des simples parcours d'index utilisant cet index


Les index peuvent être utilisés avec un simple parcours d'index, un parcours d'index « bitmap » ou l'optimiseur. Dans un parcours de bitmap, les sorties de plusieurs index peuvent être combinées avec des règles AND ou OR, c'est pourquoi il est difficile d'associer des lectures de lignes individuelles de la table avec des index spécifiques quand un parcours de bitmap est utilisé. Par conséquent, un parcours de bitmap incrémente le(s) valeur(s) de pg_stat_all_indexes. idx_tup_read pour le(s) index qu'il utilise, et incrémente la valeur de pg_stat_all_tables. idx_tup_fetch pour la table, mais il n'affecte pas pg_stat_all_indexes.idx_tup_fetch. L'optimiseur accède également aux index pour vérifier si des constantes fournies sont en dehors des plages de valeurs enregistrées par les statistiques de l'optimiseur car celles-ci peuvent ne pas être à jour.

Note

Les valeurs de idx_tup_read et idx_tup_fetch peuvent être différentes même sans aucune utilisation de parcours de bitmap, car idx_tup_read comptabilise les entrées d'index récupérées de cet index alors que idx_tup_fetch comptabilise le nombre de lignes vivantes rapportées de la table. Le second sera moindre si des lignes mortes ou pas encore validées sont rapportées en utilisant l'index, ou si des lectures de lignes de la table sont évitées grâce à un parcours d'index seul.

28.2.19. pg_statio_all_tables

La vue pg_statio_all_tables contiendra une ligne pour chaque table dans la base de données courante (en incluant les tables TOAST), montrant les statistiques d'entrées/sorties de chaque table spécifiquement. Les vues pg_statio_user_tables et pg_statio_sys_tables contiennent la même information, mais sont filtrées pour ne montrer respectivement que les tables utilisateurs et les tables système.

Tableau 28.29. Vue pg_statio_all_tables

Type

Description

relid oid

OID d'une table

schemaname name

Nom du schéma dans lequel se trouve cette table

relname name

Nom de cette table

heap_blks_read bigint

Nombre de blocs disque lus hors cache pour cette table

heap_blks_hit bigint

Nombre de blocs disque lus dans le cache pour cette table

idx_blks_read bigint

Nombre de blocs disque lus hors cache pour tous les index de cette table

idx_blks_hit bigint

Nombre de tampons lus dans le cache pour tous les index de cette table

toast_blks_read bigint

Nombre de blocs disque lus sur la partie TOAST de cette table (si présente)

toast_blks_hit bigint

Nombre de tampons récupérés sur la partie TOAST de cette table (si présente)

tidx_blks_read bigint

Nombre de blocs disque lus sur les index de la partie TOAST de cette table (si présente)

tidx_blks_hit bigint

Nombre de tampons récupérés sur les index de la partie TOAST de cette table (si présente)


28.2.20. pg_statio_all_indexes

La vue pg_statio_all_indexes contiendra une ligne pour chaque index dans la base de données courante, montrant les statistiques d'entrées/sorties sur chaque index spécifiquement. Les vues pg_statio_user_indexes et pg_statio_sys_indexes contiennent la même information, mais sont filtrées pour ne montrer respectivement que les tables utilisateur et tables système.

Tableau 28.30. Vue pg_statio_all_indexes

Type

Description

relid oid

OID de la table pour cet index

indexrelid oid

OID de cet index

schemaname name

Nom du schéma dans lequel se trouve cet index

relname name

Nom de la table pour cet index

indexrelname name

Nom de cet index

idx_blks_read bigint

Nombre de blocs disque lus pour cet index

idx_blks_hit bigint

Nombre de tampons récupérés sur cet index


28.2.21. pg_statio_all_sequences

La vue pg_statio_all_sequences contiendra une ligne pour chaque séquence dans la base de données courante, montrant les statistiques d'entrées/sorties pour chaque séquence spécifiquement.

Tableau 28.31. Vue pg_statio_all_sequences

Type

Description

relid oid

OID de cette séquence

schemaname name

Nom du schéma dans lequel se trouve cette séquence

relname name

Nom de cette séquence

blks_read bigint

Nombre de blocs disque lus pour cette séquence

blks_hit bigint

Nombre de tampons récupérés pour cette séquence


28.2.22. pg_stat_user_functions

La vue pg_stat_user_functions contiendra une ligne pour chaque fonction suivie, montrant les statistiques d'exécution de cette fonction. Le paramètre track_functions contrôle exactement quelles fonctions sont suivies.

Tableau 28.32. Vue pg_stat_user_functions

Type

Description

funcid oid

OID de cette fonction

schemaname name

Nom du schéma dans lequel se trouve cette fonction

funcname name

Nom de cette fonction

calls bigint

Nombre de fois que cette fonction a été appelée

total_time double precision

Temps total passé dans cette fonction ainsi que dans toutes les autres fonctions appelées par elle, en millisecondes

self_time double precision

Temps total passé dans cette fonction seule, sans inclure les autres fonctions appelées par elle, en millisecondes


28.2.23. pg_stat_slru

PostgreSQL accède à certaines informations stockées sur disque via des caches SLRU (simple least-recently-used). La vue pg_stat_slru contiendra une ligne pour chaque cache SLRU tracé, affichant des statistiques sur l'accès aux pages cachées.

Tableau 28.33. Vue pg_stat_slru

Type

Description

name text

Nom du cache SLRU

blks_zeroed bigint

Nombre de blocs initialisés à zéro

blks_hit bigint

Nombre de fois que les blocs disques ont été trouvés dans le cache SLRU, et donc qu'une lecture disque n'était pas nécessaire (ceci inclut seulement les lectures dans le cache SLRU, pas les lectures dans le cache du système d'exploitation)

blks_read bigint

Nombre de blocs disques lus à partir de ce cache SLRU

blks_written bigint

Nombre de blocs disques écrit dans ce cache SLRU

blks_exists bigint

Nombre de blocs dont l'existence a été vérifiée dans ce cache SLRU

flushes bigint

Nombre de vidages de données modifiées pour ce cache SLRU

truncates bigint

Nombre de troncatures pour ce cache SLRU

stats_reset timestamp with time zone

Horodatage de la dernière réinitialisation de ces statistiques


28.2.24. Fonctions statistiques

Une autre façon de regarder les statistiques peut être mise en place en écrivant des requêtes utilisant les mêmes fonctions d'accès sous- jacentes utilisées par les vues standards montrées au-dessus. Pour des détails comme les noms de fonction, veuillez consulter les définitions de ces vues standards. (Par exemple, dans psql vous pouvez utiliser \d+ pg_stat_activity.) Les fonctions d'accès pour les statistiques par base de données prennent comme argument un OID pour identifier sur quelle base de données travailler. Les fonctions par table et par index utilisent un OID de table ou d'index. Les fonctions pour les statistiques par fonctions utilisent un OID de fonction. Notez que seuls les tables, index et fonctions dans la base de données courante peuvent être vus avec ces fonctions.

Les fonctions supplémentaires liées au système de statistiques cumulatives sont listées dans Tableau 28.34.

Tableau 28.34. Fonctions supplémentaires de statistiques

Fonction

Description

pg_backend_pid () → integer

Identifiant du processus serveur gérant la session courante.

pg_stat_get_xact_blocks_fetched ( oid ) → bigint

Renvoie le nombre de demandes de lecture de bloc pour la table ou l'index dans la transaction en cours. Ce nombre soustrait à pg_stat_get_xact_blocks_hit donne le nombre d'appels à la fonction noyau read() ; le nombre de lectures physiques réelles est généralement plus basse grâce au cache au niveau noyau.

pg_stat_get_xact_blocks_hit ( oid ) → bigint

Renvoie le nombre de demandes de lecture de bloc pour la table ou l'index dans la transaction en cours, trouvé dans le cache (donc ne déclenchant pas les appels à la fonction noyau read()).

pg_stat_get_activity ( integer ) → setof record

Retourne un enregistrement d'informations sur le processus serveur du PID spécifié, ou un enregistrement pour chaque processus serveur actif dans le système si NULL est spécifié. Les champs retournés sont des sous-ensembles de ceux dans la vue pg_stat_activity.

pg_stat_get_snapshot_timestamp () → timestamp with time zone

Returns the timestamp of the current statistics snapshot, or NULL if no statistics snapshot has been taken. A snapshot is taken the first time cumulative statistics are accessed in a transaction if stats_fetch_consistency is set to snapshot

pg_stat_clear_snapshot () → void

Discards the current statistics snapshot or cached information.

pg_stat_reset () → void

Réinitialise à 0 tous les compteurs statistiques pour la base de données actuelle.

Cette fonction est restreinte aux superutilisateurs par défaut, mais d'autres utilisateurs peuvent avoir le droit EXECUTE pour exécuter la fonction.

pg_stat_reset_shared ( text ) → void

Réinitialise à 0 les compteurs statistiques de l'instance, suivant l'argument. L'argument peut valoir bgwriter pour réinitialiser tous les compteurs affichés dans la vue pg_stat_bgwriter, archiver pour réinitialiser tous les compteurs affichés dans la vue pg_stat_archiver, wal to reset all the counters shown in the pg_stat_wal view or recovery_prefetch to reset all the counters shown in the pg_stat_recovery_prefetch view.

Cette fonction est restreinte aux superutilisateurs par défaut, mais d'autres utilisateurs peuvent avoir le droit EXECUTE pour exécuter la fonction.

pg_stat_reset_single_table_counters ( oid ) → void

Réinitialise à 0 les statistiques pour une table ou un index or shared across all databases in the cluster to zero. dans la base de données courante.

Cette fonction est restreinte aux superutilisateurs par défaut, mais d'autres utilisateurs peuvent avoir le droit EXECUTE pour exécuter la fonction.

pg_stat_reset_single_function_counters ( oid ) → void

Réinitialise à 0 les statistiques pour une fonction dans la base de données courante.

Cette fonction est restreinte aux superutilisateurs par défaut, mais d'autres utilisateurs peuvent avoir le droit EXECUTE pour exécuter la fonction.

pg_stat_reset_slru ( text ) → void

Réinitialise à 0 les statistiques à un cache SLRU, ou pour toutes les SLRU de l'instance. Si l'argument est NULL, tous les compteurs affichés dans la vue pg_stat_slru sont réinitialisés pour tous les caches SLRU. L'argument fait partie de CommitTs, MultiXactMember, MultiXactOffset, Notify, Serial, Subtrans ou Xact pour réinitialiser les compteurs pour cette seule entrée. Si l'argument est other (ou tout nom non reconnu), alors les compteurs de tous les autres caches SLRU, comme ceux définis par des extensions, sont réinitialisés.

Cette fonction est restreinte aux superutilisateurs par défaut, mais d'autres utilisateurs peuvent avoir le droit EXECUTE pour exécuter la fonction.

pg_stat_reset_replication_slot ( text ) → void

Remet à zéro les statistiques du slot de réplication définies par l'argument. Si l'argument est NULL, réinitialise les statistiques pour tous les slots de réplication.

Cette fonction est restreinte aux superutilisateurs par défaut, mais d'autres utilisateurs peuvent avoir le droit EXECUTE pour exécuter la fonction.

pg_stat_reset_subscription_stats ( oid ) → void

Resets statistics for a single subscription shown in the pg_stat_subscription_stats view to zero. If the argument is NULL, reset statistics for all subscriptions.

This function is restricted to superusers by default, but other users can be granted EXECUTE to run the function.


pg_stat_get_activity, la fonction sous-jacente de la vue pg_stat_activity, retourne un ensemble d'enregistrements contenant toute l'information disponible sur chaque processus serveur. Parfois il peut être plus pratique de n'obtenir qu'un sous-ensemble de cette information. Dans ces cas-là, un ensemble plus vieux de fonctions d'accès aux statistiques par processus serveur peut être utilisé ; celle-ci sont montrées dans Tableau 28.35. Ces fonctions d'accès utilisent un numéro d'identifiant du processus serveur, qui va de un au nombre de processus serveur actuellement actifs. La fonction pg_stat_get_backend_idset fournit une manière pratique de générer une ligne pour chaque processus serveur actif pour appeler ces fonctions. Par exemple, pour montrer les PID et requêtes en cours de tous les processus serveur :

 SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
        pg_stat_get_backend_activity(s.backendid) AS query
     FROM (SELECT pg_stat_get_backend_idset() AS backendid) AS s;
    

Tableau 28.35. Fonctions statistiques par processus serveur

Fonction

Description

pg_stat_get_backend_idset () → setof integer

Ensemble de numéros de processus serveur actuellement actifs (de 1 jusqu'au nombre de processus serveur actifs)

pg_stat_get_backend_activity ( integer ) → text

Texte de la requête la plus récente de ce processus serveur

pg_stat_get_backend_activity_start ( integer ) → timestamp with time zone

Heure à laquelle la requête la plus récente a été démarrée

pg_stat_get_backend_client_addr ( integer ) → inet

Adresse IP du client connecté à ce processus serveur

pg_stat_get_backend_client_port ( integer ) → integer

Numéro de port TCP que le client utilise pour communiquer

pg_stat_get_backend_dbid ( integer ) → oid

OID de la base de données auquel ce processus serveur est connecté

pg_stat_get_backend_pid ( integer ) → integer

Identifiant du processus serveur

pg_stat_get_backend_start ( integer ) → timestamp with time zone

Heure à laquelle ce processus a été démarré

pg_stat_get_backend_userid ( integer ) → oid

OID de l'utilisateur connecté à ce processus serveur

pg_stat_get_backend_wait_event_type ( integer ) → text

Nom du type d'événement d'attente si le processus est actuellement en attente, NULL sinon. Voir Tableau 28.4 pour les détails.

pg_stat_get_backend_wait_event ( integer ) → text

Nom de l'événement d'attente si le processus est actuellement en attente, NULL sinon. Voir Tableau 28.4 pour les détails.

pg_stat_get_backend_xact_start ( integer ) → timestamp with time zone

Heure à laquelle la transaction courante a été démarrée