Release 4.8

pg_profile 4.8

Installation

Provided file pg_profile--4.8.tar.gz is to be extracted into extension folder of postgresql installation:

sudo tar xzf pg_profile--4.8.tar.gz --directory $(pg_config --sharedir)/extension

You will need plpgsql and dblink extensions in your database, and pg_stat_statements extension if you need statements statistics. Then, you can create extension in postgresql database:

CREATE SCHEMA profile;
CREATE EXTENSION pg_profile SCHEMA profile;

If previous version of pg_profile is installed in your database, it can be updated:

ALTER EXTENSION pg_profile UPDATE;

Use provided pg_profile--4.8_manual.tar.gz file only for manual objects creation in restricted environments (when you have no file system access). Right now export and import functionalities is not supported in manually installed version.

For further setup and usage details refer to doc/pg_profile.md file

Grafana dashboards

You can use Grafana to visualize pg_profile samples data as time series. It will help you to find time intervals for reports. Dashboards are in pg_profile_grafana_4.6.tar.gz file.

Changelog

• Added database extension version section (@blackstranger)
• Add possibility to exclude some databases from report (@blackstranger)
• Support of "on cpu" event provided by pg_wait_sampling 1.1.6 (noted in #114)
• Report frontend fixes and optimizations (@Djoongaar)
• Grafana dashboards fixed

Release 4.7

pg_profile 4.7

Installation

Provided file pg_profile--4.7.tar.gz is to be extracted into extension folder of postgresql installation:

sudo tar xzf pg_profile--4.7.tar.gz --directory $(pg_config --sharedir)/extension

You will need plpgsql and dblink extensions in your database, and pg_stat_statements extension if you need statements statistics. Then, you can create extension in postgresql database:

CREATE SCHEMA profile;
CREATE EXTENSION pg_profile SCHEMA profile;

If previous version of pg_profile is installed in your database, it can be updated:

ALTER EXTENSION pg_profile UPDATE;

Use provided pg_profile--4.7_manual.tar.gz file only for manual objects creation in restricted environments (when you have no file system access). Right now export and import functionalities is not supported in manually installed version.

For further setup and usage details refer to doc/pg_profile.md file

Grafana dashboards

You can use Grafana to visualize pg_profile samples data as time series. It will help you to find time intervals for reports. Dashboards are in pg_profile_grafana_4.6.tar.gz file.

Changelog

• support of PostgreSQL 17 cluster statistics
• support of pg_stat_statements 1.11
• support of pg_stat_kcache 2.3.0
• pg_stat_statements_reset() call can be skipped now
• visualisation of session states timeline (@Djoongaar)
• take_sample() function inherits lock_timeout setting
• md5() hash replaced by sha224() to avoid errors in FIPS mode
• other bugfixes #100, #105

Release 4.6

pg_profile 4.6

Installation

Provided file pg_profile--4.6.tar.gz is to be extracted into extension folder of postgresql installation:

sudo tar xzf pg_profile--4.6.tar.gz --directory $(pg_config --sharedir)/extension

You will need plpgsql and dblink extensions in your database, and pg_stat_statements extension if you need statements statistics. Then, you can create extension in postgresql database:

CREATE SCHEMA profile;
CREATE EXTENSION pg_profile SCHEMA profile;

If previous version of pg_profile is installed in your database, it can be updated:

ALTER EXTENSION pg_profile UPDATE;

Use provided pg_profile--4.6_manual.tar.gz file only for manual objects creation in restricted environments (when you have no file system access). Right now export and import functionalities is not supported in manually installed version.

For further setup and usage details refer to doc/pg_profile.md file

Grafana dashboards

You can use Grafana to visualize pg_profile samples data as time series. It will help you to find time intervals for reports. Dashboards are in pg_profile_grafana_4.6.tar.gz file.

Changelog

• Query text preview available in all query statistic sections (@Djoongaar)
• Hidable report contents on the left edge (@Djoongaar)
• The new subsample feature allows to track session states and include them in the report. See Subsamples
• New grafana dashboard pg_profile_activity visualizing session states distribution over time using the data collected by subsamples. See Grafana README
• Added database version section to the top of the report

Release 4.5

pg_profile 4.5

Installation

Provided file pg_profile--4.5.tar.gz is to be extracted into extension folder of postgresql installation:

sudo tar xzf pg_profile--4.5.tar.gz --directory $(pg_config --sharedir)/extension

You will need plpgsql and dblink extensions in your database, and pg_stat_statements extension if you need statements statistics. Then, you can create extension in postgresql database:

CREATE SCHEMA profile;
CREATE EXTENSION pg_profile SCHEMA profile;

If previous version of pg_profile is installed in your database, it can be updated:

ALTER EXTENSION pg_profile UPDATE;

Use provided pg_profile--4.5_manual.tar.gz file only for manual objects creation in restricted environments (when you have no file system access). Right now export and import functionalities is not supported in manually installed version.

For further setup and usage details refer to doc/pg_profile.md file

Grafana dashboards

You can use Grafana to visualize pg_profile samples data as time series. It will help you to find time intervals for reports. Dashboards are in pg_profile_grafana_4.3.tar.gz file.

Changelog

• Fix broken take_sample() function after performing a sample during execution of pg_repack

Release 4.4

pg_profile 4.4

Installation

Provided file pg_profile--4.4.tar.gz is to be extracted into extension folder of postgresql installation:

sudo tar xzf pg_profile--4.4.tar.gz --directory $(pg_config --sharedir)/extension

You will need plpgsql and dblink extensions in your database, and pg_stat_statements extension if you need statements statistics. Then, you can create extension in postgresql database:

CREATE SCHEMA profile;
CREATE EXTENSION pg_profile SCHEMA profile;

If previous version of pg_profile is installed in your database, it can be updated:

ALTER EXTENSION pg_profile UPDATE;

Use provided pg_profile--4.4_manual.tar.gz file only for manual objects creation in restricted environments (when you have no file system access). Right now export and import functionalities is not supported in manually installed version.

For further setup and usage details refer to doc/pg_profile.md file

Grafana dashboards

You can use Grafana to visualize pg_profile samples data as time series. It will help you to find time intervals for reports. Dashboards are in pg_profile_grafana_4.3.tar.gz file.

Changelog

• Query text preview in "Top SQL by ..." report sections (@Djoongaar)
• Substring-based report entries filter (@Djoongaar)
• Samples import rewritten. Import performance improved for huge dumps
• pg_stat_kcache 2.2.3 supported
• Other minor fixes and improvements

Release 4.3

pg_profile 4.3

Installation

Provided file pg_profile--4.3.tar.gz is to be extracted into extension folder of postgresql installation:

sudo tar xzf pg_profile--4.3.tar.gz --directory $(pg_config --sharedir)/extension

You will need plpgsql and dblink extensions in your database, and pg_stat_statements extension if you need statements statistics. Then, you can create extension in postgresql database:

CREATE SCHEMA profile;
CREATE EXTENSION pg_profile SCHEMA profile;

If previous version of pg_profile is installed in your database, it can be updated:

ALTER EXTENSION pg_profile UPDATE;

Use provided pg_profile--4.3_manual.tar.gz file only for manual objects creation in restricted environments (when you have no file system access). Right now export and import functionalities is not supported in manually installed version.

For further setup and usage details refer to doc/pg_profile.md file

Grafana dashboards

You can use Grafana to visualize pg_profile samples data as time series. It will help you to find time intervals for reports. Dashboards are in pg_profile_grafana_4.3.tar.gz file.

Changelog

• Postgres 16 supported
• data collection supported for pg_stat_slru
• New report section "Cluster I/O statistics" (for Postgres 16)
• New report section "Cluster SLRU statistics"
• New report section "Top tables by new-page updated tuples" (for Postgres 16)
• Highlight of topics in table of contents sidebar containing selected object data (@Djoongaar)
• Privileges. Every user can now build a report, but the pg_read_all_stats role must be granted to user to see query texts. See Privileges

Release 4.2

pg_profile 4.2

Installation

Provided file pg_profile--4.2.tar.gz is to be extracted into extension folder of postgresql installation:

sudo tar xzf pg_profile--4.2.tar.gz --directory $(pg_config --sharedir)/extension

You will need plpgsql and dblink extensions in your database, and pg_stat_statements extension if you need statements statistics. Then, you can create extension in postgresql database:

CREATE SCHEMA profile;
CREATE EXTENSION pg_profile SCHEMA profile;

If previous version of pg_profile is installed in your database, it can be updated:

ALTER EXTENSION pg_profile UPDATE;

Use provided pg_profile--4.2_manual.tar.gz file only for manual objects creation in restricted environments (when you have no file system access). Right now export and import functionalities is not supported in manually installed version.

For further setup and usage details refer to doc/pg_profile.md file

Grafana dashboards

You can use Grafana to visualize pg_profile samples data as time series. It will help you to find time intervals for reports. Dashboards are in pg_profile_grafana_4.2.tar.gz file.

Changelog

• Completely new report engine providing interactive reports feature (By @Djoongaar and @zubkov-andrei)
• max_sample_age field added to the output of show_servers() function. (Reported by @bat-manav in #40)
• WAL LSN of report bounds is now shown in "Cluster statistics" section
• Fixed #62 reported by @portnov - incorrect values in V15 before first statistics reset
• Support of temporary I/O time statistics for statements from pg_stat_statements extension.
• Fixed #65 reported by @pkonotopov - Idle in transaction timeout during a sample.
• #66 implemented. Now the take_sample(text, boolean) function returns the result of the operation.
• Manual objects creation script fixed. #64 reported by @Poleon-Na

Release 4.1

pg_profile 4.1

Installation

Provided file pg_profile--4.1.tar.gz is to be extracted into extension folder of postgresql installation:

sudo tar xzf pg_profile--4.1.tar.gz --directory $(pg_config --sharedir)/extension

You will need plpgsql and dblink extensions in your database, and pg_stat_statements extension if you need statements statistics. Then, you can create extension in postgresql database:

CREATE SCHEMA profile;
CREATE EXTENSION pg_profile SCHEMA profile;

If previous version of pg_profile is installed in your database, it can be updated:

ALTER EXTENSION pg_profile UPDATE;

Use provided pg_profile--4.1_manual.tar.gz file only for manual objects creation in restricted environments (when you have no file system access). Right now export and import functionalities is not supported in manually installed version.

For further setup and usage details refer to doc/pg_profile.md file

Changelog

• Avoid serialization of parallel samples (#48 by @xinferum) caused by locking due to analyze operations.
• Fixed retention of last statements data. The new statements sample taking procedure implemented in 4.0 contained a bug - the obsolete data was not deleted from last_ tables. Update to 4.1 will fix this error and cleanup all obsolete data.
• Support of PostgreSQL 15 (pg_stat_statements v1.10) data collection
• JIT statistic section will appear in report for pg_stat_statements v1.10 (implemented by @Djoongaar).
• Other fixes and optimizations

Release 4.0

pg_profile 4.0

Installation

Provided file pg_profile--4.0.tar.gz is to be extracted into extension folder of postgresql installation:

sudo tar xzf pg_profile--4.0.tar.gz --directory $(pg_config --sharedir)/extension

You will need plpgsql and dblink extensions in your database, and pg_stat_statements extension if you need statements statistics. Then, you can create extension in postgresql database:

CREATE SCHEMA profile;
CREATE EXTENSION pg_profile SCHEMA profile;

If previous version of pg_profile is installed in your database, it can be updated:

ALTER EXTENSION pg_profile UPDATE;

Use provided pg_profile--4.0_manual.tar.gz file only for manual objects creation in restricted environments (when you have no file system access). Right now export and import functionalities is not supported in manually installed version.

For further setup and usage details refer to doc/pg_profile.md file

Changelog

• Corrected nested-level statements support (#37)
• Added username field in statement-related sections
• Statement statistics collection optimized
• pg_stat_kcache 2.2.1 (#39)
• Support of the pg_wait_sampling extension
• Manual samples delete functions (reported by @xinferum in #30)
• Obsolete samples management optimized
• bugfix: take_sample() function was waited on a lock on servers table entry due to missplaced lock check routine
• per-database checksum_failures is tracked and reported if detected during report interval
• Server name prefix for importing server names to avoid name conflicts during import
• Added Block I/O times in Database statistics section
• Report generation engine completely rewritten for future improvements
• fixed session statistics import
• fixed error in the docs #27
• Other fixes and optimizations

Release 0.3.6

pg_profile 0.3.6

Installation

Provided file pg_profile--0.3.6.tar.gz is to be extracted into extension folder of postgresql installation:

sudo tar xzf pg_profile--0.3.6.tar.gz --directory $(pg_config --sharedir)/extension

You will need plpgsql and dblink extensions in your database, and pg_stat_statements extension if you need statements statistics. Then, you can create extension in postgresql database:

CREATE SCHEMA profile;
CREATE EXTENSION pg_profile SCHEMA profile;

If previous version of pg_profile is installed in your database, it can be updated:

ALTER EXTENSION pg_profile UPDATE;

Use provided pg_profile--0.3.6_manual.tar.gz file only for manual objects creation in restricted environments (when you have no file system access). Right now export and import functionalities is not supported in manually installed version.

For further setup and usage details refer to doc/pg_profile.md file

Changelog

• WAL fields in statements by blocks dirtied report section
• pg_class.relpages is collected in samples now. This data is used in estimations while pg_relations_size() data is unavailable due to relation size collection policy.
• set application_name while taking a sample
• fixed #29 reported by @xinferum (relation size collection window)
• query texts in reports is now truncated to 20 000 characters by default
• internal fixes and optimizations
• fixed #31 reported by @sgrinko "ERROR: integer out of range" while collecting relation size data based on pg_class.relpages