no0p / pgsampler Goto Github PK

Pgsampler is an experimental background worker for collecting statistics about a Postgresql cluster's state and activity.

The project home page provides a demo and high level introduction.

The project wiki contains more detailed documentation.

The timeseries data can be logged to CSV files for later analysis, or shipped over a network connection to a receiving service for monitoring and analysis.

git clone [email protected]:no0p/pgsampler.git
cd pgsampler
make
sudo make install

Next update the postgresql.conf directive shared_preload_libraries to include pgsampler, like to the following example:

shared_preload_libraries = 'pgsampler'

Finally, restart the postgresql server.

Ensure that the postgresql development packages are installed to build.

For an ubuntu system the following will suffice:

sudo apt-get install postgresql-9.3-dev

It's easy to effectively uninstall pgsampler for any reason. If any issues arise and you want to rule out pgsampler, simply remove 'pgsampler' from the shared_preload_libraries directive and restart the server.

Pgsampler does not write to or update any tables -- it only reads data from the database. It only receives a fixed a length acknowledgement for data sent over the network.

Still, it is a background worker with access to shared memory and has access to all databases. At this time it is only recommended for more casual clusters until additional development and testing are completed.