pg_stat_activity
pg_stat_replication
pg_stat_replication_slots
pg_stat_wal_receiver
pg_stat_recovery_prefetch
pg_stat_subscription
pg_stat_subscription_stats
pg_stat_ssl
pg_stat_gssapi
pg_stat_archiver
pg_stat_io
pg_stat_bgwriter
pg_stat_checkpointer
pg_stat_wal
pg_stat_database
pg_stat_database_conflicts
pg_stat_all_tables
pg_stat_all_indexes
pg_statio_all_tables
pg_statio_all_indexes
pg_statio_all_sequences
pg_stat_user_functions
pg_stat_slru
Le système de statistiques cumulatives de PostgreSQL récupère et fournit des informations sur l'activité du serveur. Actuellement, l'accès aux tables et index est comptabilisé en terme d'accès aux lignes et aux blocs. Le nombre total de lignes de chaque table et les informations sur les opérations de nettoyage et de calcul de statistiques sont aussi récupérées pour chaque table. Si activé, les appels aux fonctions des utilisateurs et le temps total passé dans chacune sont aussi comptabilisés.
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.
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 19 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.
The parameter track_cost_delay_timing enables monitoring of cost-based vacuum delay.
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, d'écriture, d'extension et de synchronisation des blocs.
Le paramètre track_wal_io_timing active la collecte des temps d'écriture et de synchronisation 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
).
Les statistiques cumulatives sont placées en mémoire partagée. Chaque
processus PostgreSQL récupère les statistiques
localement, puis met à jour les données partagées à des intervalles
adéquats. Quand un serveur, y compris un secondaire physique, s'arrête
proprement, une copie permanente des données statistiques est enregistrée
dans le sous-répertoire pg_stat
, pour que les
statistiques survivent aux redémarrages du serveur. Par contre, en cas de
démarrage après un arrêt sale (autrement dit, après un arrêt immédiat, un
crash du serveur, un démarrage suite à la restauration d'une sauvegarde de
base), tous les compteurs statistiques sont réinitialisés.
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.
Plusieurs vues prédéfinies, listées à Tableau 27.1, sont disponibles pour montrer l'état courant du système. Il existe aussi plusieurs autres vues, listées à Tableau 27.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 27.2.26.
Lors de l'utilisation des vues et fonctions des statistiques cumulatives
pour superviser les données collectées, il est important de savoir que
l'information n'est pas mise à jour instantanément. Chaque processus serveur
individuel vide les statistiques accumulées en mémoire partagée avant d'être
de nouveau en attente, mais cela n'arrive pas plus fréquemment qu'une fois
toutes les PGSTAT_MIN_INTERVAL
millisecondes (1 seconde
sauf si cette constante est modifiée avant la compilation du serveur) ;
donc une requête ou une transaction toujours en cours n'affecte pas les
totaux affichés et l'information est de ce fait en retard par rapport à
l'activité en cours. Néanmoins, l'information de la requête en cours
récupérée par track_activities
est toujours à jour.
Un autre point important est que, lorsqu'un processus serveur se voit
demander d'afficher une des statistiques accumulées, les valeurs accédées
sont mises en cache jusqu'à la fin de la transaction courante dans la
configuration par défaut. Donc les statistiques afficheront une information
statique tout au long de la vue de la transaction. De façon similaire,
l'information sur les requêtes en cours de toutes les sessions est
récupérée quand cette information est demandée pour la première fois à
l'intérieur d'une transaction, et la même information sera affichée tout au
long de la transaction. Ceci est une fonctionnalité, et non pas un bug, car
cela vous permet de réaliser plusieurs requêtes sur les statistiques et de
corréler les résultats sans vous soucier que les nombres changent entre
temps. Lors de l'analyse interactive des statistiques ou avec des requêtes
coûteuses, le delta du temps entre les accès aux statistiques individuelles
peut amener à des valeurs fausses significativement dans les statistiques
en cache. Pour minimiser cela, stats_fetch_consistency
peut être configuré à snapshot
, au prix d'une
utilisation mémoire accrue pour meetre en cache des données statistiques
inutiles. Par contre, s'il est connu que les statistiques ne sont accédées
qu'une seule fois, mettre en cache les statistiques accédées n'est pas
nécessaire et peut être évité en configurant
stats_fetch_consistency
à none
. Vous
pouvez exécuter pg_stat_clear_snapshot()
pour annuler
l'image des statistiques de la transaction en cours ou les valeurs en
cache, si applicable. La prochaine utilisation des informations
statistiques causera (en mode snapshot) la construction d'un nouveau
snapshot ou (en mode cache) la mise en cache des statistiques accédées.
Une transaction peut aussi voir ses propres statistiques (pas encore vidées
dans les statistiques en mémoire partagée) 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 nombres
n'agissent pas comme indiqués ci-dessus ; ils sont au contraire mis à
jour en continue tout au long de la transaction.
Certaines des informations des vues statistiques dynamiques montrées dans
Tableau 27.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
peuvent accéder à toutes les informations sur les sessions.
Tableau 27.1. Vues statistiques dynamiques
Nom de la vue | Description |
---|---|
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_replication |
Une 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_receiver | Seulement 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_prefetch | Seulement une ligne, affichant des statistiques sur la lecture
en avance de blocs lors du rejeu des transactions. Voir
pg_stat_recovery_prefetch pour les
détails.
|
pg_stat_subscription | Au 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_ssl | Une 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_gssapi | Une 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_analyze | Une ligne pour chaque connexion (incluant celles des processus
autovacuum worker) exécutant un
ANALYZE , pour indiquer le progrès actuel.
Voir Section 27.4.1.
|
pg_stat_progress_create_index | Une ligne pour chaque processus serveur exécutant un CREATE
INDEX ou un REINDEX , affichant la
progression actuelle. Voir
Section 27.4.4.
|
pg_stat_progress_vacuum | Une ligne pour chaque processus (incluant les processus
autovacuum worker) exécutant un VACUUM , affichant le
progrès en cours. Voir Section 27.4.5. |
pg_stat_progress_cluster | Une ligne pour chaque processus serveur exécutant
CLUSTER ou VACUUM FULL , affichant
le progrès en cours.
Voir Section 27.4.2.
|
pg_stat_progress_basebackup | Une ligne pour chaque processus walsender envoyant une sauvegarde de base, en affichant le progrès actuel. Voir Section 27.4.6. |
pg_stat_progress_copy | Une ligne pour chaque processus en cours d'exécution de
COPY , affichant le progrès actuel.
Voir Section 27.4.3.
|
Tableau 27.2. Vues sur les statistiques récupérées
Nom de la vue | Description |
---|---|
pg_stat_archiver | Une 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_bgwriter | Une 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_checkpointer | Une seule ligne, affichant les statistiques sur l'activité du
processus checkpointer. Voir
pg_stat_checkpointer pour les détails.
|
pg_stat_database | Une 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_io |
Une ligne pour chaque combinaison de type de processus, contexte et objet
cible contenant des statistiques disques sur l'instance. Voir
pg_stat_io pour plus de détails.
|
pg_stat_replication_slots | Une ligne par slot de réplication, affichant des statistiques sur
l'utilisation des slots de réplication. Voir
pg_stat_replication_slots pour plus de
détails.
|
pg_stat_slru | Une ligne par SLRU, affichant les statistiques des opérations. Voir
pg_stat_slru pour plus de détails.
|
pg_stat_subscription_stats | Une ligne par souscription, affichant des statistiques sur les
erreurs et les conflits.
Voir
pg_stat_subscription_stats pour les détails.
|
pg_stat_wal | Une seule ligne, montrant les statistiques d'activité WAL. Voir
pg_stat_wal 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_tables | Identique à pg_stat_all_tables , sauf que seules les
tables systèmes sont affichées |
pg_stat_user_tables | Identique à pg_stat_all_tables , sauf que seules les
tables utilisateurs sont affichées |
pg_stat_xact_all_tables | Similaire à 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_tables | Identique à pg_stat_xact_all_tables ,
sauf que seules les tables systèmes sont affichées |
pg_stat_xact_user_tables | Identique à 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_indexes | Identique à pg_stat_all_indexes , sauf que seules les
tables systèmes sont affichées |
pg_stat_user_indexes | Identique à pg_stat_all_indexes , sauf que seules
les tables utilisateurs sont affichées |
pg_stat_user_functions |
Une ligne pour chaque fonction tracée, affichant des statistiques
sur l'exécution de cette fonction. Voir
pg_stat_user_functions pour des détails.
|
pg_stat_xact_user_functions | Similaire à pg_stat_user_functions , mais
compte seulement les appels lors de la transaction en cours
(qui ne sont pas encore inclus dans
pg_stat_user_functions ). |
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_tables | Identique à pg_statio_all_tables , sauf que seules
les tables systèmes sont affichées |
pg_statio_user_tables | Identique à 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_indexes | Identique à pg_statio_all_indexes , sauf que seuls
les index systèmes sont affichés |
pg_statio_user_indexes | Identique à 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_sequences | Identique à 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_sequences | Identique à pg_statio_all_sequences , sauf que
seules les séquences utilisateur sont affichées |
Les statistiques par index sont particulièrement utiles pour déterminer les index utilisés et leur efficacité.
L'ensemble de vues pg_stat_io
et
pg_statio_
est utile pour déterminer l'efficacité
du cache disque. Elles peuvent être utilisées pour calculer un ratio
de lecture en cache. Notez que, bien que les statistiques d'entrées/sorties
disques de PostgreSQL capturent la plupart des
fois pour lequel le noyau a été appelé réaliser des entrées/sorties disques,
elles ne différencient pas entre les données qui ont été récupérées du
disque et celles qui résidaient déjà dans le cache disque du noyau. Il est
conseillé aux utilisateurs de combiner les vues statistiques de
PostgreSQL avec des outils systèmes pour avoir
un vision plus complète des performances des entrées/sorties disque de la
base de données.
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 27.3. Vue pg_stat_activity
Type Description |
---|
OID de la base de données auquel ce processus serveur est connecté |
Nom de la base de données auquel ce processus serveur est connecté |
Identifiant du processus serveur |
Identifiant du processus du leader pour une requête parallélisée si ce
si ce processus est un worker, identifiant du processus d'un leader pour
la réplication logique parallélisée si ce processus est un worker
d'application parallélisée de la réplication logique.
|
OID de l'utilisateur connecté à ce processus serveur |
Nom de l'utilisateur connecté à ce processus serveur |
Nom de l'application connectée à ce processus serveur |
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. |
Nom d'hôte du client connecté, comme reporté par une recherche DNS
inverse sur |
Numéro de port TCP que le client utilise pour communiquer
avec le processus serveur,
ou |
Heure de démarrage du processus. Pour les processus backends, c'est l'heure où le client s'est connecté au serveur. |
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
|
Heure à laquelle la requête active a été démarrée, ou
si |
Heure à laquelle l'état ( |
Type de l'événement pour lequel le processus est en attente sinon NULL. Voir Tableau 27.4. |
Nom de l'événement d'attente si le processus est en attente, NULL dans le cas contraire. Voir Tableau 27.5 jusqu'à Tableau 27.13. |
État général du processus serveur. Les valeurs possibles sont :
|
Identifiant de transaction de haut niveau de ce processus, si disponible ; voir Section 67.1. |
L'horizon |
L'identifiant de la requête la plus récente du processus. Si
|
Texte de la requête la plus récente pour ce processus serveur. Si
|
Type du processus actuel. Les types possibles sont
|
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.
To keep the reporting overhead low, the system does not
attempt to synchronize different aspects of activity data for a backend.
As a result, ephemeral discrepancies may exist between the view's columns.
Tableau 27.4. Types de Wait Event
Type de Wait Event | Description |
---|---|
Activity | Le processus serveur est en attente. Ce type d'événement indique un
processus en attente d'activité dans sa boucle principale de traitement.
wait_event identifiera la point d'attente
spécifique ; voir Tableau 27.5.
|
BufferPin | Le processus serveur est en attente de l'accès exclusif à un buffer de données. Les attentes de ce type peuvent être prolongées si un autre processus détient un curseur ouvert qui est le dernier à avoir lu des données à partir du buffer en question. Voir Tableau 27.6. |
Client | Le processus serveur est en attente d'activité sur un socket
connecté à l'application de l'utilisateur. Donc le serveur attend quelque
chose indépendant de ses traitements internes..
wait_event identifiera le point d'attente
spécifique ; voir Tableau 27.7.
|
Extension | Le processus serveur est en attente d'une condition définie par un module d'extension. Voir Tableau 27.8. |
InjectionPoint | Le processus serveur est en attente qu'un point d'injection atteigne une décision définie dans un test. Voir Section 36.10.14 pour plus de détails. Ce type n'a pas de points d'attente prédéfinis. |
IO | Le processus serveur est en attente de la réalisation d'une opération
d'entrée/sortie disque. wait_event identifiera le
point d'attente spécifique ; voir Tableau 27.9.
|
IPC | Le processus serveur est en attente d'interaction avec un autre
processus serveur. wait_event identifiera le point
d'attente spécifique ; voir Tableau 27.10.
|
Lock | Le processus serveur est en attente d'un verrou lourd. Les verrous
lourds, gérés par le gestionnaire de verrous, protège principalement les
objets SQL visibles tels que les tables. Néanmoins, ils sont aussi
utilisés pour assurer des exclusions mutuelles pour certaines opérations
internes, telles que les extensions de relation.
wait_event identifiera le type de verrou attendu ;
voir Tableau 27.11.
|
LWLock | Le processus serveur est en attente d'un verrou léger. La plupart
de ces verrous protègent une structure de données particulière en mémoire
partagée. wait_event contiendra un nom identifiant le
but du verrou léger. (Certains verrous ont des noms spécifiques ;
les autres font partie d'un groupe de verrous, chacune avec un but
similaire.) Voir Tableau 27.12.
|
Timeout | Le processus serveur est en attente de l'expiration d'un délai.
wait_event identifiera le point d'attente
spécifique ; voir Tableau 27.13.
|
Tableau 27.5. Wait Events of Type Activity
Activity Wait Event | Description |
---|---|
ArchiverMain | Waiting in main loop of archiver process. |
AutovacuumMain | Waiting in main loop of autovacuum launcher process. |
BgwriterHibernate | Waiting in background writer process, hibernating. |
BgwriterMain | Waiting in main loop of background writer process. |
CheckpointerMain | Waiting in main loop of checkpointer process. |
CheckpointerShutdown | Waiting for checkpointer process to be terminated. |
IoWorkerMain | Waiting in main loop of IO Worker process. |
LogicalApplyMain | Waiting in main loop of logical replication apply process. |
LogicalLauncherMain | Waiting in main loop of logical replication launcher process. |
LogicalParallelApplyMain | Waiting in main loop of logical replication parallel apply process. |
RecoveryWalStream | Waiting in main loop of startup process for WAL to arrive, during streaming recovery. |
ReplicationSlotsyncMain | Waiting in main loop of slot sync worker. |
ReplicationSlotsyncShutdown | Waiting for slot sync worker to shut down. |
SysloggerMain | Waiting in main loop of syslogger process. |
WalReceiverMain | Waiting in main loop of WAL receiver process. |
WalSenderMain | Waiting in main loop of WAL sender process. |
WalSummarizerWal | Waiting in WAL summarizer for more WAL to be generated. |
WalWriterMain | Waiting in main loop of WAL writer process. |
Tableau 27.6. Wait Events of Type Bufferpin
BufferPin Wait Event | Description |
---|---|
BufferPin | Waiting to acquire an exclusive pin on a buffer. |
Tableau 27.7. Wait Events of Type Client
Client Wait Event | Description |
---|---|
ClientRead | Waiting to read data from the client. |
ClientWrite | Waiting to write data to the client. |
GssOpenServer | Waiting to read data from the client while establishing a GSSAPI session. |
LibpqwalreceiverConnect | Waiting in WAL receiver to establish connection to remote server. |
LibpqwalreceiverReceive | Waiting in WAL receiver to receive data from remote server. |
SslOpenServer | Waiting for SSL while attempting connection. |
WaitForStandbyConfirmation | Waiting for WAL to be received and flushed by the physical standby. |
WalSenderWaitForWal | Waiting for WAL to be flushed in WAL sender process. |
WalSenderWriteData | Waiting for any activity when processing replies from WAL receiver in WAL sender process. |
Tableau 27.8. Wait Events of Type Extension
Extension Wait Event | Description |
---|---|
Extension | Waiting in an extension. |
Tableau 27.9. Wait Events of Type Io
IO Wait Event | Description |
---|---|
AioIoCompletion | Waiting for another process to complete IO. |
AioIoUringExecution | Waiting for IO execution via io_uring. |
AioIoUringSubmit | Waiting for IO submission via io_uring. |
BasebackupRead | Waiting for base backup to read from a file. |
BasebackupSync | Waiting for data written by a base backup to reach durable storage. |
BasebackupWrite | Waiting for base backup to write to a file. |
BuffileRead | Waiting for a read from a buffered file. |
BuffileTruncate | Waiting for a buffered file to be truncated. |
BuffileWrite | Waiting for a write to a buffered file. |
ControlFileRead | Waiting for a read from the pg_control file. |
ControlFileSync | Waiting for the pg_control file to reach durable storage. |
ControlFileSyncUpdate | Waiting for an update to the pg_control file to reach durable storage. |
ControlFileWrite | Waiting for a write to the pg_control file. |
ControlFileWriteUpdate | Waiting for a write to update the pg_control file. |
CopyFileCopy | Waiting for a file copy operation. |
CopyFileRead | Waiting for a read during a file copy operation. |
CopyFileWrite | Waiting for a write during a file copy operation. |
DataFileExtend | Waiting for a relation data file to be extended. |
DataFileFlush | Waiting for a relation data file to reach durable storage. |
DataFileImmediateSync | Waiting for an immediate synchronization of a relation data file to durable storage. |
DataFilePrefetch | Waiting for an asynchronous prefetch from a relation data file. |
DataFileRead | Waiting for a read from a relation data file. |
DataFileSync | Waiting for changes to a relation data file to reach durable storage. |
DataFileTruncate | Waiting for a relation data file to be truncated. |
DataFileWrite | Waiting for a write to a relation data file. |
DsmAllocate | Waiting for a dynamic shared memory segment to be allocated. |
DsmFillZeroWrite | Waiting to fill a dynamic shared memory backing file with zeroes. |
LockFileAddtodatadirRead | Waiting for a read while adding a line to the data directory lock file. |
LockFileAddtodatadirSync | Waiting for data to reach durable storage while adding a line to the data directory lock file. |
LockFileAddtodatadirWrite | Waiting for a write while adding a line to the data directory lock file. |
LockFileCreateRead | Waiting to read while creating the data directory lock file. |
LockFileCreateSync | Waiting for data to reach durable storage while creating the data directory lock file. |
LockFileCreateWrite | Waiting for a write while creating the data directory lock file. |
LockFileRecheckdatadirRead | Waiting for a read during recheck of the data directory lock file. |
LogicalRewriteCheckpointSync | Waiting for logical rewrite mappings to reach durable storage during a checkpoint. |
LogicalRewriteMappingSync | Waiting for mapping data to reach durable storage during a logical rewrite. |
LogicalRewriteMappingWrite | Waiting for a write of mapping data during a logical rewrite. |
LogicalRewriteSync | Waiting for logical rewrite mappings to reach durable storage. |
LogicalRewriteTruncate | Waiting for truncate of mapping data during a logical rewrite. |
LogicalRewriteWrite | Waiting for a write of logical rewrite mappings. |
RelationMapRead | Waiting for a read of the relation map file. |
RelationMapReplace | Waiting for durable replacement of a relation map file. |
RelationMapWrite | Waiting for a write to the relation map file. |
ReorderBufferRead | Waiting for a read during reorder buffer management. |
ReorderBufferWrite | Waiting for a write during reorder buffer management. |
ReorderLogicalMappingRead | Waiting for a read of a logical mapping during reorder buffer management. |
ReplicationSlotRead | Waiting for a read from a replication slot control file. |
ReplicationSlotRestoreSync | Waiting for a replication slot control file to reach durable storage while restoring it to memory. |
ReplicationSlotSync | Waiting for a replication slot control file to reach durable storage. |
ReplicationSlotWrite | Waiting for a write to a replication slot control file. |
SlruFlushSync | Waiting for SLRU data to reach durable storage during a checkpoint or database shutdown. |
SlruRead | Waiting for a read of an SLRU page. |
SlruSync | Waiting for SLRU data to reach durable storage following a page write. |
SlruWrite | Waiting for a write of an SLRU page. |
SnapbuildRead | Waiting for a read of a serialized historical catalog snapshot. |
SnapbuildSync | Waiting for a serialized historical catalog snapshot to reach durable storage. |
SnapbuildWrite | Waiting for a write of a serialized historical catalog snapshot. |
TimelineHistoryFileSync | Waiting for a timeline history file received via streaming replication to reach durable storage. |
TimelineHistoryFileWrite | Waiting for a write of a timeline history file received via streaming replication. |
TimelineHistoryRead | Waiting for a read of a timeline history file. |
TimelineHistorySync | Waiting for a newly created timeline history file to reach durable storage. |
TimelineHistoryWrite | Waiting for a write of a newly created timeline history file. |
TwophaseFileRead | Waiting for a read of a two phase state file. |
TwophaseFileSync | Waiting for a two phase state file to reach durable storage. |
TwophaseFileWrite | Waiting for a write of a two phase state file. |
VersionFileSync | Waiting for the version file to reach durable storage while creating a database. |
VersionFileWrite | Waiting for the version file to be written while creating a database. |
WalsenderTimelineHistoryRead | Waiting for a read from a timeline history file during a walsender timeline command. |
WalBootstrapSync | Waiting for WAL to reach durable storage during bootstrapping. |
WalBootstrapWrite | Waiting for a write of a WAL page during bootstrapping. |
WalCopyRead | Waiting for a read when creating a new WAL segment by copying an existing one. |
WalCopySync | Waiting for a new WAL segment created by copying an existing one to reach durable storage. |
WalCopyWrite | Waiting for a write when creating a new WAL segment by copying an existing one. |
WalInitSync | Waiting for a newly initialized WAL file to reach durable storage. |
WalInitWrite | Waiting for a write while initializing a new WAL file. |
WalRead | Waiting for a read from a WAL file. |
WalSummaryRead | Waiting for a read from a WAL summary file. |
WalSummaryWrite | Waiting for a write to a WAL summary file. |
WalSync | Waiting for a WAL file to reach durable storage. |
WalSyncMethodAssign | Waiting for data to reach durable storage while assigning a new WAL sync method. |
WalWrite | Waiting for a write to a WAL file. |
Tableau 27.10. Wait Events of Type Ipc
IPC Wait Event | Description |
---|---|
AppendReady | Waiting for subplan nodes of an Append plan node to be ready. |
ArchiveCleanupCommand | Waiting for archive_cleanup_command to complete. |
ArchiveCommand | Waiting for archive_command to complete. |
BackendTermination | Waiting for the termination of another backend. |
BackupWaitWalArchive | Waiting for WAL files required for a backup to be successfully archived. |
BgworkerShutdown | Waiting for background worker to shut down. |
BgworkerStartup | Waiting for background worker to start up. |
BtreePage | Waiting for the page number needed to continue a parallel B-tree scan to become available. |
BufferIo | Waiting for buffer I/O to complete. |
CheckpointDelayComplete | Waiting for a backend that blocks a checkpoint from completing. |
CheckpointDelayStart | Waiting for a backend that blocks a checkpoint from starting. |
CheckpointDone | Waiting for a checkpoint to complete. |
CheckpointStart | Waiting for a checkpoint to start. |
ExecuteGather | Waiting for activity from a child process while executing a Gather plan node. |
HashBatchAllocate | Waiting for an elected Parallel Hash participant to allocate a hash table. |
HashBatchElect | Waiting to elect a Parallel Hash participant to allocate a hash table. |
HashBatchLoad | Waiting for other Parallel Hash participants to finish loading a hash table. |
HashBuildAllocate | Waiting for an elected Parallel Hash participant to allocate the initial hash table. |
HashBuildElect | Waiting to elect a Parallel Hash participant to allocate the initial hash table. |
HashBuildHashInner | Waiting for other Parallel Hash participants to finish hashing the inner relation. |
HashBuildHashOuter | Waiting for other Parallel Hash participants to finish partitioning the outer relation. |
HashGrowBatchesDecide | Waiting to elect a Parallel Hash participant to decide on future batch growth. |
HashGrowBatchesElect | Waiting to elect a Parallel Hash participant to allocate more batches. |
HashGrowBatchesFinish | Waiting for an elected Parallel Hash participant to decide on future batch growth. |
HashGrowBatchesReallocate | Waiting for an elected Parallel Hash participant to allocate more batches. |
HashGrowBatchesRepartition | Waiting for other Parallel Hash participants to finish repartitioning. |
HashGrowBucketsElect | Waiting to elect a Parallel Hash participant to allocate more buckets. |
HashGrowBucketsReallocate | Waiting for an elected Parallel Hash participant to finish allocating more buckets. |
HashGrowBucketsReinsert | Waiting for other Parallel Hash participants to finish inserting tuples into new buckets. |
LogicalApplySendData | Waiting for a logical replication leader apply process to send data to a parallel apply process. |
LogicalParallelApplyStateChange | Waiting for a logical replication parallel apply process to change state. |
LogicalSyncData | Waiting for a logical replication remote server to send data for initial table synchronization. |
LogicalSyncStateChange | Waiting for a logical replication remote server to change state. |
MemCxtPublish | Waiting for a process to publish memory information. |
MessageQueueInternal | Waiting for another process to be attached to a shared message queue. |
MessageQueuePutMessage | Waiting to write a protocol message to a shared message queue. |
MessageQueueReceive | Waiting to receive bytes from a shared message queue. |
MessageQueueSend | Waiting to send bytes to a shared message queue. |
MultixactCreation | Waiting for a multixact creation to complete. |
ParallelBitmapScan | Waiting for parallel bitmap scan to become initialized. |
ParallelCreateIndexScan | Waiting for parallel CREATE INDEX workers to finish heap scan. |
ParallelFinish | Waiting for parallel workers to finish computing. |
ProcarrayGroupUpdate | Waiting for the group leader to clear the transaction ID at transaction end. |
ProcSignalBarrier | Waiting for a barrier event to be processed by all backends. |
Promote | Waiting for standby promotion. |
RecoveryConflictSnapshot | Waiting for recovery conflict resolution for a vacuum cleanup. |
RecoveryConflictTablespace | Waiting for recovery conflict resolution for dropping a tablespace. |
RecoveryEndCommand | Waiting for recovery_end_command to complete. |
RecoveryPause | Waiting for recovery to be resumed. |
ReplicationOriginDrop | Waiting for a replication origin to become inactive so it can be dropped. |
ReplicationSlotDrop | Waiting for a replication slot to become inactive so it can be dropped. |
RestoreCommand | Waiting for restore_command to complete. |
SafeSnapshot | Waiting to obtain a valid snapshot for a READ ONLY DEFERRABLE transaction. |
SyncRep | Waiting for confirmation from a remote server during synchronous replication. |
WalBufferInit | Waiting on WAL buffer to be initialized. |
WalReceiverExit | Waiting for the WAL receiver to exit. |
WalReceiverWaitStart | Waiting for startup process to send initial data for streaming replication. |
WalSummaryReady | Waiting for a new WAL summary to be generated. |
XactGroupUpdate | Waiting for the group leader to update transaction status at transaction end. |
Tableau 27.11. Wait Events of Type Lock
Lock Wait Event | Description |
---|---|
advisory | Waiting to acquire an advisory user lock. |
applytransaction | Waiting to acquire a lock on a remote transaction being applied by a logical replication subscriber. |
extend | Waiting to extend a relation. |
frozenid | Waiting to update pg_database .datfrozenxid and pg_database .datminmxid . |
object | Waiting to acquire a lock on a non-relation database object. |
page | Waiting to acquire a lock on a page of a relation. |
relation | Waiting to acquire a lock on a relation. |
spectoken | Waiting to acquire a speculative insertion lock. |
transactionid | Waiting for a transaction to finish. |
tuple | Waiting to acquire a lock on a tuple. |
userlock | Waiting to acquire a user lock. |
virtualxid | Waiting to acquire a virtual transaction ID lock; see Section 67.1. |
Tableau 27.12. Wait Events of Type Lwlock
LWLock Wait Event | Description |
---|---|
AddinShmemInit | Waiting to manage an extension's space allocation in shared memory. |
AioWorkerSubmissionQueue | Waiting to access AIO worker submission queue. |
AutoFile | Waiting to update the postgresql.auto.conf file. |
Autovacuum | Waiting to read or update the current state of autovacuum workers. |
AutovacuumSchedule | Waiting to ensure that a table selected for autovacuum still needs vacuuming. |
BackgroundWorker | Waiting to read or update background worker state. |
BtreeVacuum | Waiting to read or update vacuum-related information for a B-tree index. |
BufferContent | Waiting to access a data page in memory. |
BufferMapping | Waiting to associate a data block with a buffer in the buffer pool. |
CheckpointerComm | Waiting to manage fsync requests. |
CommitTs | Waiting to read or update the last value set for a transaction commit timestamp. |
CommitTsBuffer | Waiting for I/O on a commit timestamp SLRU buffer. |
CommitTsSLRU | Waiting to access the commit timestamp SLRU cache. |
ControlFile | Waiting to read or update the pg_control file or create a new WAL file. |
DSMRegistry | Waiting to read or update the dynamic shared memory registry. |
DSMRegistryDSA | Waiting to access dynamic shared memory registry's dynamic shared memory allocator. |
DSMRegistryHash | Waiting to access dynamic shared memory registry's shared hash table. |
DynamicSharedMemoryControl | Waiting to read or update dynamic shared memory allocation information. |
InjectionPoint | Waiting to read or update information related to injection points. |
LockFastPath | Waiting to read or update a process' fast-path lock information. |
LockManager | Waiting to read or update information about « heavyweight » locks. |
LogicalRepLauncherDSA | Waiting to access logical replication launcher's dynamic shared memory allocator. |
LogicalRepLauncherHash | Waiting to access logical replication launcher's shared hash table. |
LogicalRepWorker | Waiting to read or update the state of logical replication workers. |
MultiXactGen | Waiting to read or update shared multixact state. |
MultiXactMemberBuffer | Waiting for I/O on a multixact member SLRU buffer. |
MultiXactMemberSLRU | Waiting to access the multixact member SLRU cache. |
MultiXactOffsetBuffer | Waiting for I/O on a multixact offset SLRU buffer. |
MultiXactOffsetSLRU | Waiting to access the multixact offset SLRU cache. |
MultiXactTruncation | Waiting to read or truncate multixact information. |
NotifyBuffer | Waiting for I/O on a NOTIFY message SLRU buffer. |
NotifyQueue | Waiting to read or update NOTIFY messages. |
NotifyQueueTail | Waiting to update limit on NOTIFY message storage. |
NotifySLRU | Waiting to access the NOTIFY message SLRU cache. |
OidGen | Waiting to allocate a new OID. |
ParallelAppend | Waiting to choose the next subplan during Parallel Append plan execution. |
ParallelBtreeScan | Waiting to synchronize workers during Parallel B-tree scan plan execution. |
ParallelHashJoin | Waiting to synchronize workers during Parallel Hash Join plan execution. |
ParallelQueryDSA | Waiting for parallel query dynamic shared memory allocation. |
ParallelVacuumDSA | Waiting for parallel vacuum dynamic shared memory allocation. |
PerSessionDSA | Waiting for parallel query dynamic shared memory allocation. |
PerSessionRecordType | Waiting to access a parallel query's information about composite types. |
PerSessionRecordTypmod | Waiting to access a parallel query's information about type modifiers that identify anonymous record types. |
PerXactPredicateList | Waiting to access the list of predicate locks held by the current serializable transaction during a parallel query. |
PgStatsData | Waiting for shared memory stats data access. |
PgStatsDSA | Waiting for stats dynamic shared memory allocator access. |
PgStatsHash | Waiting for stats shared memory hash table access. |
PredicateLockManager | Waiting to access predicate lock information used by serializable transactions. |
ProcArray | Waiting to access the shared per-process data structures (typically, to get a snapshot or report a session's transaction ID). |
RelationMapping | Waiting to read or update a pg_filenode.map file (used to track the filenode assignments of certain system catalogs). |
RelCacheInit | Waiting to read or update a pg_internal.init relation cache initialization file. |
ReplicationOrigin | Waiting to create, drop or use a replication origin. |
ReplicationOriginState | Waiting to read or update the progress of one replication origin. |
ReplicationSlotAllocation | Waiting to allocate or free a replication slot. |
ReplicationSlotControl | Waiting to read or update replication slot state. |
ReplicationSlotIO | Waiting for I/O on a replication slot. |
SerialBuffer | Waiting for I/O on a serializable transaction conflict SLRU buffer. |
SerialControl | Waiting to read or update shared pg_serial state. |
SerializableFinishedList | Waiting to access the list of finished serializable transactions. |
SerializablePredicateList | Waiting to access the list of predicate locks held by serializable transactions. |
SerializableXactHash | Waiting to read or update information about serializable transactions. |
SerialSLRU | Waiting to access the serializable transaction conflict SLRU cache. |
SharedTidBitmap | Waiting to access a shared TID bitmap during a parallel bitmap index scan. |
SharedTupleStore | Waiting to access a shared tuple store during parallel query. |
ShmemIndex | Waiting to find or allocate space in shared memory. |
SInvalRead | Waiting to retrieve messages from the shared catalog invalidation queue. |
SInvalWrite | Waiting to add a message to the shared catalog invalidation queue. |
SubtransBuffer | Waiting for I/O on a sub-transaction SLRU buffer. |
SubtransSLRU | Waiting to access the sub-transaction SLRU cache. |
SyncRep | Waiting to read or update information about the state of synchronous replication. |
SyncScan | Waiting to select the starting location of a synchronized table scan. |
TablespaceCreate | Waiting to create or drop a tablespace. |
TwoPhaseState | Waiting to read or update the state of prepared transactions. |
WaitEventCustom | Waiting to read or update custom wait events information. |
WALInsert | Waiting to insert WAL data into a memory buffer. |
WALSummarizer | Waiting to read or update WAL summarization state. |
WALWrite | Waiting for WAL buffers to be written to disk. |
WrapLimitsVacuum | Waiting to update limits on transaction id and multixact consumption. |
XactBuffer | Waiting for I/O on a transaction status SLRU buffer. |
XactSLRU | Waiting to access the transaction status SLRU cache. |
XactTruncation | Waiting to execute pg_xact_status or update the oldest transaction ID available to it. |
XidGen | Waiting to allocate a new transaction ID. |
Tableau 27.13. Wait Events of Type Timeout
Timeout Wait Event | Description |
---|---|
BaseBackupThrottle | Waiting during base backup when throttling activity. |
CheckpointWriteDelay | Waiting between writes while performing a checkpoint. |
PgSleep | Waiting due to a call to pg_sleep or a sibling function. |
RecoveryApplyDelay | Waiting to apply WAL during recovery because of a delay setting. |
RecoveryRetrieveRetryInterval | Waiting during recovery when WAL data is not available from any source (pg_wal , archive or stream). |
RegisterSyncRequest | Waiting while sending synchronization requests to the checkpointer, because the request queue is full. |
SpinDelay | Waiting while acquiring a contended spinlock. |
VacuumDelay | Waiting in a cost-based vacuum delay point. |
VacuumTruncate | Waiting to acquire an exclusive lock to truncate off any empty pages at the end of a table vacuumed. |
WalSummarizerError | Waiting after a WAL summarizer error. |
Voici des 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)
SELECT a.pid, a.wait_event, w.description FROM pg_stat_activity a JOIN pg_wait_events w ON (a.wait_event_type = w.type AND a.wait_event = w.name) WHERE a.wait_event is NOT NULL and a.state = 'active'; -[ RECORD 1 ]------------------------------------------------------------------ pid | 686674 wait_event | WALInitSync description | Waiting for a newly initialized WAL file to reach durable storage
Les extensions peuvent ajouter des événements Extension
,
InjectionPoint
et LWLock
aux listes affichées dans Tableau 27.8 et
Tableau 27.12. Dans certains cas, le nom d'un
LWLock
affecté par une extension ne sera pas disponible
pour tous les processus serveur. Il peut être indiqué simplement comme
« extension
» plutôt que par le nom indiqué
par l'extension.
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 27.14. Vue pg_stat_replication
Type Description |
---|
Identifiant du processus d'envoi des WAL |
OID de l'utilisateur connecté à ce processus |
Nom de l'utilisateur connecté à ce processus |
Nom de l'application qui est connectée à ce processus |
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. |
Nom de l'hôte du client connecté, comme renvoyé par une
recherche DNS inverse sur |
Numéro du port TCP que le client utilise pour la
communication avec ce processus, ou |
Heure à laquelle ce processus a été démarré, exemple, lorsque le client s'est connecté à ce processus expéditeur de WALs. |
L'horizon |
État courant du processus walsender. Les valeurs possibles sont :
|
La position de la dernière transaction envoyée sur cette connexion |
La position de la dernière transaction écrite sur disque par ce serveur standby |
La position de la dernière transaction vidée sur disque par ce serveur standby |
La position de la dernière transaction rejouée dans la base de données par ce serveur standby |
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 |
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 |
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 |
Priorité de ce serveur standby pour être choisi comme le serveur
|
État synchrone de ce serveur standby. Les valeurs possibles sont :
|
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.
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.
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 27.15. Vue pg_stat_replication_slots
Type de la colonne Description |
---|
Un identifiant, unique à l'instance, pour le slot de réplication |
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é |
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. |
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
|
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é |
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. |
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 |
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. |
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. |
Date où ces statistiques ont été remises à zéro. |
pg_stat_wal_receiver
#
La vue pg_stat_wal_receiver
contiendra seulement
une ligne, affichant les statistiques du walreceiver du serveur de
connexion.
Tableau 27.16. Vue pg_stat_wal_receiver
Type Description |
---|
Identifiant du processus de réception des enregistrements de transaction |
Statut d'activité du processus walreceiver |
Première position dans le journal de transaction utilisée quand walreceiver a été démarré |
Première ligne de temps utilisée quand walreceiver a été démarré |
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. |
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é. |
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 |
Horodatage d'envoi du dernier message reçu à partir du walsender |
Horodatage de la réception du dernier message à partir du walsender |
Dernière position de transaction reportée par le walsender associé |
Horodatage de la dernière position de transaction reportée par le walsender associé |
Nom du slot de réplication utilisé par ce walreceiver |
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 |
Numéro de port de l'instance PostgreSQL auquel wal receiver est connecté. |
Chaîne de connexion utilisée par ce wal receiver, les informations sensibles au niveau sécurité sont cachés. |
pg_stat_recovery_prefetch
#
La vue pg_stat_recovery_prefetch
contiendra une
seule ligne. Les colonnes wal_distance
,
block_distance
et
io_depth
affichent les valeurs actuelles et les
autres colonnes affichent des compteurs cumulatifs qui peuvent être
réinitialisés avec la fonction pg_stat_reset_shared
.
Tableau 27.17. Vue pg_stat_recovery_prefetch
Type Description |
---|
Horodatage de la dernière réinitialisation de ces statistiques |
Nombre de blocs lus en avance parce qu'ils n'étaient pas dans le cache |
Nombre de blocs non lus en avance parce qu'ils étaient déjà dans le cache |
Nombre de blocs non lus dans le cache parce qu'ils devaient être initialisés à zéro |
Nombre de blocs non lus dans le cache parce qu'ils n'existaient pas encore |
Nombre de blocs non lus dans le cache parce qu'une image complète d'un bloc a été inclus dans le WAL |
Nombre de blocs non lus dans le cache parce qu'ils avaient été récemment lus en avance |
Nombre d'octets que le prefetcher recherche |
Nombre de blocs que le prefetcher recherche |
Nombre de lectures en avance initiées mais pas encore terminées |
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 27.18. Vue pg_stat_subscription
Type Description |
---|
OID de la souscription |
Nom de la souscription |
Type de processus worker pour la souscription. Les types possibles sont
|
Identifiant du processus worker de la souscription |
Identifiant du processus leader si ce processus est un worker d'application parallélisé ; NULL si ce processus est un worker d'application autonome ou un worker de synchronisation de table |
OID de la relation que le processus worker synchronise ; NULL pour le processus worker apply principal et ses workers |
Dernier emplacement de journal de transactions reçu, la valeur initiale de ce champ étant 0 ; NULL pour les workers apply |
Horodatage d'envoi du dernier message reçu à partir du walsender original ; NULL pour les workers apply |
Horodatage de réception du dernier message reçu du walsender original ; NULL pour les workers apply |
Dernier emplacement des journaux de transactions rapporté par le walsender original ; NULL pour les workers apply |
Horodatage du dernier emplacement de journal de transactions rapporté par le walsender original |
pg_stat_subscription_stats
#
La vue pg_stat_subscription_stats
contiendra une
ligne par souscription.
Tableau 27.19. Vue pg_stat_subscription_stats
Type de colonne Description |
---|
OID de la souscription |
Nom de la souscription |
Nombre de fois où une erreur est survenue lors de l'application des
modifications. Note that any
conflict resulting in an apply error will be counted in both
|
Nombre de fois où une erreur est survenue lors de la synchronisation initiale de la table |
Number of times a row insertion violated a
|
Number of times an update was applied to a row that had been previously modified by another source during the application of changes. See update_origin_differs for details about this conflict. |
Number of times that an updated row value violated a
|
Number of times the tuple to be updated was not found during the application of changes. See update_missing for details about this conflict. |
Number of times a delete operation was applied to row that had been previously modified by another source during the application of changes. See delete_origin_differs for details about this conflict. |
Number of times the tuple to be deleted was not found during the application of changes. See delete_missing for details about this conflict. |
Number of times a row insertion or an updated row values violated multiple
|
Horodatage de la dernière réinitialisation de ces statistiques |
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 27.20. Vue pg_stat_ssl
Type Description |
---|
ID du processus backend ou du processus d'envoi de WAL |
True si SSL est utilisé dans cette connexion |
Version de SSL utilisée, ou NULL si SSL n'est pas utilisé pour cette connexion |
Nom du chiffrement SSL utilisé, ou NULL si SSL n'est pas utilisé pour cette connexion |
Nombre de bits dans l'algorithme de chiffrement utilisé, ou NULL si SSL n'est pas utilisé pour cette connexion |
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 |
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). |
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
|
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 27.21. Vue pg_stat_gssapi
Type Description |
---|
Identifiant du processus serveur |
True si l'authentification GSSAPI a été utilisée pour cette connexion |
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
|
True si le chiffrement GSSAPI est utilisé avec cette connexion |
Vrai si les informations d'identification GSSAPI ont été déléguées sur cette connexion. |
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 27.22. Vue pg_stat_archiver
Type Description |
---|
Nombre de journaux de transactions archivés avec succès |
Nom du plus récent journal de transaction archivé avec succès |
Horodatage de la plus récente opération d'archivage réussie |
Nombre d'échecs d'archivage de journaux de transactions |
Nom du journal de transactions correspondant au plus récent archivage échoué |
Horodatage de la plus récente opération d'archivage échouée |
Horodatage de la dernière réinitialisation de ces statistiques |
Habituellement, les fichiers WAL sont archivés dans l'ordre, du plus
ancien ou plus récent, mais ceci n'est pas garanti et ne tient pas sous
certaines circonstances, comme lors de la promotion d'un serveur secondaire
ou lors d'une restauration après crash. De ce fait, il n'est pas garanti que
tous les fichiers plus anciens que
last_archived_wal
aient été correctement archivés.
pg_stat_io
#
La vue pg_stat_io
contient une ligne pour chaque
combinaisons de type de processus, objet cible d'entrées/sorties disques,
et contexte d'entrées/sorties disques, affichant des statistiques sur
l'utilisation des entrées/sorties disques par l'instance. Les combinaisons
qui n'ont pas de sens sont omises.
Actuellement, les entrées/sorties disques sur des relations (par exemple, tables, index) et sur les WAL sont tracées. Néanmoins, les entrées/sorties disques qui ne passent pas par le cache disque (par exemple lors du déplacement d'une table d'un tablespace à un autre) ne sont pas actuellement tracées.
Tableau 27.23. Vue de pg_stat_io
Type de colonne Description |
---|
Type de processus backend (par exemple un background worker, un autovacuum
worker). Voir
|
Objet cible d'une opération d'entrées/sorties disques. Les valeurs possibles sont :
|
Le contexte d'une opération d'entrées/sorties disques. Les valeurs possibles sont :
|
Nombre d'opérations de lectures. |
The total size of read operations in bytes. |
Time spent waiting for read operations in milliseconds (if
track_io_timing is enabled and
|
Nombre d'opérations d'écritures. |
The total size of write operations in bytes. |
Time spent waiting for write operations in milliseconds (if
track_io_timing is enabled and
|
Number of units of size |
Temps passé à attendre la réalisation d'opérations de réécriture en millisecondes (si track_io_timing est activé, sinon zéro). Ceci inclut le temps passé en queue pour les demandes d'écriture et, potentiellement, le temps passé à écrire des données modifiées. |
Nombre d'opérations d'agrandissement de relations, chacune de la taille
spécifiée dans |
The total size of relation extend operations in bytes. |
Nombre d'octets par unité de lecture, écriture ou agrandissement.
Time spent waiting for extend operations in milliseconds. (if
track_io_timing is enabled and
|
Nombre de fois qu'un bloc désiré a été trouvé dans le cache disque. |
Nombre de fois qu'un bloc a été écrit à partir d'un cache partagé ou local pour le rendre disponible à d'autres utilisations.
Dans un |
Le nombre de fois où un buffer existant dans un buffer de taille limité a
été réutilisé dans le cadre d'une opération d'entrées/sorties disques des
contextes |
Nombre d'appels à |
Time spent waiting for fsync operations in milliseconds (if
track_io_timing is enabled and
|
Horodatage de la dernière réinitialisation des statistiques. |
Certains types de processus backend ne réalisent jamais d'opérations
d'entrées/sorties sur certains objets et/ou certains contextes. Ces lignes
sont omises de la vue. Par exemple, le checkpointer ne s'occupe pas des
tables temporaires, donc il n'y aura pas de lignes pour
backend_type
checkpointer
et
object
temp relation
.
De plus, certaines opérations d'entrées/sorties disques ne seront jamais
réalisées, soit par certains types de backends soit par certains objets
soit par certains contextes. Ces cellules seront à NULL. Par exemple, les
tables temporaires ne sont jamais synchronisées sur disque
(fsync
), donc la colonne fsyncs
sera
à NULL pour object
temp relation
. De
plus, le background writer ne fait pas de lectures, donc la colonne
reads
seront NULL pour les lignes
backend_type
background writer
.
For the object
wal
,
fsyncs
and fsync_time
track the
fsync activity of WAL files done in issue_xlog_fsync
.
writes
and write_time
track the write activity of WAL files done in
XLogWrite
.
See Section 28.5 for more information.
pg_stat_io
peut être utilisé pour informer
sur l'optimisation de la base.
Par exemple :
Un grand nombre d'évictions
peut indiquer que le cache
disque (paramètre shared_buffers
) doit être
augmenté.
Les backends clients se basent sur le checkpointer pour s'assurer que
les données sont enregistrées sur un stockage permanent. De grands nombres
pour fsyncs
pour client backend
pourrait indiquer une mauvaise configuration du cache disque ou du
checkpointer. Il existe plus d'informations sur la configuration du
checkpointer dans Section 28.5.
Habituellement, les backends client doivent être capable de se baser sur les processus auxiliaires tels que le checkpointer et le background writer pour écrire autant que possible les données modifiées. De grands nombres d'écritures par des backends clients peuvent indiquer une mauvaise configuration du cache disque ou du checkpointer. Plus d'informations sur le checkpointer sont disponibles dans Section 28.5.
Les colonnes traçant les durées d'attentes des entrées/sorties disques seront à des
valeurs différentes de zéro si track_io_timing est
activé. L'utilisateur doit faire attention lors de l'utilisation de ces
colonnes avec celles opérations d'entrée/sorties disqe correspondantes
au cas où track_io_timing
n'était pas activé en
permanence depuis la dernière réinitialisation des statistiques.
pg_stat_bgwriter
#
La vue pg_stat_bgwriter
aura toujours une ligne
unique, contenant les données sur le processus background
writer
de l'instance.
Tableau 27.24. Vue pg_stat_bgwriter
Type Description |
---|
Nombre de tampons écrits par le processus background writer (processus d'écriture en tâche de fond) |
Nombre de fois que le processus background writer a arrêté son parcours de nettoyage pour avoir écrit trop de tampons |
Nombre de tampons alloués |
Dernière fois que ces statistiques ont été réinitialisées |
pg_stat_checkpointer
#
La vue pg_stat_checkpointer
aura toujours une
seule ligne, contenant des données sur le processus checkpointer de
l'instance.
Tableau 27.25. Vue pg_stat_checkpointer
Type Description |
---|
Nombre de checkpoints planifiés suite au dépassement du délai. |
Nombre de checkpoints réclamés. |
Number of checkpoints that have been performed |
Nombre de restartpoints planifiés suit à un dépassement de délai ou à une tentative échouée |
Nombre de restartpoints réclamés |
Nombre de restartpoints réalisés |
Durée totale passée dans la portion de traitement des checkpoints et restartpoints où des fichiers ont été écrits sur disque, en millisecondes |
Durée totale passée dans la portion de traitement des checkpoints et restartpoints où des fichiers ont été synchronisés sur disque, en millisecondes |
Number of shared buffers written during checkpoints and restartpoints |
Number of SLRU buffers written during checkpoints and restartpoints |
Horodatage de la dernière réinitialisation de ces statistiques |
Checkpoints may be skipped if the server has been idle since the last one.
num_timed
and
num_requested
count both completed and skipped
checkpoints, while num_done
tracks only
the completed ones. Similarly, restartpoints may be skipped
if the last replayed checkpoint record is already the last restartpoint.
restartpoints_timed
and
restartpoints_req
count both completed and
skipped restartpoints, while restartpoints_done
tracks only the completed ones.
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 27.26. Vue pg_stat_wal
Type de la colonne Description |
---|
Nombre total d'enregistrements générés dans les journaux de transaction |
Nombre total d'images de pages complètes générées dans les journaux de transactions |
Quantité totale de journaux de transactions générés en octets. |
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 |
Date où ces statistiques ont été remises à zéro |
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 27.27. Vue pg_stat_database
Type Description |
---|
OID d'une base de données, ou 0 pour les objets partagés |
Nom de cette base de données, or |
Nombre de processus serveur actuellement connectés à cette base de
données, ou |
Nombre de transactions de cette base de données qui ont été validées |
Nombre de transactions de cette base de données qui ont été annulées |
Nombre de blocs disques lus dans cette base de données |
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). |
Nombre de lignes vivantes récupérées par des parcours séquentiels et par des enregistrements d'index renvoyés par les parcours d'index dans cette base |
Nombre de lignes vivantes récupérées par les parcours d'index dans cette base |
Nombre de lignes insérées par des requêtes dans cette base de données |
Nombre de lignes mises à jour par des requêtes dans cette base de données |
Nombre de lignes supprimées par des requêtes dans cette base de données |
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
|
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. |
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. |
Nombre de verrous mortels détectés dans cette base de données |
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 sont désactivées. |
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 sont désactivées. |
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) |
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) |
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) |
Temps passé à exécuter des expressions SQL dans cette base de données,
en millisecondes (ceci correspond à l'état |
Temps passé inactif dans une transaction dans cette base de données, en
millisecondes (cela correspond aux états |
Nombre total de sessions établies dans cette base de données |
Nombre de sessions dans cette base de données qui ont été terminées parce que la connexion au client a été perdue |
Nombre de sessions dans cette base de données qui ont été terminées par des erreurs fatales |
Nombre de sessions dans cette base de données qui ont été terminées par l'intervention d'un opérateur |
Number of parallel workers planned to be launched by queries on this database |
Number of parallel workers launched by queries on this database |
Dernière fois que ces statistiques ont été réinitialisées |
pg_stat_database_conflicts
#
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 27.28. Vue pg_stat_database_conflicts
Type Description |
---|
OID de la base de données |
Nom de cette base de données |
Nombre de requêtes dans cette base de données qui ont été annulées suite à la suppression de tablespaces |
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 |
Nombre de requêtes dans cette base de données qui ont été annulées à cause d'instantanés trop vieux |
Nombre de requêtes dans cette base de données qui ont été annulées à cause de tampons verrouillés |
Nombre de requêtes dans cette base de données qui ont
été annulées à cause de |
Nombre d'utilisations de slots logiques dans cette base de données qui ont été annulées parce que le snapshot était trop ancien ou parce que le paramètre wal_level était trop bas sur le primaire |
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 27.29. Vue pg_stat_all_tables
Type Description |
---|
OID d'une table |
Nom du schéma dans lequel se trouve cette table |
Nom de cette table |
Nombre de parcours séquentiels initiés sur cette table |
Horodatage du dernier parcours séquentiel, basé sur l'heure de fin de la transaction la plus récente |
Nombre de lignes vivantes rapportées par des parcours séquentiels |
Nombre de parcours d'index initiés sur cette table |
Horodatage du dernier parcours d'index, basé sur l'heure de fin de la transaction la plus récente |
Nombre de lignes vivantes rapportées par des parcours d'index |
Nombre total de lignes insérées |
Nombre total de lignes mises à jour. (Ceci inclut les mises à jour
comptées dans |
Nombre total de lignes supprimées |
Nombre de lignes mises à jour en utilisant HOT. Ce sont les mises à jour qui n'ont pas nécessitées de nouvelles versions dans les index. |
Nombre de lignes mises à jour où la nouvelle version de ligne va sur
un nouveau bloc du HEAP, laissant derrière
la version originale dont le
champ |
Nombre estimé de lignes vivantes |
Nombre estimé de lignes mortes |
Nombre estimé de lignes modifiées depuis le dernier ANALYZE sur cette table |
Nombre estimé de lignes insérées depuis le dernier VACUUM sur cette table |
Dernière fois qu'une opération VACUUM manuelle
a été faite sur cette table (sans compter
|
Dernière fois que le démon autovacuum a exécuté une opération VACUUM sur cette table |
Dernière fois qu'une opération ANALYZE a été lancée manuellement sur cette table |
Dernière fois que le démon autovacuum a exécuté une opération ANALYZE sur cette table |
Nombre de fois qu'une opération VACUUM manuelle a été
lancée sur cette table (sans compter
|
Nombre de fois que le démon autovacuum a exécuté une opération VACUUM manuelle |
Nombre de fois qu'une opération ANALYZE manuelle a été lancée sur cette table |
Nombre de fois que le démon autovacuum a exécuté une opération ANALYZE sur cette table |
Total time this table has been manually vacuumed, in milliseconds. (This includes the time spent sleeping due to cost-based delays.) |
Total time this table has been vacuumed by the autovacuum daemon, in milliseconds. (This includes the time spent sleeping due to cost-based delays.) |
Total time this table has been manually analyzed, in milliseconds. (This includes the time spent sleeping due to cost-based delays.) |
Total time this table has been analyzed by the autovacuum daemon, in milliseconds. (This includes the time spent sleeping due to cost-based delays.) |
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 27.30. Vue pg_stat_all_indexes
Type Description |
---|
OID de la table pour cet index |
OID de cet index |
Nom du schéma dans lequel se trouve cet index |
Nom de la table pour cet index |
Nom de cet index |
Nombre de parcours d'index initiés par cet index |
L'horodatage du dernier parcours de cet index, basé sur l'heure de fin de la transaction la plus récente |
Nombre d'entrées d'index retournées par des parcours sur cet index |
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.
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.
Index scans may sometimes perform multiple index searches per execution.
Each index search increments pg_stat_all_indexes
.idx_scan
,
donc il est possible que le nombre de parcours d'index dépasse
significativement le nombre total d'exécutions du nœud de parcours d'index
de l'exécuteur.
This can happen with queries that use certain SQL
constructs to search for rows matching any value out of a list or array of
multiple scalar values (see Section 9.25). It
can also happen to queries with a
construct, though only
when the optimizer transforms the construct into an equivalent
multi-valued array representation. Similarly, when B-tree index scans use
the skip scan optimization, an index search is performed each time the
scan is repositioned to the next index leaf page that might have matching
tuples (see Section 11.3).
column_name
=
value1
OR
column_name
=
value2
...
EXPLAIN ANALYZE
outputs the total number of index
searches performed by each index scan node. See
Section 14.1.2 for an example demonstrating how
this works.
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 27.31. Vue pg_statio_all_tables
Type Description |
---|
OID d'une table |
Nom du schéma dans lequel se trouve cette table |
Nom de cette table |
Nombre de blocs disque lus hors cache pour cette table |
Nombre de blocs disque lus dans le cache pour cette table |
Nombre de blocs disque lus hors cache pour tous les index de cette table |
Nombre de tampons lus dans le cache pour tous les index de cette table |
Nombre de blocs disque lus sur la partie TOAST de cette table (si présente) |
Nombre de tampons récupérés sur la partie TOAST de cette table (si présente) |
Nombre de blocs disque lus sur les index de la partie TOAST de cette table (si présente) |
Nombre de tampons récupérés sur les index de la partie TOAST de cette table (si présente) |
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 27.32. Vue pg_statio_all_indexes
Type Description |
---|
OID de la table pour cet index |
OID de cet index |
Nom du schéma dans lequel se trouve cet index |
Nom de la table pour cet index |
Nom de cet index |
Nombre de blocs disque lus pour cet index |
Nombre de tampons récupérés sur cet index |
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 27.33. Vue pg_statio_all_sequences
Type Description |
---|
OID de cette séquence |
Nom du schéma dans lequel se trouve cette séquence |
Nom de cette séquence |
Nombre de blocs disque lus pour cette séquence |
Nombre de tampons récupérés pour cette séquence |
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 27.34. Vue pg_stat_user_functions
Type Description |
---|
OID de cette fonction |
Nom du schéma dans lequel se trouve cette fonction |
Nom de cette fonction |
Nombre de fois que cette fonction a été appelée |
Temps total passé dans cette fonction ainsi que dans toutes les autres fonctions appelées par elle, en millisecondes |
Temps total passé dans cette fonction seule, sans inclure les autres fonctions appelées par elle, en millisecondes |
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.
Pour chaque cache SLRU
qui fait partie du cœur du serveur,
il existe un paramètre de configuration permettant de contrôler sa
taille, avec le suffixe _buffers
ajouté.
Tableau 27.35. Vue pg_stat_slru
Type Description |
---|
Nom du cache SLRU |
Nombre de blocs initialisés à zéro |
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) |
Nombre de blocs disques lus à partir de ce cache SLRU |
Nombre de blocs disques écrit dans ce cache SLRU |
Nombre de blocs dont l'existence a été vérifiée dans ce cache SLRU |
Nombre de vidages de données modifiées pour ce cache SLRU |
Nombre de troncatures pour ce cache SLRU |
Horodatage de la dernière réinitialisation de ces 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 27.36.
Tableau 27.36. Fonctions supplémentaires de statistiques
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 autre ensemble
de fonctions d'accès aux statistiques par processus serveur peut être
utilisé ; celle-ci sont montrées dans Tableau 27.37. Ces fonctions d'accès
utilisent un numéro d'identifiant du processus serveur de la session, qui
est un très petit entier positive (>= 0) distinct de l'identifiant du processus
backend de toute session concurrente, bien qu'un identifiant de session
peut être recyclé dès qu'il n'est plus utilisé. L'identifiant de processus
backend est utilisé, entre autres choses, pour identifier le schéma
temporaire de la session s'il en a un. La fonction
pg_stat_get_backend_idset
fournit une manière pratique
de lister tous les numéros d'identifiant des processus serveurs actifs 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(backendid) AS pid, pg_stat_get_backend_activity(backendid) AS query FROM pg_stat_get_backend_idset() AS backendid;
Tableau 27.37. Fonctions statistiques par processus serveur
Fonction Description |
---|
Texte de la requête la plus récente de ce processus serveur |
Heure à laquelle la requête la plus récente a été démarrée |
Adresse IP du client connecté à ce processus serveur |
Numéro de port TCP que le client utilise pour communiquer |
OID de la base de données auquel ce processus serveur est connecté |
Ensemble de numéros de processus serveur actuellement actifs |
Identifiant du processus serveur |
Heure à laquelle ce processus a été démarré |
Renvoie un enregistrement d'informations sur le backend ayant cet
identifiant. Les champs renvoyés sont
|
Renvoie l'OID de l'utilisateur connecté à ce processus serveur |
Renvoie le nom de l'événement d'attente si le processus est actuellement en attente, NULL sinon. Voir Tableau 27.4 pour les détails. |
Renvoie le nom du type d'événement d'attente si le processus est actuellement en attente, NULL sinon. Voir Tableau 27.4 pour les détails. |
Heure à laquelle la transaction courante a été démarrée |