mirror of
https://git.postgresql.org/git/postgresql.git
synced 2024-09-03 14:57:19 +02:00
0914ae1c14
Per recent discussion, this seems to be making the stats less accurate rather than more so, particularly on Windows where PID values may be reused very quickly. Patch by Peter Brant.
491 lines
12 KiB
C
491 lines
12 KiB
C
/* ----------
|
|
* pgstat.h
|
|
*
|
|
* Definitions for the PostgreSQL statistics collector daemon.
|
|
*
|
|
* Copyright (c) 2001-2006, PostgreSQL Global Development Group
|
|
*
|
|
* $PostgreSQL: pgsql/src/include/pgstat.h,v 1.43 2006/04/06 20:38:00 tgl Exp $
|
|
* ----------
|
|
*/
|
|
#ifndef PGSTAT_H
|
|
#define PGSTAT_H
|
|
|
|
#include "libpq/pqcomm.h"
|
|
#include "utils/hsearch.h"
|
|
#include "utils/rel.h"
|
|
#include "utils/timestamp.h"
|
|
|
|
/* ----------
|
|
* The types of backend/postmaster -> collector messages
|
|
* ----------
|
|
*/
|
|
typedef enum StatMsgType
|
|
{
|
|
PGSTAT_MTYPE_DUMMY,
|
|
PGSTAT_MTYPE_BESTART,
|
|
PGSTAT_MTYPE_BETERM,
|
|
PGSTAT_MTYPE_ACTIVITY,
|
|
PGSTAT_MTYPE_TABSTAT,
|
|
PGSTAT_MTYPE_TABPURGE,
|
|
PGSTAT_MTYPE_DROPDB,
|
|
PGSTAT_MTYPE_RESETCOUNTER,
|
|
PGSTAT_MTYPE_AUTOVAC_START,
|
|
PGSTAT_MTYPE_VACUUM,
|
|
PGSTAT_MTYPE_ANALYZE
|
|
} StatMsgType;
|
|
|
|
/* ----------
|
|
* The data type used for counters.
|
|
* ----------
|
|
*/
|
|
typedef int64 PgStat_Counter;
|
|
|
|
|
|
/* ------------------------------------------------------------
|
|
* Message formats follow
|
|
* ------------------------------------------------------------
|
|
*/
|
|
|
|
|
|
/* ----------
|
|
* PgStat_MsgHdr The common message header
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_MsgHdr
|
|
{
|
|
StatMsgType m_type;
|
|
int m_size;
|
|
int m_backendid;
|
|
int m_procpid;
|
|
} PgStat_MsgHdr;
|
|
|
|
/* ----------
|
|
* Space available in a message. This will keep the UDP packets below 1K,
|
|
* which should fit unfragmented into the MTU of the lo interface on most
|
|
* platforms. Does anybody care for platforms where it doesn't?
|
|
* ----------
|
|
*/
|
|
#define PGSTAT_MSG_PAYLOAD (1000 - sizeof(PgStat_MsgHdr))
|
|
|
|
/* ----------
|
|
* PgStat_TableEntry Per-table info in a MsgTabstat
|
|
*
|
|
* Note: for a table, tuples_returned is the number of tuples successfully
|
|
* fetched by heap_getnext, while tuples_fetched is the number of tuples
|
|
* successfully fetched by heap_fetch under the control of bitmap indexscans.
|
|
* For an index, tuples_returned is the number of index entries returned by
|
|
* the index AM, while tuples_fetched is the number of tuples successfully
|
|
* fetched by heap_fetch under the control of simple indexscans for this index.
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_TableEntry
|
|
{
|
|
Oid t_id;
|
|
|
|
PgStat_Counter t_numscans;
|
|
|
|
PgStat_Counter t_tuples_returned;
|
|
PgStat_Counter t_tuples_fetched;
|
|
|
|
PgStat_Counter t_tuples_inserted;
|
|
PgStat_Counter t_tuples_updated;
|
|
PgStat_Counter t_tuples_deleted;
|
|
|
|
PgStat_Counter t_blocks_fetched;
|
|
PgStat_Counter t_blocks_hit;
|
|
} PgStat_TableEntry;
|
|
|
|
|
|
/* ----------
|
|
* PgStat_MsgDummy A dummy message, ignored by the collector
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_MsgDummy
|
|
{
|
|
PgStat_MsgHdr m_hdr;
|
|
char m_dummy[512];
|
|
} PgStat_MsgDummy;
|
|
|
|
/* ----------
|
|
* PgStat_MsgBestart Sent by the backend on startup
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_MsgBestart
|
|
{
|
|
PgStat_MsgHdr m_hdr;
|
|
Oid m_databaseid;
|
|
Oid m_userid;
|
|
SockAddr m_clientaddr;
|
|
} PgStat_MsgBestart;
|
|
|
|
/* ----------
|
|
* PgStat_MsgBeterm Sent by the postmaster after backend exit
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_MsgBeterm
|
|
{
|
|
PgStat_MsgHdr m_hdr;
|
|
} PgStat_MsgBeterm;
|
|
|
|
/* ----------
|
|
* PgStat_MsgAutovacStart Sent by the autovacuum daemon to signal
|
|
* that a database is going to be processed
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_MsgAutovacStart
|
|
{
|
|
PgStat_MsgHdr m_hdr;
|
|
Oid m_databaseid;
|
|
TimestampTz m_start_time;
|
|
} PgStat_MsgAutovacStart;
|
|
|
|
/* ----------
|
|
* PgStat_MsgVacuum Sent by the backend or autovacuum daemon
|
|
* after VACUUM or VACUUM ANALYZE
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_MsgVacuum
|
|
{
|
|
PgStat_MsgHdr m_hdr;
|
|
Oid m_databaseid;
|
|
Oid m_tableoid;
|
|
bool m_analyze;
|
|
PgStat_Counter m_tuples;
|
|
} PgStat_MsgVacuum;
|
|
|
|
/* ----------
|
|
* PgStat_MsgAnalyze Sent by the backend or autovacuum daemon
|
|
* after ANALYZE
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_MsgAnalyze
|
|
{
|
|
PgStat_MsgHdr m_hdr;
|
|
Oid m_databaseid;
|
|
Oid m_tableoid;
|
|
PgStat_Counter m_live_tuples;
|
|
PgStat_Counter m_dead_tuples;
|
|
} PgStat_MsgAnalyze;
|
|
|
|
|
|
/* ----------
|
|
* PgStat_MsgActivity Sent by the backends when they start
|
|
* to parse a query.
|
|
* ----------
|
|
*/
|
|
#define PGSTAT_ACTIVITY_SIZE PGSTAT_MSG_PAYLOAD
|
|
|
|
typedef struct PgStat_MsgActivity
|
|
{
|
|
PgStat_MsgHdr m_hdr;
|
|
char m_cmd_str[PGSTAT_ACTIVITY_SIZE];
|
|
} PgStat_MsgActivity;
|
|
|
|
/* ----------
|
|
* PgStat_MsgTabstat Sent by the backend to report table
|
|
* and buffer access statistics.
|
|
* ----------
|
|
*/
|
|
#define PGSTAT_NUM_TABENTRIES \
|
|
((PGSTAT_MSG_PAYLOAD - sizeof(Oid) - 3 * sizeof(int)) \
|
|
/ sizeof(PgStat_TableEntry))
|
|
|
|
typedef struct PgStat_MsgTabstat
|
|
{
|
|
PgStat_MsgHdr m_hdr;
|
|
Oid m_databaseid;
|
|
int m_nentries;
|
|
int m_xact_commit;
|
|
int m_xact_rollback;
|
|
PgStat_TableEntry m_entry[PGSTAT_NUM_TABENTRIES];
|
|
} PgStat_MsgTabstat;
|
|
|
|
/* ----------
|
|
* PgStat_MsgTabpurge Sent by the backend to tell the collector
|
|
* about dead tables.
|
|
* ----------
|
|
*/
|
|
#define PGSTAT_NUM_TABPURGE \
|
|
((PGSTAT_MSG_PAYLOAD - sizeof(Oid) - sizeof(int)) \
|
|
/ sizeof(Oid))
|
|
|
|
typedef struct PgStat_MsgTabpurge
|
|
{
|
|
PgStat_MsgHdr m_hdr;
|
|
Oid m_databaseid;
|
|
int m_nentries;
|
|
Oid m_tableid[PGSTAT_NUM_TABPURGE];
|
|
} PgStat_MsgTabpurge;
|
|
|
|
|
|
/* ----------
|
|
* PgStat_MsgDropdb Sent by the backend to tell the collector
|
|
* about a dropped database
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_MsgDropdb
|
|
{
|
|
PgStat_MsgHdr m_hdr;
|
|
Oid m_databaseid;
|
|
} PgStat_MsgDropdb;
|
|
|
|
|
|
/* ----------
|
|
* PgStat_MsgResetcounter Sent by the backend to tell the collector
|
|
* to reset counters
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_MsgResetcounter
|
|
{
|
|
PgStat_MsgHdr m_hdr;
|
|
Oid m_databaseid;
|
|
} PgStat_MsgResetcounter;
|
|
|
|
|
|
/* ----------
|
|
* PgStat_Msg Union over all possible messages.
|
|
* ----------
|
|
*/
|
|
typedef union PgStat_Msg
|
|
{
|
|
PgStat_MsgHdr msg_hdr;
|
|
PgStat_MsgDummy msg_dummy;
|
|
PgStat_MsgBestart msg_bestart;
|
|
PgStat_MsgActivity msg_activity;
|
|
PgStat_MsgTabstat msg_tabstat;
|
|
PgStat_MsgTabpurge msg_tabpurge;
|
|
PgStat_MsgDropdb msg_dropdb;
|
|
PgStat_MsgResetcounter msg_resetcounter;
|
|
PgStat_MsgAutovacStart msg_autovacuum;
|
|
PgStat_MsgVacuum msg_vacuum;
|
|
PgStat_MsgAnalyze msg_analyze;
|
|
} PgStat_Msg;
|
|
|
|
|
|
/* ------------------------------------------------------------
|
|
* Statistic collector data structures follow
|
|
*
|
|
* PGSTAT_FILE_FORMAT_ID should be changed whenever any of these
|
|
* data structures change.
|
|
* ------------------------------------------------------------
|
|
*/
|
|
|
|
#define PGSTAT_FILE_FORMAT_ID 0x01A5BC95
|
|
|
|
/* ----------
|
|
* PgStat_StatDBEntry The collector's data per database
|
|
*
|
|
* Note: n_backends is not maintained within the collector. It's computed
|
|
* when a backend reads the stats file for use.
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_StatDBEntry
|
|
{
|
|
Oid databaseid;
|
|
int n_backends;
|
|
PgStat_Counter n_xact_commit;
|
|
PgStat_Counter n_xact_rollback;
|
|
PgStat_Counter n_blocks_fetched;
|
|
PgStat_Counter n_blocks_hit;
|
|
TimestampTz last_autovac_time;
|
|
|
|
/*
|
|
* tables must be last in the struct, because we don't write the pointer
|
|
* out to the stats file.
|
|
*/
|
|
HTAB *tables;
|
|
} PgStat_StatDBEntry;
|
|
|
|
|
|
/* ----------
|
|
* PgStat_StatBeEntry The collector's data per backend
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_StatBeEntry
|
|
{
|
|
/* An entry is non-empty iff procpid > 0 */
|
|
int procpid;
|
|
TimestampTz start_timestamp;
|
|
TimestampTz activity_start_timestamp;
|
|
|
|
/*
|
|
* These fields are initialized by the BESTART message. If we have
|
|
* received messages from a backend before we have received its BESTART,
|
|
* these fields will be uninitialized: userid and databaseid will be
|
|
* InvalidOid, and clientaddr will be undefined.
|
|
*/
|
|
Oid userid;
|
|
Oid databaseid;
|
|
SockAddr clientaddr;
|
|
|
|
/*
|
|
* activity[] must be last in the struct, because we only write as much
|
|
* of it as needed to the stats file.
|
|
*/
|
|
char activity[PGSTAT_ACTIVITY_SIZE];
|
|
} PgStat_StatBeEntry;
|
|
|
|
|
|
/* ----------
|
|
* PgStat_StatTabEntry The collector's data per table (or index)
|
|
* ----------
|
|
*/
|
|
typedef struct PgStat_StatTabEntry
|
|
{
|
|
Oid tableid;
|
|
|
|
PgStat_Counter numscans;
|
|
|
|
PgStat_Counter tuples_returned;
|
|
PgStat_Counter tuples_fetched;
|
|
|
|
PgStat_Counter tuples_inserted;
|
|
PgStat_Counter tuples_updated;
|
|
PgStat_Counter tuples_deleted;
|
|
|
|
PgStat_Counter n_live_tuples;
|
|
PgStat_Counter n_dead_tuples;
|
|
PgStat_Counter last_anl_tuples;
|
|
|
|
PgStat_Counter blocks_fetched;
|
|
PgStat_Counter blocks_hit;
|
|
} PgStat_StatTabEntry;
|
|
|
|
|
|
/* ----------
|
|
* GUC parameters
|
|
* ----------
|
|
*/
|
|
extern bool pgstat_collect_startcollector;
|
|
extern bool pgstat_collect_resetonpmstart;
|
|
extern bool pgstat_collect_querystring;
|
|
extern bool pgstat_collect_tuplelevel;
|
|
extern bool pgstat_collect_blocklevel;
|
|
|
|
|
|
/* ----------
|
|
* Functions called from postmaster
|
|
* ----------
|
|
*/
|
|
extern void pgstat_init(void);
|
|
extern int pgstat_start(void);
|
|
extern void pgstat_beterm(int pid);
|
|
extern void pgstat_reset_all(void);
|
|
|
|
#ifdef EXEC_BACKEND
|
|
extern void PgstatBufferMain(int argc, char *argv[]);
|
|
extern void PgstatCollectorMain(int argc, char *argv[]);
|
|
#endif
|
|
|
|
|
|
/* ----------
|
|
* Functions called from backends
|
|
* ----------
|
|
*/
|
|
extern void pgstat_bestart(void);
|
|
|
|
extern void pgstat_ping(void);
|
|
extern void pgstat_report_activity(const char *what);
|
|
extern void pgstat_report_tabstat(void);
|
|
extern void pgstat_report_autovac(Oid dboid);
|
|
extern void pgstat_report_vacuum(Oid tableoid, bool shared,
|
|
bool analyze, PgStat_Counter tuples);
|
|
extern void pgstat_report_analyze(Oid tableoid, bool shared,
|
|
PgStat_Counter livetuples,
|
|
PgStat_Counter deadtuples);
|
|
extern void pgstat_vacuum_tabstat(void);
|
|
extern void pgstat_drop_relation(Oid relid);
|
|
|
|
extern void pgstat_reset_counters(void);
|
|
|
|
extern void pgstat_initstats(PgStat_Info *stats, Relation rel);
|
|
|
|
|
|
#define pgstat_count_heap_scan(s) \
|
|
do { \
|
|
if (pgstat_collect_tuplelevel && (s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_numscans++; \
|
|
} while (0)
|
|
/* kluge for bitmap scans: */
|
|
#define pgstat_discount_heap_scan(s) \
|
|
do { \
|
|
if (pgstat_collect_tuplelevel && (s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_numscans--; \
|
|
} while (0)
|
|
#define pgstat_count_heap_getnext(s) \
|
|
do { \
|
|
if (pgstat_collect_tuplelevel && (s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_tuples_returned++; \
|
|
} while (0)
|
|
#define pgstat_count_heap_fetch(s) \
|
|
do { \
|
|
if (pgstat_collect_tuplelevel && (s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_tuples_fetched++; \
|
|
} while (0)
|
|
#define pgstat_count_heap_insert(s) \
|
|
do { \
|
|
if (pgstat_collect_tuplelevel && (s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_tuples_inserted++; \
|
|
} while (0)
|
|
#define pgstat_count_heap_update(s) \
|
|
do { \
|
|
if (pgstat_collect_tuplelevel && (s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_tuples_updated++; \
|
|
} while (0)
|
|
#define pgstat_count_heap_delete(s) \
|
|
do { \
|
|
if (pgstat_collect_tuplelevel && (s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_tuples_deleted++; \
|
|
} while (0)
|
|
#define pgstat_count_index_scan(s) \
|
|
do { \
|
|
if (pgstat_collect_tuplelevel && (s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_numscans++; \
|
|
} while (0)
|
|
#define pgstat_count_index_tuples(s, n) \
|
|
do { \
|
|
if (pgstat_collect_tuplelevel && (s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_tuples_returned += (n); \
|
|
} while (0)
|
|
#define pgstat_count_buffer_read(s,r) \
|
|
do { \
|
|
if (pgstat_collect_blocklevel) { \
|
|
if ((s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_blocks_fetched++; \
|
|
else { \
|
|
pgstat_initstats((s), (r)); \
|
|
if ((s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_blocks_fetched++; \
|
|
} \
|
|
} \
|
|
} while (0)
|
|
#define pgstat_count_buffer_hit(s,r) \
|
|
do { \
|
|
if (pgstat_collect_blocklevel) { \
|
|
if ((s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_blocks_hit++; \
|
|
else { \
|
|
pgstat_initstats((s), (r)); \
|
|
if ((s)->tabentry != NULL) \
|
|
((PgStat_TableEntry *)((s)->tabentry))->t_blocks_hit++; \
|
|
} \
|
|
} \
|
|
} while (0)
|
|
|
|
|
|
extern void pgstat_count_xact_commit(void);
|
|
extern void pgstat_count_xact_rollback(void);
|
|
|
|
/* ----------
|
|
* Support functions for the SQL-callable functions to
|
|
* generate the pgstat* views.
|
|
* ----------
|
|
*/
|
|
extern PgStat_StatDBEntry *pgstat_fetch_stat_dbentry(Oid dbid);
|
|
extern PgStat_StatTabEntry *pgstat_fetch_stat_tabentry(Oid relid);
|
|
extern PgStat_StatBeEntry *pgstat_fetch_stat_beentry(int beid);
|
|
extern int pgstat_fetch_stat_numbackends(void);
|
|
|
|
#endif /* PGSTAT_H */
|