This patch updates pg_autovacuum in several ways:
* A few bug fixes * fixes solaris compile and crash issue * decouple vacuum analyze and analyze thresholds * detach from tty (dameonize) * improved logging layout * more conservative default configuration * improved, expanded and updated README please apply and 1st convenience, or before code freeze which ever comes first :-) At this point I think I have brought pg_autovacuum and its client side design as far as I think it should go. It works, keeping file sizes in check, helps performance and give the administrator a fair amount flexibility in configuring it. Next up is to do the FSM based design that is integrated into the back end. p.s. Thanks to Christopher Browne for his help. Matthew T. O'Connor
This commit is contained in:
Bruce Momjian
parent
4e1f986098
commit
9243664dd4
@ -1,80 +1,156 @@
|
||||
pg_autovacuum README
|
||||
--------------------
|
||||
|
||||
pg_autovacuum is a libpq client program that monitors all the databases of a
|
||||
postgresql server. It uses the stats collector to monitor insert, update and
|
||||
delete activity. When an individual table exceeds it's insert or delete
|
||||
threshold (more detail on thresholds below) then that table is vacuumed or
|
||||
analyzed. This allows postgresql to keep the fsm and table statistics up to
|
||||
date without having to schedule periodic vacuums with cron regardless of need.
|
||||
pg_autovacuum is a libpq client program that monitors all the
|
||||
databases associated with a postgresql server. It uses the stats
|
||||
collector to monitor insert, update and delete activity.
|
||||
|
||||
The primary benefit of pg_autovacuum is that the FSM and table statistic information
|
||||
are updated as needed. When a table is actively changed pg_autovacuum performs the
|
||||
necessary vacuums and analyzes, when a table is inactive, no cycles are wasted
|
||||
performing vacuums and analyzes that are not needed.
|
||||
When a table exceeds its insert or delete threshold (more detail
|
||||
on thresholds below) then that table will be vacuumed or analyzed.
|
||||
|
||||
This allows postgresql to keep the fsm and table statistics up to
|
||||
date, and eliminates the need to schedule periodic vacuums.
|
||||
|
||||
The primary benefit of pg_autovacuum is that the FSM and table
|
||||
statistic information are updated as needed. When a table is actively
|
||||
changing, pg_autovacuum will perform the necessary vacuums and
|
||||
analyzes, whereas if a table remains static, no cycles will be wasted
|
||||
performing unnecessary vacuums/analyzes.
|
||||
|
||||
A secondary benefit of pg_autovacuum is that it ensures that a
|
||||
database wide vacuum is performed prior to xid wraparound. This is an
|
||||
important, if rare, problem, as failing to do so can result in major
|
||||
data loss.
|
||||
|
||||
|
||||
KNOWN ISSUES:
|
||||
-------------
|
||||
pg_autovacuum has been tested under Redhat Linux (by me) and Solaris (by
|
||||
Christopher B. Browne) and all known bugs have been resolved. Please report
|
||||
any problems to the hackers list.
|
||||
|
||||
pg_autovacuum does not get started automatically by either the postmaster or
|
||||
by pg_ctl. Along the sames lines, when the postmaster exits no one tells
|
||||
pg_autovacuum. The result is that at the start of the next loop,
|
||||
pg_autovacuum fails to connect to the server and exits. Any time it fails
|
||||
to connect pg_autovacuum exits.
|
||||
|
||||
pg_autovacuum requires that the stats system be enabled and reporting row
|
||||
level stats. The overhead of the stats system has been shown to be
|
||||
significant under certain workloads. For instance a tight loop of queries
|
||||
performing "select 1" was nearly 30% slower with stats enabled. However,
|
||||
in practice with more realistic workloads, the stats system overhead is
|
||||
usually nominal.
|
||||
|
||||
A secondary benefit of pg_autovacuum is that it guarantees that a database wide
|
||||
vacuum is performed prior to xid wraparound. This is important as failing to do
|
||||
so can result in major data loss.
|
||||
|
||||
INSTALL:
|
||||
To use pg_autovacuum, uncompress the tar.gz into the contrib directory and modify the
|
||||
contrib/Makefile to include the pg_autovacuum directory. pg_autovacuum will then be made as
|
||||
part of the standard postgresql install.
|
||||
--------
|
||||
|
||||
As of postgresql v7.4 pg_autovacuum is included in the main source tree
|
||||
under contrib. Therefore you just make && make install (similar to most other
|
||||
contrib modules) and it will be installed for you.
|
||||
|
||||
If you are using an earlier version of postgresql just uncompress the tar.gz
|
||||
into the contrib directory and modify the contrib/Makefile to include the pg_autovacuum
|
||||
directory. pg_autovacuum will then be made as part of the standard
|
||||
postgresql install.
|
||||
|
||||
make sure that the folowing are set in postgresql.conf
|
||||
stats_start_collector = true
|
||||
stats_row_level = true
|
||||
|
||||
start up the postmaster
|
||||
then, just execute the pg_autovacuum executable.
|
||||
stats_start_collector = true
|
||||
stats_row_level = true
|
||||
|
||||
start up the postmaster, then execute the pg_autovacuum executable.
|
||||
|
||||
|
||||
Command line arguments:
|
||||
-----------------------
|
||||
|
||||
pg_autovacuum has the following optional arguments:
|
||||
|
||||
-d debug: 0 silent, 1 basic info, 2 more debug info, etc...
|
||||
-D dameonize: Detach from tty and run in background.
|
||||
-s sleep base value: see "Sleeping" below.
|
||||
-S sleep scaling factor: see "Sleeping" below.
|
||||
-t tuple base threshold: see Vacuuming.
|
||||
-T tuple scaling factor: see Vacuuming.
|
||||
-U username: Username pg_autovacuum will use to connect with, if not specified the
|
||||
current username is used
|
||||
-v vacuum base threshold: see Vacuum and Analyze.
|
||||
-V vacuum scaling factor: see Vacuum and Analyze.
|
||||
-a analyze base threshold: see Vacuum and Analyze.
|
||||
-A analyze scaling factor: see Vacuum and Analyze.
|
||||
-L log file: Name of file to which output is submitted, otherwise STDERR
|
||||
-U username: Username pg_autovacuum will use to connect with, if not
|
||||
specified the current username is used.
|
||||
-P password: Password pg_autovacuum will use to connect with.
|
||||
-H host: host name or IP to connect too.
|
||||
-p port: port used for connection.
|
||||
-h help: list of command line options.
|
||||
|
||||
All arguments have default values defined in pg_autovacuum.h. At the time of this
|
||||
writing they are:
|
||||
#define AUTOVACUUM_DEBUG 1
|
||||
#define BASETHRESHOLD 100
|
||||
#define SCALINGFACTOR 2
|
||||
#define SLEEPVALUE 3
|
||||
#define SLEEPSCALINGFACTOR 2
|
||||
#define UPDATE_INTERVAL 2
|
||||
All arguments have default values defined in pg_autovacuum.h. At the
|
||||
time of writing they are:
|
||||
|
||||
-d 1
|
||||
-v 1000
|
||||
-V 2
|
||||
-a 500 (half of -v is not specified)
|
||||
-A 1 (half of -v is not specified)
|
||||
-s 300 (5 minutes)
|
||||
-S 2
|
||||
|
||||
|
||||
Vacuum and Analyze:
|
||||
pg_autovacuum performes either a vacuums analyze or just analyze depending on the table activity.
|
||||
If the number of (inserts + updates) > insertThreshold, then an only an analyze is performed.
|
||||
If the number of (deletes + updates ) > deleteThreshold, then a vacuum analyze is performed.
|
||||
deleteThreshold is equal to: tuple_base_value + (tuple_scaling_factor * "number of tuples in the table")
|
||||
insertThreshold is equal to: 0.5 * tuple_base_value + (tuple_scaling_factor * "number of tuples in the table")
|
||||
The insertThreshold is half the deleteThreshold because it's a much lighter operation (approx 5%-10% of vacuum),
|
||||
so running it more often costs us little in performance degredation.
|
||||
-------------------
|
||||
|
||||
pg_autovacuum performs either a vacuum analyze or just analyze depending
|
||||
on the quantity and type of table activity (insert, update, or delete):
|
||||
|
||||
- If the number of (inserts + updates + deletes) > AnalyzeThreshold, then
|
||||
only an analyze is performed.
|
||||
|
||||
- If the number of (deletes + updates ) > VacuumThreshold, then a
|
||||
vacuum analyze is performed.
|
||||
|
||||
deleteThreshold is equal to:
|
||||
vacuum_base_value + (vacuum_scaling_factor * "number of tuples in the table")
|
||||
|
||||
insertThreshold is equal to:
|
||||
analyze_base_value + (analyze_scaling_factor * "number of tuples in the table")
|
||||
|
||||
The AnalyzeThreshold defaults to half of the VacuumThreshold since it
|
||||
represents a much less expensive operation (approx 5%-10% of vacuum), and
|
||||
running it more often should not substantially degrade system performance.
|
||||
|
||||
Sleeping:
|
||||
pg_autovacuum sleeps after it is done checking all the databases. It does this so as
|
||||
to limit the amount of system resources it consumes. This also allows the system
|
||||
administrator to configure pg_autovacuum to be more or less aggressive. Reducing the
|
||||
sleep time will cause pg_autovacuum to respond more quickly to changes, be they database
|
||||
addition / removal, table addition / removal, or just normal table activity. However,
|
||||
setting these values to high can have a negative net effect on the server. If a table
|
||||
gets vacuumed 5 times during the course of a large update, it might take much longer
|
||||
than if it was vacuumed only once.
|
||||
The total time it sleeps is equal to:
|
||||
base_sleep_value + sleep_scaling_factor * "duration of the previous loop"
|
||||
---------
|
||||
|
||||
What it monitors:
|
||||
pg_autovacuum dynamically generates a list of databases and tables to monitor, in
|
||||
addition it will dynamically add and remove databases and tables that are
|
||||
removed from the database server while pg_autovacuum is running.
|
||||
pg_autovacuum sleeps for a while after it is done checking all the
|
||||
databases. It does this in order to limit the amount of system
|
||||
resources it consumes. This also allows the system administrator to
|
||||
configure pg_autovacuum to be more or less aggressive.
|
||||
|
||||
Reducing the sleep time will cause pg_autovacuum to respond more
|
||||
quickly to changes, whether they be database addition/removal, table
|
||||
addition/removal, or just normal table activity.
|
||||
|
||||
On the other hand, setting pg_autovaccum to sleep values to agressivly
|
||||
(for too short a period of time) can have a negative effect on server
|
||||
performance. If a table gets vacuumed 5 times during the course of a
|
||||
large update, this is likely to take much longer than if the table was
|
||||
vacuumed only once, at the end.
|
||||
|
||||
The total time it sleeps is equal to:
|
||||
|
||||
base_sleep_value + sleep_scaling_factor * "duration of the previous
|
||||
loop"
|
||||
|
||||
Note that timing measurements are made in seconds; specifying
|
||||
"pg_vacuum -s 1" means pg_autovacuum could poll the database upto 60 times
|
||||
minute. In a system with large tables where vacuums may run for several
|
||||
minutes, longer times between vacuums are likely to be appropriate.
|
||||
|
||||
What pg_autovacuum monitors:
|
||||
----------------------------
|
||||
|
||||
pg_autovacuum dynamically generates a list of all databases and tables that
|
||||
exist on the server. It will dynamically add and remove databases and
|
||||
tables that are removed from the database server while pg_autovacuum is
|
||||
running. Overhead is fairly small per object. For example: 10 databases
|
||||
with 10 tables each appears to less than 10k of memory on my Linux box.
|
||||
|
||||
@ -1,6 +1,5 @@
|
||||
Todo Items for pg_autovacuum client
|
||||
|
||||
_Allow it to detach from the tty
|
||||
--------------------------------------------------------------------------
|
||||
|
||||
_create a FSM export function and see if I can use it for pg_autovacuum
|
||||
|
||||
@ -9,6 +8,7 @@ _look into possible benifits of pgstattuple contrib work
|
||||
_Continue trying to reduce server load created by polling.
|
||||
|
||||
Done:
|
||||
--------------------------------------------------------------------------
|
||||
_Check if required pg_stats are enables, if not exit with error
|
||||
|
||||
_Reduce the number connections and queries to the server
|
||||
@ -34,3 +34,10 @@ _change name to pg_autovacuum
|
||||
|
||||
_Add proper table and database removal functions so that we can properly
|
||||
clear up before we exit, and make sure we don't leak memory when removing tables and such.
|
||||
|
||||
_Decouple insert and delete thresholds
|
||||
|
||||
_Fix Vacuum debug routine to include the database name.
|
||||
|
||||
_Allow it to detach from the tty
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -2,80 +2,112 @@
|
||||
* Header file for pg_autovacuum.c
|
||||
* (c) 2003 Matthew T. O'Connor
|
||||
*/
|
||||
|
||||
#include "postgres_fe.h"
|
||||
|
||||
#include <unistd.h>
|
||||
#ifdef __GLIBC__
|
||||
#include <getopt.h>
|
||||
#endif
|
||||
#include <sys/time.h>
|
||||
|
||||
/* These next two lines are correct when pg_autovaccum is compiled
|
||||
from within the postgresql source tree */
|
||||
#include "libpq-fe.h"
|
||||
#include "lib/dllist.h"
|
||||
/* Had to change the last two lines to compile on
|
||||
Redhat outside of postgresql source tree */
|
||||
/*
|
||||
#include "/usr/include/libpq-fe.h"
|
||||
#include "/usr/include/pgsql/server/lib/dllist.h"
|
||||
*/
|
||||
|
||||
#define AUTOVACUUM_DEBUG 1
|
||||
#define BASETHRESHOLD 100
|
||||
#define SCALINGFACTOR 2
|
||||
#define SLEEPVALUE 1
|
||||
#define SLEEPSCALINGFACTOR 0
|
||||
#define VACBASETHRESHOLD 1000
|
||||
#define VACSCALINGFACTOR 2
|
||||
#define SLEEPBASEVALUE 300
|
||||
#define SLEEPSCALINGFACTOR 2
|
||||
#define UPDATE_INTERVAL 2
|
||||
|
||||
/* these two constants are used to tell update_table_stats what operation we just perfomred */
|
||||
#define VACUUM_ANALYZE 0
|
||||
#define ANALYZE_ONLY 1
|
||||
|
||||
#define TABLE_STATS_ALL "select a.relfilenode,a.relname,a.relnamespace,a.relpages,a.reltuples,b.schemaname,b.n_tup_ins,b.n_tup_upd,b.n_tup_del from pg_class a, pg_stat_all_tables b where a.relfilenode=b.relid"
|
||||
#define TABLE_STATS_USER "select a.relfilenode,a.relname,a.relnamespace,a.relpages,a.reltuples,b.schemaname,b.n_tup_ins,b.n_tup_upd,b.n_tup_del from pg_class a, pg_stat_user_tables b where a.relfilenode=b.relid"
|
||||
#define FRONTEND
|
||||
#define PAGES_QUERY "select relfilenode,reltuples,relpages from pg_class where relfilenode=%i"
|
||||
#define FROZENOID_QUERY "select oid,age(datfrozenxid) from pg_database where datname = 'template1'"
|
||||
#define FROZENOID_QUERY2 "select oid,datname,age(datfrozenxid) from pg_database where datname!='template0'"
|
||||
|
||||
struct cmdargs{
|
||||
int tuple_base_threshold,sleep_base_value,debug;
|
||||
float tuple_scaling_factor,sleep_scaling_factor;
|
||||
char *user, *password, *host, *port;
|
||||
}; typedef struct cmdargs cmd_args;
|
||||
/* define cmd_args stucture */
|
||||
struct cmdargs
|
||||
{
|
||||
int vacuum_base_threshold, analyze_base_threshold, sleep_base_value, debug, daemonize;
|
||||
float vacuum_scaling_factor, analyze_scaling_factor, sleep_scaling_factor;
|
||||
char *user, *password, *host, *logfile, *port;
|
||||
};
|
||||
typedef struct cmdargs cmd_args;
|
||||
|
||||
/* define cmd_args as global so we can get to them everywhere */
|
||||
cmd_args *args;
|
||||
|
||||
struct tableinfo{
|
||||
char *schema_name,*table_name;
|
||||
int insertThreshold,deleteThreshold;
|
||||
int relfilenode,reltuples,relpages;
|
||||
long InsertsAtLastAnalyze; /* equal to: inserts + updates as of the last analyze or initial values at startup */
|
||||
long DeletesAtLastVacuum; /* equal to: deletes + updates as of the last vacuum or initial values at startup */
|
||||
}; typedef struct tableinfo tbl_info;
|
||||
cmd_args *args;
|
||||
|
||||
/* Might need to add a time value for last time the whold database was vacuumed.
|
||||
I think we need to guarantee this happens approx every 1Million TX's */
|
||||
struct dbinfo{
|
||||
int oid,age;
|
||||
int insertThreshold,deleteThreshold; /* Use these as defaults for table thresholds */
|
||||
PGconn *conn;
|
||||
char *dbname,*username,*password;
|
||||
Dllist *table_list;
|
||||
}; typedef struct dbinfo db_info;
|
||||
struct dbinfo
|
||||
{
|
||||
int oid, age;
|
||||
int analyze_threshold, vacuum_threshold; /* Use these as defaults for table thresholds */
|
||||
PGconn *conn;
|
||||
char *dbname, *username, *password;
|
||||
Dllist *table_list;
|
||||
};
|
||||
typedef struct dbinfo db_info;
|
||||
|
||||
struct tableinfo
|
||||
{
|
||||
char *schema_name, *table_name;
|
||||
int relfilenode, reltuples, relpages;
|
||||
long analyze_threshold, vacuum_threshold;
|
||||
long CountAtLastAnalyze; /* equal to: inserts + updates as of the last analyze or initial values at startup */
|
||||
long CountAtLastVacuum; /* equal to: deletes + updates as of the last vacuum or initial values at startup */
|
||||
long curr_analyze_count, curr_vacuum_count; /* Latest values from stats system */
|
||||
db_info *dbi; /* pointer to the database that this table belongs to */
|
||||
};
|
||||
typedef struct tableinfo tbl_info;
|
||||
|
||||
/* Functions for dealing with command line arguements */
|
||||
static cmd_args *get_cmd_args(int argc,char *argv[]);
|
||||
static void print_cmd_args(void);
|
||||
static void free_cmd_args(void);
|
||||
static cmd_args *get_cmd_args (int argc, char *argv[]);
|
||||
static void print_cmd_args (void);
|
||||
static void free_cmd_args (void);
|
||||
static void usage (void);
|
||||
|
||||
/* Functions for managing database lists */
|
||||
static Dllist *init_db_list(void);
|
||||
static db_info *init_dbinfo(char *dbname,int oid,int age);
|
||||
static void update_db_list(Dllist *db_list);
|
||||
static void remove_db_from_list(Dlelem *db_to_remove);
|
||||
static void print_db_info(db_info *dbi,int print_table_list);
|
||||
static void print_db_list(Dllist *db_list,int print_table_lists);
|
||||
static int xid_wraparound_check(db_info *dbi);
|
||||
static void free_db_list(Dllist *db_list);
|
||||
static Dllist *init_db_list (void);
|
||||
static db_info *init_dbinfo (char *dbname, int oid, int age);
|
||||
static void update_db_list (Dllist * db_list);
|
||||
static void remove_db_from_list (Dlelem * db_to_remove);
|
||||
static void print_db_info (db_info * dbi, int print_table_list);
|
||||
static void print_db_list (Dllist * db_list, int print_table_lists);
|
||||
static int xid_wraparound_check (db_info * dbi);
|
||||
static void free_db_list (Dllist * db_list);
|
||||
|
||||
/* Functions for managing table lists */
|
||||
static tbl_info *init_table_info(PGresult *conn, int row);
|
||||
static void update_table_list(db_info *dbi);
|
||||
static void remove_table_from_list(Dlelem *tbl_to_remove);
|
||||
static void print_table_list(Dllist *tbl_node);
|
||||
static void print_table_info(tbl_info *tbl);
|
||||
static void update_table_thresholds(db_info *dbi,tbl_info *tbl);
|
||||
static void free_tbl_list(Dllist *tbl_list);
|
||||
static tbl_info *init_table_info (PGresult * conn, int row, db_info *dbi);
|
||||
static void update_table_list (db_info * dbi);
|
||||
static void remove_table_from_list (Dlelem * tbl_to_remove);
|
||||
static void print_table_list (Dllist * tbl_node);
|
||||
static void print_table_info (tbl_info * tbl);
|
||||
static void update_table_thresholds (db_info * dbi, tbl_info * tbl, int vacuum_type);
|
||||
static void free_tbl_list (Dllist * tbl_list);
|
||||
|
||||
/* A few database helper functions */
|
||||
static int check_stats_enabled(db_info *dbi);
|
||||
static PGconn *db_connect(db_info *dbi);
|
||||
static void db_disconnect(db_info *dbi);
|
||||
static PGresult *send_query(const char *query,db_info *dbi);
|
||||
static char *query_table_stats(db_info *dbi);
|
||||
|
||||
static int check_stats_enabled (db_info * dbi);
|
||||
static PGconn *db_connect (db_info * dbi);
|
||||
static void db_disconnect (db_info * dbi);
|
||||
static PGresult *send_query (const char *query, db_info * dbi);
|
||||
static char *query_table_stats (db_info * dbi);
|
||||
|
||||
/* Other Generally needed Functions */
|
||||
static void daemonize(void);
|
||||
static void log_entry (const char *logentry);
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user