PostgreSQL Source Code git master
All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
pgstat.c File Reference
#include "postgres.h"
#include <unistd.h>
#include "access/xact.h"
#include "lib/dshash.h"
#include "pgstat.h"
#include "storage/fd.h"
#include "storage/ipc.h"
#include "storage/lwlock.h"
#include "utils/guc_hooks.h"
#include "utils/memutils.h"
#include "utils/pgstat_internal.h"
#include "utils/timestamp.h"
#include "lib/simplehash.h"
Include dependency graph for pgstat.c:

Go to the source code of this file.

Data Structures

struct  PgStat_SnapshotEntry
 

Macros

#define PGSTAT_MIN_INTERVAL   1000
 
#define PGSTAT_MAX_INTERVAL   60000
 
#define PGSTAT_IDLE_INTERVAL   10000
 
#define PGSTAT_SNAPSHOT_HASH_SIZE   512
 
#define PGSTAT_FILE_ENTRY_END   'E' /* end of file */
 
#define PGSTAT_FILE_ENTRY_FIXED   'F' /* fixed-numbered stats entry */
 
#define PGSTAT_FILE_ENTRY_NAME   'N' /* stats entry identified by name */
 
#define PGSTAT_FILE_ENTRY_HASH
 
#define SH_PREFIX   pgstat_snapshot
 
#define SH_ELEMENT_TYPE   PgStat_SnapshotEntry
 
#define SH_KEY_TYPE   PgStat_HashKey
 
#define SH_KEY   key
 
#define SH_HASH_KEY(tb, key)    pgstat_hash_hash_key(&key, sizeof(PgStat_HashKey), NULL)
 
#define SH_EQUAL(tb, a, b)    pgstat_cmp_hash_key(&a, &b, sizeof(PgStat_HashKey), NULL) == 0
 
#define SH_SCOPE   static inline
 
#define SH_DEFINE
 
#define SH_DECLARE
 
#define write_chunk_s(fpout, ptr)   write_chunk(fpout, ptr, sizeof(*ptr))
 
#define read_chunk_s(fpin, ptr)   read_chunk(fpin, ptr, sizeof(*ptr))
 

Typedefs

typedef struct PgStat_SnapshotEntry PgStat_SnapshotEntry
 

Functions

static void pgstat_write_statsfile (void)
 
static void pgstat_read_statsfile (void)
 
static void pgstat_init_snapshot_fixed (void)
 
static void pgstat_reset_after_failure (void)
 
static bool pgstat_flush_pending_entries (bool nowait)
 
static void pgstat_prep_snapshot (void)
 
static void pgstat_build_snapshot (void)
 
static void pgstat_build_snapshot_fixed (PgStat_Kind kind)
 
static bool pgstat_is_kind_valid (PgStat_Kind kind)
 
void pgstat_restore_stats (void)
 
void pgstat_discard_stats (void)
 
void pgstat_before_server_shutdown (int code, Datum arg)
 
static void pgstat_shutdown_hook (int code, Datum arg)
 
void pgstat_initialize (void)
 
long pgstat_report_stat (bool force)
 
void pgstat_force_next_flush (void)
 
static bool match_db_entries (PgStatShared_HashEntry *entry, Datum match_data)
 
void pgstat_reset_counters (void)
 
void pgstat_reset (PgStat_Kind kind, Oid dboid, uint64 objid)
 
void pgstat_reset_of_kind (PgStat_Kind kind)
 
void pgstat_clear_snapshot (void)
 
void * pgstat_fetch_entry (PgStat_Kind kind, Oid dboid, uint64 objid)
 
TimestampTz pgstat_get_stat_snapshot_timestamp (bool *have_snapshot)
 
bool pgstat_have_entry (PgStat_Kind kind, Oid dboid, uint64 objid)
 
void pgstat_snapshot_fixed (PgStat_Kind kind)
 
PgStat_EntryRefpgstat_prep_pending_entry (PgStat_Kind kind, Oid dboid, uint64 objid, bool *created_entry)
 
PgStat_EntryRefpgstat_fetch_pending_entry (PgStat_Kind kind, Oid dboid, uint64 objid)
 
void pgstat_delete_pending_entry (PgStat_EntryRef *entry_ref)
 
PgStat_Kind pgstat_get_kind_from_str (char *kind_str)
 
const PgStat_KindInfopgstat_get_kind_info (PgStat_Kind kind)
 
void pgstat_register_kind (PgStat_Kind kind, const PgStat_KindInfo *kind_info)
 
static void write_chunk (FILE *fpout, void *ptr, size_t len)
 
static bool read_chunk (FILE *fpin, void *ptr, size_t len)
 
void assign_stats_fetch_consistency (int newval, void *extra)
 

Variables

bool pgstat_track_counts = false
 
int pgstat_fetch_consistency = PGSTAT_FETCH_CONSISTENCY_CACHE
 
PgStat_LocalState pgStatLocal
 
static MemoryContext pgStatPendingContext = NULL
 
static dlist_head pgStatPending = DLIST_STATIC_INIT(pgStatPending)
 
static bool pgStatForceNextFlush = false
 
static bool force_stats_snapshot_clear = false
 
static const PgStat_KindInfo pgstat_kind_builtin_infos [PGSTAT_KIND_BUILTIN_SIZE]
 
static const PgStat_KindInfo ** pgstat_kind_custom_infos = NULL
 

Macro Definition Documentation

◆ PGSTAT_FILE_ENTRY_END

#define PGSTAT_FILE_ENTRY_END   'E' /* end of file */

Definition at line 143 of file pgstat.c.

◆ PGSTAT_FILE_ENTRY_FIXED

#define PGSTAT_FILE_ENTRY_FIXED   'F' /* fixed-numbered stats entry */

Definition at line 144 of file pgstat.c.

◆ PGSTAT_FILE_ENTRY_HASH

#define PGSTAT_FILE_ENTRY_HASH
Value:
'S' /* stats entry identified by
* PgStat_HashKey */

Definition at line 146 of file pgstat.c.

◆ PGSTAT_FILE_ENTRY_NAME

#define PGSTAT_FILE_ENTRY_NAME   'N' /* stats entry identified by name */

Definition at line 145 of file pgstat.c.

◆ PGSTAT_IDLE_INTERVAL

#define PGSTAT_IDLE_INTERVAL   10000

Definition at line 130 of file pgstat.c.

◆ PGSTAT_MAX_INTERVAL

#define PGSTAT_MAX_INTERVAL   60000

Definition at line 128 of file pgstat.c.

◆ PGSTAT_MIN_INTERVAL

#define PGSTAT_MIN_INTERVAL   1000

Definition at line 126 of file pgstat.c.

◆ PGSTAT_SNAPSHOT_HASH_SIZE

#define PGSTAT_SNAPSHOT_HASH_SIZE   512

Definition at line 137 of file pgstat.c.

◆ read_chunk_s

#define read_chunk_s (   fpin,
  ptr 
)    read_chunk(fpin, ptr, sizeof(*ptr))

Definition at line 1761 of file pgstat.c.

◆ SH_DECLARE

#define SH_DECLARE

Definition at line 173 of file pgstat.c.

◆ SH_DEFINE

#define SH_DEFINE

Definition at line 172 of file pgstat.c.

◆ SH_ELEMENT_TYPE

#define SH_ELEMENT_TYPE   PgStat_SnapshotEntry

Definition at line 164 of file pgstat.c.

◆ SH_EQUAL

#define SH_EQUAL (   tb,
  a,
  b 
)     pgstat_cmp_hash_key(&a, &b, sizeof(PgStat_HashKey), NULL) == 0

Definition at line 169 of file pgstat.c.

◆ SH_HASH_KEY

#define SH_HASH_KEY (   tb,
  key 
)     pgstat_hash_hash_key(&key, sizeof(PgStat_HashKey), NULL)

Definition at line 167 of file pgstat.c.

◆ SH_KEY

#define SH_KEY   key

Definition at line 166 of file pgstat.c.

◆ SH_KEY_TYPE

#define SH_KEY_TYPE   PgStat_HashKey

Definition at line 165 of file pgstat.c.

◆ SH_PREFIX

#define SH_PREFIX   pgstat_snapshot

Definition at line 163 of file pgstat.c.

◆ SH_SCOPE

#define SH_SCOPE   static inline

Definition at line 171 of file pgstat.c.

◆ write_chunk_s

#define write_chunk_s (   fpout,
  ptr 
)    write_chunk(fpout, ptr, sizeof(*ptr))

Definition at line 1579 of file pgstat.c.

Typedef Documentation

◆ PgStat_SnapshotEntry

Function Documentation

◆ assign_stats_fetch_consistency()

void assign_stats_fetch_consistency ( int  newval,
void *  extra 
)

Definition at line 2064 of file pgstat.c.

2066{
2067 /*
2068 * Changing this value in a transaction may cause snapshot state
2069 * inconsistencies, so force a clear of the current snapshot on the next
2070 * snapshot build attempt.
2071 */
#define newval
int pgstat_fetch_consistency
Definition: pgstat.c:204
static bool force_stats_snapshot_clear
Definition: pgstat.c:250

References force_stats_snapshot_clear, newval, and pgstat_fetch_consistency.

◆ match_db_entries()

static bool match_db_entries ( PgStatShared_HashEntry entry,
Datum  match_data 
)
static

Definition at line 838 of file pgstat.c.

840{
841 return entry->key.dboid == DatumGetObjectId(MyDatabaseId);
Oid MyDatabaseId
Definition: globals.c:95
static Oid DatumGetObjectId(Datum X)
Definition: postgres.h:247

References DatumGetObjectId(), PgStat_HashKey::dboid, PgStatShared_HashEntry::key, and MyDatabaseId.

Referenced by pgstat_reset_counters().

◆ pgstat_before_server_shutdown()

void pgstat_before_server_shutdown ( int  code,
Datum  arg 
)

Definition at line 559 of file pgstat.c.

561{
562 Assert(pgStatLocal.shmem != NULL);
564
565 /*
566 * Stats should only be reported after pgstat_initialize() and before
567 * pgstat_shutdown(). This is a convenient point to catch most violations
568 * of this rule.
569 */
570 Assert(pgstat_is_initialized && !pgstat_is_shutdown);
571
572 /* flush out our own pending changes before writing out */
573 pgstat_report_stat(true);
574
575 /*
576 * Only write out file during normal shutdown. Don't even signal that
577 * we've shutdown during irregular shutdowns, because the shutdown
578 * sequence isn't coordinated to ensure this backend shuts down last.
579 */
580 if (code == 0)
581 {
584 }
Assert(PointerIsAligned(start, uint64))
static void pgstat_write_statsfile(void)
Definition: pgstat.c:1586
long pgstat_report_stat(bool force)
Definition: pgstat.c:691
PgStat_LocalState pgStatLocal
Definition: pgstat.c:212
PgStat_ShmemControl * shmem

References Assert(), PgStat_ShmemControl::is_shutdown, pgstat_report_stat(), pgstat_write_statsfile(), pgStatLocal, and PgStat_LocalState::shmem.

Referenced by CheckpointerMain(), and InitPostgres().

◆ pgstat_build_snapshot()

static void pgstat_build_snapshot ( void  )
static

Definition at line 1138 of file pgstat.c.

1140{
1141 dshash_seq_status hstat;
1143
1144 /* should only be called when we need a snapshot */
1146
1147 /* snapshot already built */
1149 return;
1150
1152
1153 Assert(pgStatLocal.snapshot.stats->members == 0);
1154
1156
1157 /*
1158 * Snapshot all variable stats.
1159 */
1160 dshash_seq_init(&hstat, pgStatLocal.shared_hash, false);
1161 while ((p = dshash_seq_next(&hstat)) != NULL)
1162 {
1163 PgStat_Kind kind = p->key.kind;
1164 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
1165 bool found;
1166 PgStat_SnapshotEntry *entry;
1167 PgStatShared_Common *stats_data;
1168
1169 /*
1170 * Check if the stats object should be included in the snapshot.
1171 * Unless the stats kind can be accessed from all databases (e.g.,
1172 * database stats themselves), we only include stats for the current
1173 * database or objects not associated with a database (e.g. shared
1174 * relations).
1175 */
1176 if (p->key.dboid != MyDatabaseId &&
1177 p->key.dboid != InvalidOid &&
1178 !kind_info->accessed_across_databases)
1179 continue;
1180
1181 if (p->dropped)
1182 continue;
1183
1185
1186 stats_data = dsa_get_address(pgStatLocal.dsa, p->body);
1187 Assert(stats_data);
1188
1189 entry = pgstat_snapshot_insert(pgStatLocal.snapshot.stats, p->key, &found);
1190 Assert(!found);
1191
1193 kind_info->shared_size);
1194
1195 /*
1196 * Acquire the LWLock directly instead of using
1197 * pg_stat_lock_entry_shared() which requires a reference.
1198 */
1199 LWLockAcquire(&stats_data->lock, LW_SHARED);
1200 memcpy(entry->data,
1201 pgstat_get_entry_data(kind, stats_data),
1202 kind_info->shared_size);
1203 LWLockRelease(&stats_data->lock);
1204 }
1205 dshash_seq_term(&hstat);
1206
1207 /*
1208 * Build snapshot of all fixed-numbered stats.
1209 */
1210 for (PgStat_Kind kind = PGSTAT_KIND_MIN; kind <= PGSTAT_KIND_MAX; kind++)
1211 {
1212 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
1213
1214 if (!kind_info)
1215 continue;
1216 if (!kind_info->fixed_amount)
1217 {
1218 Assert(kind_info->snapshot_cb == NULL);
1219 continue;
1220 }
1221
1223 }
1224
static uint32 pg_atomic_read_u32(volatile pg_atomic_uint32 *ptr)
Definition: atomics.h:239
TimestampTz GetCurrentTimestamp(void)
Definition: timestamp.c:1645
void * dsa_get_address(dsa_area *area, dsa_pointer dp)
Definition: dsa.c:942
void dshash_seq_init(dshash_seq_status *status, dshash_table *hash_table, bool exclusive)
Definition: dshash.c:638
void dshash_seq_term(dshash_seq_status *status)
Definition: dshash.c:747
void * dshash_seq_next(dshash_seq_status *status)
Definition: dshash.c:657
bool LWLockAcquire(LWLock *lock, LWLockMode mode)
Definition: lwlock.c:1182
void LWLockRelease(LWLock *lock)
Definition: lwlock.c:1902
@ LW_SHARED
Definition: lwlock.h:115
void * MemoryContextAlloc(MemoryContext context, Size size)
Definition: mcxt.c:1256
static void pgstat_prep_snapshot(void)
Definition: pgstat.c:1117
static void pgstat_build_snapshot_fixed(PgStat_Kind kind)
Definition: pgstat.c:1228
const PgStat_KindInfo * pgstat_get_kind_info(PgStat_Kind kind)
Definition: pgstat.c:1453
@ PGSTAT_FETCH_CONSISTENCY_SNAPSHOT
Definition: pgstat.h:48
static void * pgstat_get_entry_data(PgStat_Kind kind, PgStatShared_Common *entry)
#define PgStat_Kind
Definition: pgstat_kind.h:17
#define PGSTAT_KIND_MAX
Definition: pgstat_kind.h:21
#define PGSTAT_KIND_MIN
Definition: pgstat_kind.h:20
#define InvalidOid
Definition: postgres_ext.h:35
pg_atomic_uint32 refcount
PgStat_Kind kind
bool accessed_across_databases
void(* snapshot_cb)(void)
PgStat_Snapshot snapshot
dshash_table * shared_hash
TimestampTz snapshot_timestamp
MemoryContext context
PgStat_FetchConsistency mode
struct pgstat_snapshot_hash * stats

References PgStat_KindInfo::accessed_across_databases, Assert(), PgStatShared_HashEntry::body, PgStat_Snapshot::context, PgStat_SnapshotEntry::data, PgStat_HashKey::dboid, PgStatShared_HashEntry::dropped, PgStat_LocalState::dsa, dsa_get_address(), dshash_seq_init(), dshash_seq_next(), dshash_seq_term(), PgStat_KindInfo::fixed_amount, GetCurrentTimestamp(), InvalidOid, PgStatShared_HashEntry::key, PgStat_HashKey::kind, PgStatShared_Common::lock, LW_SHARED, LWLockAcquire(), LWLockRelease(), MemoryContextAlloc(), PgStat_Snapshot::mode, MyDatabaseId, pg_atomic_read_u32(), pgstat_build_snapshot_fixed(), pgstat_fetch_consistency, PGSTAT_FETCH_CONSISTENCY_SNAPSHOT, pgstat_get_entry_data(), pgstat_get_kind_info(), PgStat_Kind, PGSTAT_KIND_MAX, PGSTAT_KIND_MIN, pgstat_prep_snapshot(), pgStatLocal, PgStatShared_HashEntry::refcount, PgStat_LocalState::shared_hash, PgStat_KindInfo::shared_size, PgStat_LocalState::snapshot, PgStat_KindInfo::snapshot_cb, PgStat_Snapshot::snapshot_timestamp, and PgStat_Snapshot::stats.

Referenced by pgstat_fetch_entry(), and pgstat_snapshot_fixed().

◆ pgstat_build_snapshot_fixed()

static void pgstat_build_snapshot_fixed ( PgStat_Kind  kind)
static

Definition at line 1228 of file pgstat.c.

1230{
1231 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
1232 int idx;
1233 bool *valid;
1234
1235 /* Position in fixed_valid or custom_valid */
1236 if (pgstat_is_kind_builtin(kind))
1237 {
1238 idx = kind;
1240 }
1241 else
1242 {
1243 idx = kind - PGSTAT_KIND_CUSTOM_MIN;
1245 }
1246
1247 Assert(kind_info->fixed_amount);
1248 Assert(kind_info->snapshot_cb != NULL);
1249
1251 {
1252 /* rebuild every time */
1253 valid[idx] = false;
1254 }
1255 else if (valid[idx])
1256 {
1257 /* in snapshot mode we shouldn't get called again */
1259 return;
1260 }
1261
1262 Assert(!valid[idx]);
1263
1264 kind_info->snapshot_cb();
1265
1266 Assert(!valid[idx]);
1267 valid[idx] = true;
Datum idx(PG_FUNCTION_ARGS)
Definition: _int_op.c:262
@ PGSTAT_FETCH_CONSISTENCY_NONE
Definition: pgstat.h:46
@ PGSTAT_FETCH_CONSISTENCY_CACHE
Definition: pgstat.h:47
static bool pgstat_is_kind_builtin(PgStat_Kind kind)
Definition: pgstat_kind.h:61
#define PGSTAT_KIND_CUSTOM_MIN
Definition: pgstat_kind.h:49
bool custom_valid[PGSTAT_KIND_CUSTOM_SIZE]
bool fixed_valid[PGSTAT_KIND_BUILTIN_SIZE]

References Assert(), PgStat_Snapshot::custom_valid, PgStat_KindInfo::fixed_amount, PgStat_Snapshot::fixed_valid, idx(), pgstat_fetch_consistency, PGSTAT_FETCH_CONSISTENCY_CACHE, PGSTAT_FETCH_CONSISTENCY_NONE, pgstat_get_kind_info(), pgstat_is_kind_builtin(), PGSTAT_KIND_CUSTOM_MIN, pgStatLocal, PgStat_LocalState::snapshot, and PgStat_KindInfo::snapshot_cb.

Referenced by pgstat_build_snapshot(), pgstat_snapshot_fixed(), and pgstat_write_statsfile().

◆ pgstat_clear_snapshot()

void pgstat_clear_snapshot ( void  )

Definition at line 917 of file pgstat.c.

919{
921
928
929 /* Release memory, if any was allocated */
931 {
933
934 /* Reset variables */
936 }
937
938 /*
939 * Historically the backend_status.c facilities lived in this file, and
940 * were reset with the same function. For now keep it that way, and
941 * forward the reset request.
942 */
944
945 /* Reset this flag, as it may be possible that a cleanup was forced. */
void pgstat_clear_backend_activity_snapshot(void)
void MemoryContextDelete(MemoryContext context)
Definition: mcxt.c:485
#define pgstat_assert_is_up()

References PgStat_Snapshot::context, PgStat_Snapshot::custom_valid, PgStat_Snapshot::fixed_valid, force_stats_snapshot_clear, MemoryContextDelete(), PgStat_Snapshot::mode, pgstat_assert_is_up, pgstat_clear_backend_activity_snapshot(), PGSTAT_FETCH_CONSISTENCY_NONE, pgStatLocal, PgStat_LocalState::snapshot, and PgStat_Snapshot::stats.

Referenced by AtEOXact_PgStat(), pg_stat_clear_snapshot(), pgstat_get_stat_snapshot_timestamp(), pgstat_prep_snapshot(), pgstat_snapshot_fixed(), and PostPrepare_PgStat().

◆ pgstat_delete_pending_entry()

void pgstat_delete_pending_entry ( PgStat_EntryRef entry_ref)

Definition at line 1334 of file pgstat.c.

1336{
1337 PgStat_Kind kind = entry_ref->shared_entry->key.kind;
1338 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
1339 void *pending_data = entry_ref->pending;
1340
1341 Assert(pending_data != NULL);
1342 /* !fixed_amount stats should be handled explicitly */
1343 Assert(!pgstat_get_kind_info(kind)->fixed_amount);
1344
1345 if (kind_info->delete_pending_cb)
1346 kind_info->delete_pending_cb(entry_ref);
1347
1348 pfree(pending_data);
1349 entry_ref->pending = NULL;
1350
1351 dlist_delete(&entry_ref->pending_node);
static void dlist_delete(dlist_node *node)
Definition: ilist.h:405
void pfree(void *pointer)
Definition: mcxt.c:2147
PgStatShared_HashEntry * shared_entry
dlist_node pending_node
void(* delete_pending_cb)(PgStat_EntryRef *sr)

References Assert(), PgStat_KindInfo::delete_pending_cb, dlist_delete(), PgStatShared_HashEntry::key, PgStat_HashKey::kind, PgStat_EntryRef::pending, PgStat_EntryRef::pending_node, pfree(), pgstat_get_kind_info(), PgStat_Kind, and PgStat_EntryRef::shared_entry.

Referenced by pgstat_flush_pending_entries(), and pgstat_release_entry_ref().

◆ pgstat_discard_stats()

void pgstat_discard_stats ( void  )

Definition at line 516 of file pgstat.c.

518{
519 int ret;
520
521 /* NB: this needs to be done even in single user mode */
522
523 ret = unlink(PGSTAT_STAT_PERMANENT_FILENAME);
524 if (ret != 0)
525 {
526 if (errno == ENOENT)
527 elog(DEBUG2,
528 "didn't need to unlink permanent stats file \"%s\" - didn't exist",
530 else
531 ereport(LOG,
533 errmsg("could not unlink permanent statistics file \"%s\": %m",
535 }
536 else
537 {
540 errmsg_internal("unlinked permanent statistics file \"%s\"",
542 }
543
544 /*
545 * Reset stats contents. This will set reset timestamps of fixed-numbered
546 * stats to the current time (no variable stats exist).
547 */
int errmsg_internal(const char *fmt,...)
Definition: elog.c:1158
int errcode_for_file_access(void)
Definition: elog.c:877
int errmsg(const char *fmt,...)
Definition: elog.c:1071
#define LOG
Definition: elog.h:31
#define DEBUG2
Definition: elog.h:29
#define elog(elevel,...)
Definition: elog.h:226
#define ereport(elevel,...)
Definition: elog.h:149
static void pgstat_reset_after_failure(void)
Definition: pgstat.c:2041
#define PGSTAT_STAT_PERMANENT_FILENAME
Definition: pgstat.h:30

References DEBUG2, elog, ereport, errcode_for_file_access(), errmsg(), errmsg_internal(), LOG, pgstat_reset_after_failure(), and PGSTAT_STAT_PERMANENT_FILENAME.

Referenced by StartupXLOG().

◆ pgstat_fetch_entry()

void * pgstat_fetch_entry ( PgStat_Kind  kind,
Oid  dboid,
uint64  objid 
)

Definition at line 949 of file pgstat.c.

951{
953 PgStat_EntryRef *entry_ref;
954 void *stats_data;
955 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
956
957 /* should be called from backends */
959 Assert(!kind_info->fixed_amount);
960
962
963 /* clear padding */
964 memset(&key, 0, sizeof(struct PgStat_HashKey));
965
966 key.kind = kind;
967 key.dboid = dboid;
968 key.objid = objid;
969
970 /* if we need to build a full snapshot, do so */
973
974 /* if caching is desired, look up in cache */
976 {
977 PgStat_SnapshotEntry *entry = NULL;
978
979 entry = pgstat_snapshot_lookup(pgStatLocal.snapshot.stats, key);
980
981 if (entry)
982 return entry->data;
983
984 /*
985 * If we built a full snapshot and the key is not in
986 * pgStatLocal.snapshot.stats, there are no matching stats.
987 */
989 return NULL;
990 }
991
993
994 entry_ref = pgstat_get_entry_ref(kind, dboid, objid, false, NULL);
995
996 if (entry_ref == NULL || entry_ref->shared_entry->dropped)
997 {
998 /* create empty entry when using PGSTAT_FETCH_CONSISTENCY_CACHE */
1000 {
1001 PgStat_SnapshotEntry *entry = NULL;
1002 bool found;
1003
1004 entry = pgstat_snapshot_insert(pgStatLocal.snapshot.stats, key, &found);
1005 Assert(!found);
1006 entry->data = NULL;
1007 }
1008 return NULL;
1009 }
1010
1011 /*
1012 * Allocate in caller's context for PGSTAT_FETCH_CONSISTENCY_NONE,
1013 * otherwise we could quickly end up with a fair bit of memory used due to
1014 * repeated accesses.
1015 */
1017 stats_data = palloc(kind_info->shared_data_len);
1018 else
1020 kind_info->shared_data_len);
1021
1022 (void) pgstat_lock_entry_shared(entry_ref, false);
1023 memcpy(stats_data,
1024 pgstat_get_entry_data(kind, entry_ref->shared_stats),
1025 kind_info->shared_data_len);
1026 pgstat_unlock_entry(entry_ref);
1027
1029 {
1030 PgStat_SnapshotEntry *entry = NULL;
1031 bool found;
1032
1033 entry = pgstat_snapshot_insert(pgStatLocal.snapshot.stats, key, &found);
1034 entry->data = stats_data;
1035 }
1036
1037 return stats_data;
bool IsUnderPostmaster
Definition: globals.c:121
bool IsPostmasterEnvironment
Definition: globals.c:120
void * palloc(Size size)
Definition: mcxt.c:1940
static void pgstat_build_snapshot(void)
Definition: pgstat.c:1138
PgStat_EntryRef * pgstat_get_entry_ref(PgStat_Kind kind, Oid dboid, uint64 objid, bool create, bool *created_entry)
Definition: pgstat_shmem.c:444
bool pgstat_lock_entry_shared(PgStat_EntryRef *entry_ref, bool nowait)
Definition: pgstat_shmem.c:672
void pgstat_unlock_entry(PgStat_EntryRef *entry_ref)
Definition: pgstat_shmem.c:684
PgStatShared_Common * shared_stats

References Assert(), PgStat_Snapshot::context, PgStat_SnapshotEntry::data, PgStatShared_HashEntry::dropped, PgStat_KindInfo::fixed_amount, IsPostmasterEnvironment, IsUnderPostmaster, sort-test::key, MemoryContextAlloc(), PgStat_Snapshot::mode, palloc(), pgstat_build_snapshot(), pgstat_fetch_consistency, PGSTAT_FETCH_CONSISTENCY_CACHE, PGSTAT_FETCH_CONSISTENCY_NONE, PGSTAT_FETCH_CONSISTENCY_SNAPSHOT, pgstat_get_entry_data(), pgstat_get_entry_ref(), pgstat_get_kind_info(), pgstat_lock_entry_shared(), pgstat_prep_snapshot(), pgstat_unlock_entry(), pgStatLocal, PgStat_KindInfo::shared_data_len, PgStat_EntryRef::shared_entry, PgStat_EntryRef::shared_stats, PgStat_LocalState::snapshot, and PgStat_Snapshot::stats.

Referenced by pgstat_fetch_replslot(), pgstat_fetch_stat_backend(), pgstat_fetch_stat_dbentry(), pgstat_fetch_stat_funcentry(), pgstat_fetch_stat_injentry(), pgstat_fetch_stat_subscription(), and pgstat_fetch_stat_tabentry_ext().

◆ pgstat_fetch_pending_entry()

PgStat_EntryRef * pgstat_fetch_pending_entry ( PgStat_Kind  kind,
Oid  dboid,
uint64  objid 
)

Definition at line 1321 of file pgstat.c.

1323{
1324 PgStat_EntryRef *entry_ref;
1325
1326 entry_ref = pgstat_get_entry_ref(kind, dboid, objid, false, NULL);
1327
1328 if (entry_ref == NULL || entry_ref->pending == NULL)
1329 return NULL;
1330
1331 return entry_ref;

References PgStat_EntryRef::pending, and pgstat_get_entry_ref().

Referenced by find_funcstat_entry(), and find_tabstat_entry().

◆ pgstat_flush_pending_entries()

static bool pgstat_flush_pending_entries ( bool  nowait)
static

Definition at line 1357 of file pgstat.c.

1359{
1360 bool have_pending = false;
1361 dlist_node *cur = NULL;
1362
1363 /*
1364 * Need to be a bit careful iterating over the list of pending entries.
1365 * Processing a pending entry may queue further pending entries to the end
1366 * of the list that we want to process, so a simple iteration won't do.
1367 * Further complicating matters is that we want to delete the current
1368 * entry in each iteration from the list if we flushed successfully.
1369 *
1370 * So we just keep track of the next pointer in each loop iteration.
1371 */
1374
1375 while (cur)
1376 {
1377 PgStat_EntryRef *entry_ref =
1378 dlist_container(PgStat_EntryRef, pending_node, cur);
1379 PgStat_HashKey key = entry_ref->shared_entry->key;
1380 PgStat_Kind kind = key.kind;
1381 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
1382 bool did_flush;
1384
1385 Assert(!kind_info->fixed_amount);
1386 Assert(kind_info->flush_pending_cb != NULL);
1387
1388 /* flush the stats, if possible */
1389 did_flush = kind_info->flush_pending_cb(entry_ref, nowait);
1390
1391 Assert(did_flush || nowait);
1392
1393 /* determine next entry, before deleting the pending entry */
1396 else
1397 next = NULL;
1398
1399 /* if successfully flushed, remove entry */
1400 if (did_flush)
1401 pgstat_delete_pending_entry(entry_ref);
1402 else
1403 have_pending = true;
1404
1405 cur = next;
1406 }
1407
1408 Assert(dlist_is_empty(&pgStatPending) == !have_pending);
1409
1410 return have_pending;
static int32 next
Definition: blutils.c:224
struct cursor * cur
Definition: ecpg.c:29
static bool dlist_has_next(const dlist_head *head, const dlist_node *node)
Definition: ilist.h:503
static dlist_node * dlist_next_node(dlist_head *head, dlist_node *node)
Definition: ilist.h:537
static dlist_node * dlist_head_node(dlist_head *head)
Definition: ilist.h:565
static bool dlist_is_empty(const dlist_head *head)
Definition: ilist.h:336
#define dlist_container(type, membername, ptr)
Definition: ilist.h:593
void pgstat_delete_pending_entry(PgStat_EntryRef *entry_ref)
Definition: pgstat.c:1334
static dlist_head pgStatPending
Definition: pgstat.c:237
bool(* flush_pending_cb)(PgStat_EntryRef *sr, bool nowait)

References Assert(), cur, dlist_container, dlist_has_next(), dlist_head_node(), dlist_is_empty(), dlist_next_node(), PgStat_KindInfo::fixed_amount, PgStat_KindInfo::flush_pending_cb, PgStatShared_HashEntry::key, sort-test::key, next, pgstat_delete_pending_entry(), pgstat_get_kind_info(), PgStat_Kind, pgStatPending, and PgStat_EntryRef::shared_entry.

Referenced by pgstat_report_stat().

◆ pgstat_force_next_flush()

void pgstat_force_next_flush ( void  )

Definition at line 829 of file pgstat.c.

831{
static bool pgStatForceNextFlush
Definition: pgstat.c:244

References pgStatForceNextFlush.

Referenced by pg_stat_force_next_flush().

◆ pgstat_get_kind_from_str()

PgStat_Kind pgstat_get_kind_from_str ( char *  kind_str)

Definition at line 1419 of file pgstat.c.

1421{
1422 for (PgStat_Kind kind = PGSTAT_KIND_BUILTIN_MIN; kind <= PGSTAT_KIND_BUILTIN_MAX; kind++)
1423 {
1424 if (pg_strcasecmp(kind_str, pgstat_kind_builtin_infos[kind].name) == 0)
1425 return kind;
1426 }
1427
1428 /* Check the custom set of cumulative stats */
1430 {
1431 for (PgStat_Kind kind = PGSTAT_KIND_CUSTOM_MIN; kind <= PGSTAT_KIND_CUSTOM_MAX; kind++)
1432 {
1434
1437 return kind;
1438 }
1439 }
1440
1441 ereport(ERROR,
1442 (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
1443 errmsg("invalid statistics kind: \"%s\"", kind_str)));
1444 return PGSTAT_KIND_INVALID; /* avoid compiler warnings */
uint32_t uint32
Definition: c.h:502
int errcode(int sqlerrcode)
Definition: elog.c:854
#define ERROR
Definition: elog.h:39
static const PgStat_KindInfo ** pgstat_kind_custom_infos
Definition: pgstat.c:491
static const PgStat_KindInfo pgstat_kind_builtin_infos[PGSTAT_KIND_BUILTIN_SIZE]
Definition: pgstat.c:276
#define PGSTAT_KIND_CUSTOM_MAX
Definition: pgstat_kind.h:50
#define PGSTAT_KIND_BUILTIN_MAX
Definition: pgstat_kind.h:43
#define PGSTAT_KIND_INVALID
Definition: pgstat_kind.h:24
#define PGSTAT_KIND_BUILTIN_MIN
Definition: pgstat_kind.h:42
int pg_strcasecmp(const char *s1, const char *s2)
Definition: pgstrcasecmp.c:36
const char * name

References ereport, errcode(), errmsg(), ERROR, idx(), name, pg_strcasecmp(), PgStat_Kind, pgstat_kind_builtin_infos, PGSTAT_KIND_BUILTIN_MAX, PGSTAT_KIND_BUILTIN_MIN, pgstat_kind_custom_infos, PGSTAT_KIND_CUSTOM_MAX, PGSTAT_KIND_CUSTOM_MIN, and PGSTAT_KIND_INVALID.

Referenced by pg_stat_have_stats().

◆ pgstat_get_kind_info()

◆ pgstat_get_stat_snapshot_timestamp()

TimestampTz pgstat_get_stat_snapshot_timestamp ( bool *  have_snapshot)

Definition at line 1045 of file pgstat.c.

1047{
1050
1052 {
1053 *have_snapshot = true;
1055 }
1056
1057 *have_snapshot = false;
1058
1059 return 0;
void pgstat_clear_snapshot(void)
Definition: pgstat.c:917

References force_stats_snapshot_clear, PgStat_Snapshot::mode, pgstat_clear_snapshot(), PGSTAT_FETCH_CONSISTENCY_SNAPSHOT, pgStatLocal, PgStat_LocalState::snapshot, and PgStat_Snapshot::snapshot_timestamp.

Referenced by pg_stat_get_snapshot_timestamp().

◆ pgstat_have_entry()

bool pgstat_have_entry ( PgStat_Kind  kind,
Oid  dboid,
uint64  objid 
)

Definition at line 1062 of file pgstat.c.

1064{
1065 /* fixed-numbered stats always exist */
1066 if (pgstat_get_kind_info(kind)->fixed_amount)
1067 return true;
1068
1069 return pgstat_get_entry_ref(kind, dboid, objid, false, NULL) != NULL;

References pgstat_get_entry_ref(), and pgstat_get_kind_info().

Referenced by pg_stat_have_stats().

◆ pgstat_init_snapshot_fixed()

static void pgstat_init_snapshot_fixed ( void  )
static

Definition at line 1098 of file pgstat.c.

1100{
1101 /*
1102 * Initialize fixed-numbered statistics data in snapshots, only for custom
1103 * stats kinds.
1104 */
1105 for (PgStat_Kind kind = PGSTAT_KIND_CUSTOM_MIN; kind <= PGSTAT_KIND_CUSTOM_MAX; kind++)
1106 {
1107 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
1108
1109 if (!kind_info || !kind_info->fixed_amount)
1110 continue;
1111
1114 }
MemoryContext TopMemoryContext
Definition: mcxt.c:165
void * custom_data[PGSTAT_KIND_CUSTOM_SIZE]

References PgStat_Snapshot::custom_data, PgStat_KindInfo::fixed_amount, MemoryContextAlloc(), pgstat_get_kind_info(), PgStat_Kind, PGSTAT_KIND_CUSTOM_MAX, PGSTAT_KIND_CUSTOM_MIN, pgStatLocal, PgStat_KindInfo::shared_data_len, PgStat_LocalState::snapshot, and TopMemoryContext.

Referenced by pgstat_initialize().

◆ pgstat_initialize()

void pgstat_initialize ( void  )

Definition at line 638 of file pgstat.c.

640{
641 Assert(!pgstat_is_initialized);
642
644
646
647 /* Backend initialization callbacks */
648 for (PgStat_Kind kind = PGSTAT_KIND_MIN; kind <= PGSTAT_KIND_MAX; kind++)
649 {
650 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
651
652 if (kind_info == NULL || kind_info->init_backend_cb == NULL)
653 continue;
654
655 kind_info->init_backend_cb();
656 }
657
658 /* Set up a process-exit hook to clean up */
660
661#ifdef USE_ASSERT_CHECKING
662 pgstat_is_initialized = true;
663#endif
void before_shmem_exit(pg_on_exit_callback function, Datum arg)
Definition: ipc.c:337
static void pgstat_init_snapshot_fixed(void)
Definition: pgstat.c:1098
static void pgstat_shutdown_hook(int code, Datum arg)
Definition: pgstat.c:600
void pgstat_attach_shmem(void)
Definition: pgstat_shmem.c:244
void(* init_backend_cb)(void)

References Assert(), before_shmem_exit(), PgStat_KindInfo::init_backend_cb, pgstat_attach_shmem(), pgstat_get_kind_info(), pgstat_init_snapshot_fixed(), PgStat_Kind, PGSTAT_KIND_MAX, PGSTAT_KIND_MIN, and pgstat_shutdown_hook().

Referenced by BaseInit().

◆ pgstat_is_kind_valid()

static bool pgstat_is_kind_valid ( PgStat_Kind  kind)
inlinestatic

◆ pgstat_prep_pending_entry()

PgStat_EntryRef * pgstat_prep_pending_entry ( PgStat_Kind  kind,
Oid  dboid,
uint64  objid,
bool *  created_entry 
)

Definition at line 1283 of file pgstat.c.

1285{
1286 PgStat_EntryRef *entry_ref;
1287
1288 /* need to be able to flush out */
1289 Assert(pgstat_get_kind_info(kind)->flush_pending_cb != NULL);
1290
1292 {
1295 "PgStat Pending",
1297 }
1298
1299 entry_ref = pgstat_get_entry_ref(kind, dboid, objid,
1300 true, created_entry);
1301
1302 if (entry_ref->pending == NULL)
1303 {
1304 size_t entrysize = pgstat_get_kind_info(kind)->pending_size;
1305
1306 Assert(entrysize != (size_t) -1);
1307
1308 entry_ref->pending = MemoryContextAllocZero(pgStatPendingContext, entrysize);
1310 }
1311
1312 return entry_ref;
#define unlikely(x)
Definition: c.h:347
static void dlist_push_tail(dlist_head *head, dlist_node *node)
Definition: ilist.h:364
void * MemoryContextAllocZero(MemoryContext context, Size size)
Definition: mcxt.c:1290
#define AllocSetContextCreate
Definition: memutils.h:149
#define ALLOCSET_SMALL_SIZES
Definition: memutils.h:190
static MemoryContext pgStatPendingContext
Definition: pgstat.c:229

References ALLOCSET_SMALL_SIZES, AllocSetContextCreate, Assert(), dlist_push_tail(), MemoryContextAllocZero(), PgStat_EntryRef::pending, PgStat_EntryRef::pending_node, PgStat_KindInfo::pending_size, pgstat_get_entry_ref(), pgstat_get_kind_info(), pgStatPending, pgStatPendingContext, TopMemoryContext, and unlikely.

Referenced by pgstat_create_inj(), pgstat_init_function_usage(), pgstat_prep_database_pending(), pgstat_prep_relation_pending(), pgstat_report_inj(), pgstat_report_subscription_conflict(), and pgstat_report_subscription_error().

◆ pgstat_prep_snapshot()

◆ pgstat_read_statsfile()

static void pgstat_read_statsfile ( void  )
static

Definition at line 1770 of file pgstat.c.

1772{
1773 FILE *fpin;
1774 int32 format_id;
1775 bool found;
1776 const char *statfile = PGSTAT_STAT_PERMANENT_FILENAME;
1778
1779 /* shouldn't be called from postmaster */
1781
1782 elog(DEBUG2, "reading stats file \"%s\"", statfile);
1783
1784 /*
1785 * Try to open the stats file. If it doesn't exist, the backends simply
1786 * returns zero for anything and statistics simply starts from scratch
1787 * with empty counters.
1788 *
1789 * ENOENT is a possibility if stats collection was previously disabled or
1790 * has not yet written the stats file for the first time. Any other
1791 * failure condition is suspicious.
1792 */
1793 if ((fpin = AllocateFile(statfile, PG_BINARY_R)) == NULL)
1794 {
1795 if (errno != ENOENT)
1796 ereport(LOG,
1798 errmsg("could not open statistics file \"%s\": %m",
1799 statfile)));
1801 return;
1802 }
1803
1804 /*
1805 * Verify it's of the expected format.
1806 */
1807 if (!read_chunk_s(fpin, &format_id))
1808 {
1809 elog(WARNING, "could not read format ID");
1810 goto error;
1811 }
1812
1813 if (format_id != PGSTAT_FILE_FORMAT_ID)
1814 {
1815 elog(WARNING, "found incorrect format ID %d (expected %d)",
1816 format_id, PGSTAT_FILE_FORMAT_ID);
1817 goto error;
1818 }
1819
1820 /*
1821 * We found an existing statistics file. Read it and put all the stats
1822 * data into place.
1823 */
1824 for (;;)
1825 {
1826 int t = fgetc(fpin);
1827
1828 switch (t)
1829 {
1831 {
1832 PgStat_Kind kind;
1833 const PgStat_KindInfo *info;
1834 char *ptr;
1835
1836 /* entry for fixed-numbered stats */
1837 if (!read_chunk_s(fpin, &kind))
1838 {
1839 elog(WARNING, "could not read stats kind for entry of type %c", t);
1840 goto error;
1841 }
1842
1843 if (!pgstat_is_kind_valid(kind))
1844 {
1845 elog(WARNING, "invalid stats kind %u for entry of type %c",
1846 kind, t);
1847 goto error;
1848 }
1849
1850 info = pgstat_get_kind_info(kind);
1851 if (!info)
1852 {
1853 elog(WARNING, "could not find information of kind %u for entry of type %c",
1854 kind, t);
1855 goto error;
1856 }
1857
1858 if (!info->fixed_amount)
1859 {
1860 elog(WARNING, "invalid fixed_amount in stats kind %u for entry of type %c",
1861 kind, t);
1862 goto error;
1863 }
1864
1865 /* Load back stats into shared memory */
1866 if (pgstat_is_kind_builtin(kind))
1867 ptr = ((char *) shmem) + info->shared_ctl_off +
1868 info->shared_data_off;
1869 else
1870 {
1871 int idx = kind - PGSTAT_KIND_CUSTOM_MIN;
1872
1873 ptr = ((char *) shmem->custom_data[idx]) +
1874 info->shared_data_off;
1875 }
1876
1877 if (!read_chunk(fpin, ptr, info->shared_data_len))
1878 {
1879 elog(WARNING, "could not read data of stats kind %u for entry of type %c with size %u",
1880 kind, t, info->shared_data_len);
1881 goto error;
1882 }
1883
1884 break;
1885 }
1888 {
1891 PgStatShared_Common *header;
1892
1894
1895 if (t == PGSTAT_FILE_ENTRY_HASH)
1896 {
1897 /* normal stats entry, identified by PgStat_HashKey */
1898 if (!read_chunk_s(fpin, &key))
1899 {
1900 elog(WARNING, "could not read key for entry of type %c", t);
1901 goto error;
1902 }
1903
1904 if (!pgstat_is_kind_valid(key.kind))
1905 {
1906 elog(WARNING, "invalid stats kind for entry %u/%u/%" PRIu64 " of type %c",
1907 key.kind, key.dboid,
1908 key.objid, t);
1909 goto error;
1910 }
1911 }
1912 else
1913 {
1914 /* stats entry identified by name on disk (e.g. slots) */
1915 const PgStat_KindInfo *kind_info = NULL;
1916 PgStat_Kind kind;
1917 NameData name;
1918
1919 if (!read_chunk_s(fpin, &kind))
1920 {
1921 elog(WARNING, "could not read stats kind for entry of type %c", t);
1922 goto error;
1923 }
1924 if (!read_chunk_s(fpin, &name))
1925 {
1926 elog(WARNING, "could not read name of stats kind %u for entry of type %c",
1927 kind, t);
1928 goto error;
1929 }
1930 if (!pgstat_is_kind_valid(kind))
1931 {
1932 elog(WARNING, "invalid stats kind %u for entry of type %c",
1933 kind, t);
1934 goto error;
1935 }
1936
1937 kind_info = pgstat_get_kind_info(kind);
1938 if (!kind_info)
1939 {
1940 elog(WARNING, "could not find information of kind %u for entry of type %c",
1941 kind, t);
1942 goto error;
1943 }
1944
1945 if (!kind_info->from_serialized_name)
1946 {
1947 elog(WARNING, "invalid from_serialized_name in stats kind %u for entry of type %c",
1948 kind, t);
1949 goto error;
1950 }
1951
1952 if (!kind_info->from_serialized_name(&name, &key))
1953 {
1954 /* skip over data for entry we don't care about */
1955 if (fseek(fpin, pgstat_get_entry_len(kind), SEEK_CUR) != 0)
1956 {
1957 elog(WARNING, "could not seek \"%s\" of stats kind %u for entry of type %c",
1958 NameStr(name), kind, t);
1959 goto error;
1960 }
1961
1962 continue;
1963 }
1964
1965 Assert(key.kind == kind);
1966 }
1967
1968 /*
1969 * This intentionally doesn't use pgstat_get_entry_ref() -
1970 * putting all stats into checkpointer's
1971 * pgStatEntryRefHash would be wasted effort and memory.
1972 */
1974
1975 /* don't allow duplicate entries */
1976 if (found)
1977 {
1979 elog(WARNING, "found duplicate stats entry %u/%u/%" PRIu64 " of type %c",
1980 key.kind, key.dboid,
1981 key.objid, t);
1982 goto error;
1983 }
1984
1985 header = pgstat_init_entry(key.kind, p);
1987
1988 if (!read_chunk(fpin,
1989 pgstat_get_entry_data(key.kind, header),
1991 {
1992 elog(WARNING, "could not read data for entry %u/%u/%" PRIu64 " of type %c",
1993 key.kind, key.dboid,
1994 key.objid, t);
1995 goto error;
1996 }
1997
1998 break;
1999 }
2001
2002 /*
2003 * check that PGSTAT_FILE_ENTRY_END actually signals end of
2004 * file
2005 */
2006 if (fgetc(fpin) != EOF)
2007 {
2008 elog(WARNING, "could not read end-of-file");
2009 goto error;
2010 }
2011
2012 goto done;
2013
2014 default:
2015 elog(WARNING, "could not read entry of type %c", t);
2016 goto error;
2017 }
2018 }
2019
2020done:
2021 FreeFile(fpin);
2022
2023 elog(DEBUG2, "removing permanent stats file \"%s\"", statfile);
2024 unlink(statfile);
2025
2026 return;
2027
2028error:
2029 ereport(LOG,
2030 (errmsg("corrupted statistics file \"%s\"", statfile)));
2031
2033
2034 goto done;
#define NameStr(name)
Definition: c.h:717
#define PG_BINARY_R
Definition: c.h:1246
int32_t int32
Definition: c.h:498
void dshash_release_lock(dshash_table *hash_table, void *entry)
Definition: dshash.c:558
void * dshash_find_or_insert(dshash_table *hash_table, const void *key, bool *found)
Definition: dshash.c:433
#define WARNING
Definition: elog.h:36
int FreeFile(FILE *file)
Definition: fd.c:2843
FILE * AllocateFile(const char *name, const char *mode)
Definition: fd.c:2644
#define CHECK_FOR_INTERRUPTS()
Definition: miscadmin.h:123
#define PGSTAT_FILE_ENTRY_END
Definition: pgstat.c:143
static bool pgstat_is_kind_valid(PgStat_Kind kind)
Definition: pgstat.c:1447
#define PGSTAT_FILE_ENTRY_HASH
Definition: pgstat.c:146
#define PGSTAT_FILE_ENTRY_FIXED
Definition: pgstat.c:144
static bool read_chunk(FILE *fpin, void *ptr, size_t len)
Definition: pgstat.c:1756
#define read_chunk_s(fpin, ptr)
Definition: pgstat.c:1761
#define PGSTAT_FILE_ENTRY_NAME
Definition: pgstat.c:145
#define PGSTAT_FILE_FORMAT_ID
Definition: pgstat.h:214
static size_t pgstat_get_entry_len(PgStat_Kind kind)
PgStatShared_Common * pgstat_init_entry(PgStat_Kind kind, PgStatShared_HashEntry *shhashent)
Definition: pgstat_shmem.c:293
static void error(void)
Definition: sql-dyntest.c:147
bool(* from_serialized_name)(const NameData *name, PgStat_HashKey *key)
void * custom_data[PGSTAT_KIND_CUSTOM_SIZE]
Definition: c.h:712

References AllocateFile(), Assert(), CHECK_FOR_INTERRUPTS, PgStat_ShmemControl::custom_data, DEBUG2, dshash_find_or_insert(), dshash_release_lock(), elog, ereport, errcode_for_file_access(), errmsg(), error(), PgStat_KindInfo::fixed_amount, FreeFile(), PgStat_KindInfo::from_serialized_name, idx(), IsPostmasterEnvironment, IsUnderPostmaster, sort-test::key, LOG, name, NameStr, PG_BINARY_R, PGSTAT_FILE_ENTRY_END, PGSTAT_FILE_ENTRY_FIXED, PGSTAT_FILE_ENTRY_HASH, PGSTAT_FILE_ENTRY_NAME, PGSTAT_FILE_FORMAT_ID, pgstat_get_entry_data(), pgstat_get_entry_len(), pgstat_get_kind_info(), pgstat_init_entry(), pgstat_is_kind_builtin(), pgstat_is_kind_valid(), PgStat_Kind, PGSTAT_KIND_CUSTOM_MIN, pgstat_reset_after_failure(), PGSTAT_STAT_PERMANENT_FILENAME, pgStatLocal, read_chunk(), read_chunk_s, PgStat_KindInfo::shared_ctl_off, PgStat_KindInfo::shared_data_len, PgStat_KindInfo::shared_data_off, PgStat_LocalState::shared_hash, PgStat_LocalState::shmem, and WARNING.

Referenced by pgstat_restore_stats().

◆ pgstat_register_kind()

void pgstat_register_kind ( PgStat_Kind  kind,
const PgStat_KindInfo kind_info 
)

Definition at line 1481 of file pgstat.c.

1483{
1485
1486 if (kind_info->name == NULL || strlen(kind_info->name) == 0)
1487 ereport(ERROR,
1488 (errmsg("custom cumulative statistics name is invalid"),
1489 errhint("Provide a non-empty name for the custom cumulative statistics.")));
1490
1491 if (!pgstat_is_kind_custom(kind))
1492 ereport(ERROR, (errmsg("custom cumulative statistics ID %u is out of range", kind),
1493 errhint("Provide a custom cumulative statistics ID between %u and %u.",
1495
1497 ereport(ERROR,
1498 (errmsg("failed to register custom cumulative statistics \"%s\" with ID %u", kind_info->name, kind),
1499 errdetail("Custom cumulative statistics must be registered while initializing modules in \"shared_preload_libraries\".")));
1500
1501 /*
1502 * Check some data for fixed-numbered stats.
1503 */
1504 if (kind_info->fixed_amount)
1505 {
1506 if (kind_info->shared_size == 0)
1507 ereport(ERROR,
1508 (errmsg("custom cumulative statistics property is invalid"),
1509 errhint("Custom cumulative statistics require a shared memory size for fixed-numbered objects.")));
1510 }
1511
1512 /*
1513 * If pgstat_kind_custom_infos is not available yet, allocate it.
1514 */
1515 if (pgstat_kind_custom_infos == NULL)
1516 {
1520 }
1521
1522 if (pgstat_kind_custom_infos[idx] != NULL &&
1524 ereport(ERROR,
1525 (errmsg("failed to register custom cumulative statistics \"%s\" with ID %u", kind_info->name, kind),
1526 errdetail("Custom cumulative statistics \"%s\" already registered with the same ID.",
1528
1529 /* check for existing custom stats with the same name */
1530 for (PgStat_Kind existing_kind = PGSTAT_KIND_CUSTOM_MIN; existing_kind <= PGSTAT_KIND_CUSTOM_MAX; existing_kind++)
1531 {
1532 uint32 existing_idx = existing_kind - PGSTAT_KIND_CUSTOM_MIN;
1533
1534 if (pgstat_kind_custom_infos[existing_idx] == NULL)
1535 continue;
1536 if (!pg_strcasecmp(pgstat_kind_custom_infos[existing_idx]->name, kind_info->name))
1537 ereport(ERROR,
1538 (errmsg("failed to register custom cumulative statistics \"%s\" with ID %u", kind_info->name, kind),
1539 errdetail("Existing cumulative statistics with ID %u has the same name.", existing_kind)));
1540 }
1541
1542 /* Register it */
1543 pgstat_kind_custom_infos[idx] = kind_info;
1544 ereport(LOG,
1545 (errmsg("registered custom cumulative statistics \"%s\" with ID %u",
1546 kind_info->name, kind)));
int errdetail(const char *fmt,...)
Definition: elog.c:1204
int errhint(const char *fmt,...)
Definition: elog.c:1318
bool process_shared_preload_libraries_in_progress
Definition: miscinit.c:1837
#define PGSTAT_KIND_CUSTOM_SIZE
Definition: pgstat_kind.h:51
const char *const name

References ereport, errdetail(), errhint(), errmsg(), ERROR, PgStat_KindInfo::fixed_amount, idx(), LOG, MemoryContextAllocZero(), name, PgStat_KindInfo::name, pg_strcasecmp(), pgstat_is_kind_custom(), PgStat_Kind, pgstat_kind_custom_infos, PGSTAT_KIND_CUSTOM_MAX, PGSTAT_KIND_CUSTOM_MIN, PGSTAT_KIND_CUSTOM_SIZE, process_shared_preload_libraries_in_progress, PgStat_KindInfo::shared_size, and TopMemoryContext.

Referenced by pgstat_register_inj(), and pgstat_register_inj_fixed().

◆ pgstat_report_stat()

long pgstat_report_stat ( bool  force)

Definition at line 691 of file pgstat.c.

693{
694 static TimestampTz pending_since = 0;
695 static TimestampTz last_flush = 0;
696 bool partial_flush;
698 bool nowait;
699
702
703 /* "absorb" the forced flush even if there's nothing to flush */
705 {
706 force = true;
707 pgStatForceNextFlush = false;
708 }
709
710 /* Don't expend a clock check if nothing to do */
712 {
713 bool do_flush = false;
714
715 /* Check for pending stats */
716 for (PgStat_Kind kind = PGSTAT_KIND_MIN; kind <= PGSTAT_KIND_MAX; kind++)
717 {
718 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
719
720 if (!kind_info)
721 continue;
722 if (!kind_info->have_static_pending_cb)
723 continue;
724
725 if (kind_info->have_static_pending_cb())
726 {
727 do_flush = true;
728 break;
729 }
730 }
731
732 if (!do_flush)
733 {
734 Assert(pending_since == 0);
735 return 0;
736 }
737 }
738
739 /*
740 * There should never be stats to report once stats are shut down. Can't
741 * assert that before the checks above, as there is an unconditional
742 * pgstat_report_stat() call in pgstat_shutdown_hook() - which at least
743 * the process that ran pgstat_before_server_shutdown() will still call.
744 */
746
747 if (force)
748 {
749 /*
750 * Stats reports are forced either when it's been too long since stats
751 * have been reported or in processes that force stats reporting to
752 * happen at specific points (including shutdown). In the former case
753 * the transaction stop time might be quite old, in the latter it
754 * would never get cleared.
755 */
757 }
758 else
759 {
761
762 if (pending_since > 0 &&
764 {
765 /* don't keep pending updates longer than PGSTAT_MAX_INTERVAL */
766 force = true;
767 }
768 else if (last_flush > 0 &&
770 {
771 /* don't flush too frequently */
772 if (pending_since == 0)
773 pending_since = now;
774
776 }
777 }
778
780
781 /* don't wait for lock acquisition when !force */
782 nowait = !force;
783
784 partial_flush = false;
785
786 /* flush of variable-numbered stats tracked in pending entries list */
787 partial_flush |= pgstat_flush_pending_entries(nowait);
788
789 /* flush of other stats kinds */
790 for (PgStat_Kind kind = PGSTAT_KIND_MIN; kind <= PGSTAT_KIND_MAX; kind++)
791 {
792 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
793
794 if (!kind_info)
795 continue;
796 if (!kind_info->flush_static_cb)
797 continue;
798
799 partial_flush |= kind_info->flush_static_cb(nowait);
800 }
801
802 last_flush = now;
803
804 /*
805 * If some of the pending stats could not be flushed due to lock
806 * contention, let the caller know when to retry.
807 */
808 if (partial_flush)
809 {
810 /* force should have prevented us from getting here */
811 Assert(!force);
812
813 /* remember since when stats have been pending */
814 if (pending_since == 0)
815 pending_since = now;
816
818 }
819
820 pending_since = 0;
821
822 return 0;
bool TimestampDifferenceExceeds(TimestampTz start_time, TimestampTz stop_time, int msec)
Definition: timestamp.c:1781
Datum now(PG_FUNCTION_ARGS)
Definition: timestamp.c:1609
int64 TimestampTz
Definition: timestamp.h:39
#define PGSTAT_MIN_INTERVAL
Definition: pgstat.c:126
static bool pgstat_flush_pending_entries(bool nowait)
Definition: pgstat.c:1357
#define PGSTAT_MAX_INTERVAL
Definition: pgstat.c:128
#define PGSTAT_IDLE_INTERVAL
Definition: pgstat.c:130
void pgstat_update_dbstats(TimestampTz ts)
bool(* flush_static_cb)(bool nowait)
bool(* have_static_pending_cb)(void)
bool IsTransactionOrTransactionBlock(void)
Definition: xact.c:4989
TimestampTz GetCurrentTransactionStopTimestamp(void)
Definition: xact.c:891

References Assert(), dlist_is_empty(), PgStat_KindInfo::flush_static_cb, GetCurrentTimestamp(), GetCurrentTransactionStopTimestamp(), PgStat_KindInfo::have_static_pending_cb, PgStat_ShmemControl::is_shutdown, IsTransactionOrTransactionBlock(), now(), pgstat_assert_is_up, pgstat_flush_pending_entries(), pgstat_get_kind_info(), PGSTAT_IDLE_INTERVAL, PgStat_Kind, PGSTAT_KIND_MAX, PGSTAT_KIND_MIN, PGSTAT_MAX_INTERVAL, PGSTAT_MIN_INTERVAL, pgstat_update_dbstats(), pgStatForceNextFlush, pgStatLocal, pgStatPending, PgStat_LocalState::shmem, and TimestampDifferenceExceeds().

Referenced by AllTablesyncsReady(), apply_handle_commit_internal(), apply_handle_commit_prepared(), apply_handle_prepare(), apply_handle_rollback_prepared(), apply_handle_stream_prepare(), finish_sync_worker(), LogicalRepApplyLoop(), LogicalRepSyncTableStart(), pgstat_before_server_shutdown(), pgstat_shutdown_hook(), PostgresMain(), process_syncing_tables_for_apply(), process_syncing_tables_for_sync(), ProcessInterrupts(), standby_redo(), and worker_spi_main().

◆ pgstat_reset()

void pgstat_reset ( PgStat_Kind  kind,
Oid  dboid,
uint64  objid 
)

Definition at line 869 of file pgstat.c.

871{
872 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
874
875 /* not needed atm, and doesn't make sense with the current signature */
876 Assert(!pgstat_get_kind_info(kind)->fixed_amount);
877
878 /* reset the "single counter" */
879 pgstat_reset_entry(kind, dboid, objid, ts);
880
881 if (!kind_info->accessed_across_databases)
void pgstat_reset_database_timestamp(Oid dboid, TimestampTz ts)
void pgstat_reset_entry(PgStat_Kind kind, Oid dboid, uint64 objid, TimestampTz ts)

References PgStat_KindInfo::accessed_across_databases, Assert(), GetCurrentTimestamp(), pgstat_get_kind_info(), pgstat_reset_database_timestamp(), and pgstat_reset_entry().

Referenced by pg_stat_reset_backend_stats(), pg_stat_reset_single_function_counters(), pg_stat_reset_single_table_counters(), pg_stat_reset_subscription_stats(), pgstat_create_transactional(), and pgstat_reset_replslot().

◆ pgstat_reset_after_failure()

static void pgstat_reset_after_failure ( void  )
static

Definition at line 2041 of file pgstat.c.

2043{
2045
2046 /* reset fixed-numbered stats */
2047 for (PgStat_Kind kind = PGSTAT_KIND_MIN; kind <= PGSTAT_KIND_MAX; kind++)
2048 {
2049 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
2050
2051 if (!kind_info || !kind_info->fixed_amount)
2052 continue;
2053
2054 kind_info->reset_all_cb(ts);
2055 }
2056
2057 /* and drop variable-numbered ones */
void pgstat_drop_all_entries(void)
void(* reset_all_cb)(TimestampTz ts)

References PgStat_KindInfo::fixed_amount, GetCurrentTimestamp(), pgstat_drop_all_entries(), pgstat_get_kind_info(), PgStat_Kind, PGSTAT_KIND_MAX, PGSTAT_KIND_MIN, and PgStat_KindInfo::reset_all_cb.

Referenced by pgstat_discard_stats(), and pgstat_read_statsfile().

◆ pgstat_reset_counters()

void pgstat_reset_counters ( void  )

Definition at line 850 of file pgstat.c.

852{
854
857 ts);
static bool match_db_entries(PgStatShared_HashEntry *entry, Datum match_data)
Definition: pgstat.c:838
void pgstat_reset_matching_entries(bool(*do_reset)(PgStatShared_HashEntry *, Datum), Datum match_data, TimestampTz ts)
static Datum ObjectIdGetDatum(Oid X)
Definition: postgres.h:257

References GetCurrentTimestamp(), match_db_entries(), MyDatabaseId, ObjectIdGetDatum(), and pgstat_reset_matching_entries().

Referenced by pg_stat_reset().

◆ pgstat_reset_of_kind()

void pgstat_reset_of_kind ( PgStat_Kind  kind)

Definition at line 891 of file pgstat.c.

893{
894 const PgStat_KindInfo *kind_info = pgstat_get_kind_info(kind);
896
897 if (kind_info->fixed_amount)
898 kind_info->reset_all_cb(ts);
899 else
void pgstat_reset_entries_of_kind(PgStat_Kind kind, TimestampTz ts)

References PgStat_KindInfo::fixed_amount, GetCurrentTimestamp(), pgstat_get_kind_info(), pgstat_reset_entries_of_kind(), and PgStat_KindInfo::reset_all_cb.

Referenced by pg_stat_reset_replication_slot(), pg_stat_reset_shared(), pg_stat_reset_slru(), and pg_stat_reset_subscription_stats().

◆ pgstat_restore_stats()

void pgstat_restore_stats ( void  )

Definition at line 504 of file pgstat.c.

506{
static void pgstat_read_statsfile(void)
Definition: pgstat.c:1770

References pgstat_read_statsfile().

Referenced by StartupXLOG().

◆ pgstat_shutdown_hook()

static void pgstat_shutdown_hook ( int  code,
Datum  arg 
)
static

Definition at line 600 of file pgstat.c.

602{
603 Assert(!pgstat_is_shutdown);
605
606 /*
607 * If we got as far as discovering our own database ID, we can flush out
608 * what we did so far. Otherwise, we'd be reporting an invalid database
609 * ID, so forget it. (This means that accesses to pg_database during
610 * failed backend starts might never get counted.)
611 */
614
615 pgstat_report_stat(true);
616
617 /* there shouldn't be any pending changes left */
620
621 /* drop the backend stats entry */
624
626
627#ifdef USE_ASSERT_CHECKING
628 pgstat_is_shutdown = true;
629#endif
#define OidIsValid(objectId)
Definition: c.h:746
ProcNumber MyProcNumber
Definition: globals.c:91
static void dlist_init(dlist_head *head)
Definition: ilist.h:314
void pgstat_report_disconnect(Oid dboid)
#define PGSTAT_KIND_BACKEND
Definition: pgstat_kind.h:32
void pgstat_request_entry_refs_gc(void)
Definition: pgstat_shmem.c:709
bool pgstat_drop_entry(PgStat_Kind kind, Oid dboid, uint64 objid)
Definition: pgstat_shmem.c:962
void pgstat_detach_shmem(void)
Definition: pgstat_shmem.c:264

References Assert(), dlist_init(), dlist_is_empty(), InvalidOid, IsPostmasterEnvironment, IsUnderPostmaster, MyDatabaseId, MyProcNumber, OidIsValid, pgstat_detach_shmem(), pgstat_drop_entry(), PGSTAT_KIND_BACKEND, pgstat_report_disconnect(), pgstat_report_stat(), pgstat_request_entry_refs_gc(), and pgStatPending.

Referenced by pgstat_initialize().

◆ pgstat_snapshot_fixed()

◆ pgstat_write_statsfile()

static void pgstat_write_statsfile ( void  )
static

Definition at line 1586 of file pgstat.c.

1588{
1589 FILE *fpout;
1590 int32 format_id;
1591 const char *tmpfile = PGSTAT_STAT_PERMANENT_TMPFILE;
1592 const char *statfile = PGSTAT_STAT_PERMANENT_FILENAME;
1593 dshash_seq_status hstat;
1595
1597
1598 /* should be called only by the checkpointer or single user mode */
1600
1601 /* we're shutting down, so it's ok to just override this */
1603
1604 elog(DEBUG2, "writing stats file \"%s\"", statfile);
1605
1606 /*
1607 * Open the statistics temp file to write out the current values.
1608 */
1609 fpout = AllocateFile(tmpfile, PG_BINARY_W);
1610 if (fpout == NULL)
1611 {
1612 ereport(LOG,
1614 errmsg("could not open temporary statistics file \"%s\": %m",
1615 tmpfile)));
1616 return;
1617 }
1618
1619 /*
1620 * Write the file header --- currently just a format ID.
1621 */
1622 format_id = PGSTAT_FILE_FORMAT_ID;
1623 write_chunk_s(fpout, &format_id);
1624
1625 /* Write various stats structs for fixed number of objects */
1626 for (PgStat_Kind kind = PGSTAT_KIND_MIN; kind <= PGSTAT_KIND_MAX; kind++)
1627 {
1628 char *ptr;
1629 const PgStat_KindInfo *info = pgstat_get_kind_info(kind);
1630
1631 if (!info || !info->fixed_amount)
1632 continue;
1633
1634 if (pgstat_is_kind_builtin(kind))
1635 Assert(info->snapshot_ctl_off != 0);
1636
1637 /* skip if no need to write to file */
1638 if (!info->write_to_file)
1639 continue;
1640
1642 if (pgstat_is_kind_builtin(kind))
1643 ptr = ((char *) &pgStatLocal.snapshot) + info->snapshot_ctl_off;
1644 else
1646
1647 fputc(PGSTAT_FILE_ENTRY_FIXED, fpout);
1648 write_chunk_s(fpout, &kind);
1649 write_chunk(fpout, ptr, info->shared_data_len);
1650 }
1651
1652 /*
1653 * Walk through the stats entries
1654 */
1655 dshash_seq_init(&hstat, pgStatLocal.shared_hash, false);
1656 while ((ps = dshash_seq_next(&hstat)) != NULL)
1657 {
1658 PgStatShared_Common *shstats;
1659 const PgStat_KindInfo *kind_info = NULL;
1660
1662
1663 /*
1664 * We should not see any "dropped" entries when writing the stats
1665 * file, as all backends and auxiliary processes should have cleaned
1666 * up their references before they terminated.
1667 *
1668 * However, since we are already shutting down, it is not worth
1669 * crashing the server over any potential cleanup issues, so we simply
1670 * skip such entries if encountered.
1671 */
1672 Assert(!ps->dropped);
1673 if (ps->dropped)
1674 continue;
1675
1676 /*
1677 * This discards data related to custom stats kinds that are unknown
1678 * to this process.
1679 */
1680 if (!pgstat_is_kind_valid(ps->key.kind))
1681 {
1682 elog(WARNING, "found unknown stats entry %u/%u/%" PRIu64,
1683 ps->key.kind, ps->key.dboid,
1684 ps->key.objid);
1685 continue;
1686 }
1687
1689
1690 kind_info = pgstat_get_kind_info(ps->key.kind);
1691
1692 /* if not dropped the valid-entry refcount should exist */
1693 Assert(pg_atomic_read_u32(&ps->refcount) > 0);
1694
1695 /* skip if no need to write to file */
1696 if (!kind_info->write_to_file)
1697 continue;
1698
1699 if (!kind_info->to_serialized_name)
1700 {
1701 /* normal stats entry, identified by PgStat_HashKey */
1702 fputc(PGSTAT_FILE_ENTRY_HASH, fpout);
1703 write_chunk_s(fpout, &ps->key);
1704 }
1705 else
1706 {
1707 /* stats entry identified by name on disk (e.g. slots) */
1708 NameData name;
1709
1710 kind_info->to_serialized_name(&ps->key, shstats, &name);
1711
1712 fputc(PGSTAT_FILE_ENTRY_NAME, fpout);
1713 write_chunk_s(fpout, &ps->key.kind);
1714 write_chunk_s(fpout, &name);
1715 }
1716
1717 /* Write except the header part of the entry */
1718 write_chunk(fpout,
1719 pgstat_get_entry_data(ps->key.kind, shstats),
1720 pgstat_get_entry_len(ps->key.kind));
1721 }
1722 dshash_seq_term(&hstat);
1723
1724 /*
1725 * No more output to be done. Close the temp file and replace the old
1726 * pgstat.stat with it. The ferror() check replaces testing for error
1727 * after each individual fputc or fwrite (in write_chunk()) above.
1728 */
1729 fputc(PGSTAT_FILE_ENTRY_END, fpout);
1730
1731 if (ferror(fpout))
1732 {
1733 ereport(LOG,
1735 errmsg("could not write temporary statistics file \"%s\": %m",
1736 tmpfile)));
1737 FreeFile(fpout);
1738 unlink(tmpfile);
1739 }
1740 else if (FreeFile(fpout) < 0)
1741 {
1742 ereport(LOG,
1744 errmsg("could not close temporary statistics file \"%s\": %m",
1745 tmpfile)));
1746 unlink(tmpfile);
1747 }
1748 else if (durable_rename(tmpfile, statfile, LOG) < 0)
1749 {
1750 /* durable_rename already emitted log message */
1751 unlink(tmpfile);
1752 }
#define PG_BINARY_W
Definition: c.h:1247
int durable_rename(const char *oldfile, const char *newfile, int elevel)
Definition: fd.c:782
struct parser_state ps
@ B_CHECKPOINTER
Definition: miscadmin.h:363
BackendType MyBackendType
Definition: miscinit.c:64
static void write_chunk(FILE *fpout, void *ptr, size_t len)
Definition: pgstat.c:1569
#define write_chunk_s(fpout, ptr)
Definition: pgstat.c:1579
#define PGSTAT_STAT_PERMANENT_TMPFILE
Definition: pgstat.h:31
void(* to_serialized_name)(const PgStat_HashKey *key, const PgStatShared_Common *header, NameData *name)

References AllocateFile(), Assert(), B_CHECKPOINTER, CHECK_FOR_INTERRUPTS, PgStat_Snapshot::custom_data, DEBUG2, PgStat_LocalState::dsa, dsa_get_address(), dshash_seq_init(), dshash_seq_next(), dshash_seq_term(), durable_rename(), elog, ereport, errcode_for_file_access(), errmsg(), PgStat_KindInfo::fixed_amount, FreeFile(), IsUnderPostmaster, LOG, MyBackendType, name, pg_atomic_read_u32(), PG_BINARY_W, pgstat_assert_is_up, pgstat_build_snapshot_fixed(), pgstat_fetch_consistency, PGSTAT_FETCH_CONSISTENCY_NONE, PGSTAT_FILE_ENTRY_END, PGSTAT_FILE_ENTRY_FIXED, PGSTAT_FILE_ENTRY_HASH, PGSTAT_FILE_ENTRY_NAME, PGSTAT_FILE_FORMAT_ID, pgstat_get_entry_data(), pgstat_get_entry_len(), pgstat_get_kind_info(), pgstat_is_kind_builtin(), pgstat_is_kind_valid(), PgStat_Kind, PGSTAT_KIND_CUSTOM_MIN, PGSTAT_KIND_MAX, PGSTAT_KIND_MIN, PGSTAT_STAT_PERMANENT_FILENAME, PGSTAT_STAT_PERMANENT_TMPFILE, pgStatLocal, ps, PgStat_KindInfo::shared_data_len, PgStat_LocalState::shared_hash, PgStat_LocalState::snapshot, PgStat_KindInfo::snapshot_ctl_off, PgStat_KindInfo::to_serialized_name, WARNING, write_chunk(), write_chunk_s, and PgStat_KindInfo::write_to_file.

Referenced by pgstat_before_server_shutdown().

◆ read_chunk()

static bool read_chunk ( FILE *  fpin,
void *  ptr,
size_t  len 
)
static

Definition at line 1756 of file pgstat.c.

1758{
1759 return fread(ptr, 1, len, fpin) == len;
const void size_t len

References len.

Referenced by pgstat_read_statsfile().

◆ write_chunk()

static void write_chunk ( FILE *  fpout,
void *  ptr,
size_t  len 
)
static

Definition at line 1569 of file pgstat.c.

1571{
1572 int rc;
1573
1574 rc = fwrite(ptr, len, 1, fpout);
1575
1576 /* we'll check for errors with ferror once at the end */
1577 (void) rc;

References len.

Referenced by pgstat_write_statsfile().

Variable Documentation

◆ force_stats_snapshot_clear

◆ pgstat_fetch_consistency

◆ pgstat_kind_builtin_infos

const PgStat_KindInfo pgstat_kind_builtin_infos[PGSTAT_KIND_BUILTIN_SIZE]
static

Definition at line 276 of file pgstat.c.

Referenced by pgstat_get_kind_from_str(), and pgstat_get_kind_info().

◆ pgstat_kind_custom_infos

const PgStat_KindInfo** pgstat_kind_custom_infos = NULL
static

Definition at line 491 of file pgstat.c.

Referenced by pgstat_get_kind_from_str(), pgstat_get_kind_info(), and pgstat_register_kind().

◆ pgstat_track_counts

◆ pgStatForceNextFlush

bool pgStatForceNextFlush = false
static

Definition at line 244 of file pgstat.c.

Referenced by pgstat_force_next_flush(), and pgstat_report_stat().

◆ pgStatLocal

PgStat_LocalState pgStatLocal

Definition at line 212 of file pgstat.c.

Referenced by pgstat_acquire_entry_ref(), pgstat_archiver_reset_all_cb(), pgstat_archiver_snapshot_cb(), pgstat_attach_shmem(), pgstat_before_server_shutdown(), pgstat_bgwriter_reset_all_cb(), pgstat_bgwriter_snapshot_cb(), pgstat_build_snapshot(), pgstat_build_snapshot_fixed(), pgstat_checkpointer_reset_all_cb(), pgstat_checkpointer_snapshot_cb(), pgstat_clear_snapshot(), pgstat_detach_shmem(), pgstat_drop_database_and_contents(), pgstat_drop_entry(), pgstat_drop_entry_internal(), pgstat_drop_matching_entries(), pgstat_fetch_entry(), pgstat_fetch_slru(), pgstat_fetch_stat_archiver(), pgstat_fetch_stat_bgwriter(), pgstat_fetch_stat_checkpointer(), pgstat_fetch_stat_io(), pgstat_fetch_stat_wal(), pgstat_free_entry(), pgstat_gc_entry_refs(), pgstat_get_custom_shmem_data(), pgstat_get_custom_snapshot_data(), pgstat_get_entry_ref(), pgstat_get_stat_snapshot_timestamp(), pgstat_init_entry(), pgstat_init_snapshot_fixed(), pgstat_io_flush_cb(), pgstat_io_reset_all_cb(), pgstat_io_snapshot_cb(), pgstat_need_entry_refs_gc(), pgstat_prep_snapshot(), pgstat_read_statsfile(), pgstat_reinit_entry(), pgstat_release_entry_ref(), pgstat_report_archiver(), pgstat_report_bgwriter(), pgstat_report_checkpointer(), pgstat_report_stat(), pgstat_request_entry_refs_gc(), pgstat_reset_matching_entries(), pgstat_reset_slru_counter_internal(), pgstat_setup_shared_refs(), pgstat_slru_flush_cb(), pgstat_slru_snapshot_cb(), pgstat_snapshot_fixed(), pgstat_wal_flush_cb(), pgstat_wal_reset_all_cb(), pgstat_wal_snapshot_cb(), pgstat_write_statsfile(), and StatsShmemInit().

◆ pgStatPending

dlist_head pgStatPending = DLIST_STATIC_INIT(pgStatPending)
static

◆ pgStatPendingContext

MemoryContext pgStatPendingContext = NULL
static

Definition at line 229 of file pgstat.c.

Referenced by pgstat_prep_pending_entry().