PostgreSQL Source Code  git master
pgstat_checkpointer.c
Go to the documentation of this file.
1 /* -------------------------------------------------------------------------
2  *
3  * pgstat_checkpointer.c
4  * Implementation of checkpoint statistics.
5  *
6  * This file contains the implementation of checkpoint statistics. It is kept
7  * separate from pgstat.c to enforce the line between the statistics access /
8  * storage implementation and the details about individual types of
9  * statistics.
10  *
11  * Copyright (c) 2001-2023, PostgreSQL Global Development Group
12  *
13  * IDENTIFICATION
14  * src/backend/utils/activity/pgstat_checkpointer.c
15  * -------------------------------------------------------------------------
16  */
17 
18 #include "postgres.h"
19 
20 #include "utils/pgstat_internal.h"
21 
22 
24 
25 
26 /*
27  * Report checkpointer and IO statistics
28  */
29 void
31 {
32  /* We assume this initializes to zeroes */
33  static const PgStat_CheckpointerStats all_zeroes;
35 
38 
39  /*
40  * This function can be called even if nothing at all has happened. In
41  * this case, avoid unnecessarily modifying the stats entry.
42  */
43  if (memcmp(&PendingCheckpointerStats, &all_zeroes,
44  sizeof(all_zeroes)) == 0)
45  return;
46 
48 
49 #define CHECKPOINTER_ACC(fld) stats_shmem->stats.fld += PendingCheckpointerStats.fld
50  CHECKPOINTER_ACC(timed_checkpoints);
51  CHECKPOINTER_ACC(requested_checkpoints);
52  CHECKPOINTER_ACC(checkpoint_write_time);
53  CHECKPOINTER_ACC(checkpoint_sync_time);
54  CHECKPOINTER_ACC(buf_written_checkpoints);
55  CHECKPOINTER_ACC(buf_written_backend);
56  CHECKPOINTER_ACC(buf_fsync_backend);
57 #undef CHECKPOINTER_ACC
58 
60 
61  /*
62  * Clear out the statistics buffer, so it can be re-used.
63  */
65 
66  /*
67  * Report IO statistics
68  */
69  pgstat_flush_io(false);
70 }
71 
72 /*
73  * pgstat_fetch_stat_checkpointer() -
74  *
75  * Support function for the SQL-callable pgstat* functions. Returns
76  * a pointer to the checkpointer statistics struct.
77  */
80 {
82 
84 }
85 
86 void
88 {
90 
91  /* see explanation above PgStatShared_Checkpointer for the reset protocol */
92  LWLockAcquire(&stats_shmem->lock, LW_EXCLUSIVE);
94  &stats_shmem->stats,
95  sizeof(stats_shmem->stats),
96  &stats_shmem->changecount);
97  LWLockRelease(&stats_shmem->lock);
98 }
99 
100 void
102 {
104  PgStat_CheckpointerStats *reset_offset = &stats_shmem->reset_offset;
106 
108  &stats_shmem->stats,
109  sizeof(stats_shmem->stats),
110  &stats_shmem->changecount);
111 
112  LWLockAcquire(&stats_shmem->lock, LW_SHARED);
113  memcpy(&reset, reset_offset, sizeof(stats_shmem->stats));
114  LWLockRelease(&stats_shmem->lock);
115 
116  /* compensate by reset offsets */
117 #define CHECKPOINTER_COMP(fld) pgStatLocal.snapshot.checkpointer.fld -= reset.fld;
118  CHECKPOINTER_COMP(timed_checkpoints);
119  CHECKPOINTER_COMP(requested_checkpoints);
120  CHECKPOINTER_COMP(checkpoint_write_time);
121  CHECKPOINTER_COMP(checkpoint_sync_time);
122  CHECKPOINTER_COMP(buf_written_checkpoints);
123  CHECKPOINTER_COMP(buf_written_backend);
124  CHECKPOINTER_COMP(buf_fsync_backend);
125 #undef CHECKPOINTER_COMP
126 }
#define MemSet(start, val, len)
Definition: c.h:1009
int64 TimestampTz
Definition: timestamp.h:39
Assert(fmt[strlen(fmt) - 1] !='\n')
bool LWLockAcquire(LWLock *lock, LWLockMode mode)
Definition: lwlock.c:1195
void LWLockRelease(LWLock *lock)
Definition: lwlock.c:1808
@ LW_SHARED
Definition: lwlock.h:117
@ LW_EXCLUSIVE
Definition: lwlock.h:116
void pgstat_snapshot_fixed(PgStat_Kind kind)
Definition: pgstat.c:941
PgStat_LocalState pgStatLocal
Definition: pgstat.c:196
@ PGSTAT_KIND_CHECKPOINTER
Definition: pgstat.h:50
void pgstat_checkpointer_snapshot_cb(void)
#define CHECKPOINTER_COMP(fld)
void pgstat_report_checkpointer(void)
void pgstat_checkpointer_reset_all_cb(TimestampTz ts)
PgStat_CheckpointerStats PendingCheckpointerStats
PgStat_CheckpointerStats * pgstat_fetch_stat_checkpointer(void)
#define CHECKPOINTER_ACC(fld)
static void pgstat_end_changecount_write(uint32 *cc)
#define pgstat_assert_is_up()
static void pgstat_begin_changecount_write(uint32 *cc)
static void pgstat_copy_changecounted_stats(void *dst, void *src, size_t len, uint32 *cc)
bool pgstat_flush_io(bool nowait)
Definition: pgstat_io.c:159
void reset(void)
Definition: sql-declare.c:600
PgStat_CheckpointerStats reset_offset
PgStat_CheckpointerStats stats
PgStat_Snapshot snapshot
PgStat_ShmemControl * shmem
PgStatShared_Checkpointer checkpointer
PgStat_CheckpointerStats checkpointer