Add the xmin horizon to running query display

The xmin horizon was added in 9.4 in commit [1].
[1] postgres/postgres@dd1a3bc

Author: blogh

CHANGELOG.md

@@ -11,6 +11,7 @@
   configuration.
 * Add a `y` command to copy focused query to the system clipboard, using
   OSC 52 escape sequence (#311).
+* Add the `xmin` column to the query display (#425).
 
 ### Fixed
 

docs/man/pg_activity.1

@@ -182,6 +182,8 @@ The running queries panel shows all running queries, transactions or backends
 .IP "\- \fBPID\fR: process id of the backend which executes the query;" 2
 .IX Item "- PID: process id of the backend which executes the query;"
 .PD 0
+.IP "\- \fBXMIN\fR: xmin horizon of the backend;" 2
+.IX Item "- XMIN: xmin horizon of the backend;"
 .IP "\- \fBDATABASE\fR: database specified in the connection string;" 2
 .IX Item "- DATABASE: database specified in the connection string;"
 .IP "\- \fBAPP\fR: application name specified in the connection string;" 2
@@ -364,6 +366,11 @@ required by another session. It shows following information:
 .Vb 1
 \&        Enable/disable PID.
 .Ve
+.IP "\fB\-\-xmin\fR, \fB\-\-no\-xmin\fR" 2
+.IX Item "--xmin, --no-xmin"
+.Vb 1
+\&        Enable/disable XMIN.
+.Ve
 .IP "\fB\-\-database\fR, \fB\-\-no\-database\fR" 2
 .IX Item "--database, --no-database"
 .Vb 1

docs/man/pg_activity.pod

@@ -136,6 +136,8 @@ B<min duration> seconds. It displays the following information:
 
 =item - B<PID>: process id of the backend which executes the query;
 
+=item - B<XMIN>: xmin horizon of the backend;
+
 =item - B<DATABASE>: database specified in the connection string;
 
 =item - B<APP>: application name specified in the connection string;
@@ -322,6 +324,10 @@ required by another session. It shows following information:
 
 	Enable/disable PID.
 
+=item B<--xmin>, B<--no-xmin>
+
+	Enable/disable XMIN.
+
 =item B<--database>, B<--no-database>
 
 	Enable/disable DATABASE.

pgactivity/activities.py

@@ -151,6 +151,7 @@ def sorted(processes: list[T], *, key: SortKey, reverse: bool = False) -> list[T
     >>> processes = [
     ...     LocalRunningProcess(
     ...         pid="6240",
+    ...         xmin="1234",
     ...         application_name="pgbench",
     ...         database="pgbench",
     ...         user="postgres",
@@ -170,6 +171,7 @@ def sorted(processes: list[T], *, key: SortKey, reverse: bool = False) -> list[T
     ...     ),
     ...     LocalRunningProcess(
     ...         pid="6239",
+    ...         xmin="2345",
     ...         application_name="pgbench",
     ...         database="pgbench",
     ...         user="postgres",
@@ -189,6 +191,7 @@ def sorted(processes: list[T], *, key: SortKey, reverse: bool = False) -> list[T
     ...     ),
     ...     LocalRunningProcess(
     ...         pid="6228",
+    ...         xmin="3456",
     ...         application_name="pgbench",
     ...         database="pgbench",
     ...         user="postgres",
@@ -225,6 +228,7 @@ def sorted(processes: list[T], *, key: SortKey, reverse: bool = False) -> list[T
     >>> processes = [
     ...     LocalRunningProcess(
     ...         pid="6240",
+    ...         xmin="1234",
     ...         application_name="pgbench",
     ...         database="pgbench",
     ...         user="postgres",
@@ -244,6 +248,7 @@ def sorted(processes: list[T], *, key: SortKey, reverse: bool = False) -> list[T
     ...     ),
     ...     LocalRunningProcess(
     ...         pid="6239",
+    ...         xmin="2345",
     ...         application_name="pgbench",
     ...         database="pgbench",
     ...         user="postgres",
@@ -263,6 +268,7 @@ def sorted(processes: list[T], *, key: SortKey, reverse: bool = False) -> list[T
     ...     ),
     ...     LocalRunningProcess(
     ...         pid="6228",
+    ...         xmin="3456",
     ...         application_name="pgbench",
     ...         database="pgbench",
     ...         user="postgres",

pgactivity/cli.py

@@ -221,6 +221,7 @@ def get_parser() -> argparse.ArgumentParser:
         "These options may be used hide some columns from the processes table.",
     )
     flag(group, "--pid", dest="pid", feature="PID")
+    flag(group, "--xmin", dest="xmin", feature="XMIN")
     flag(group, "--database", dest="database", feature="DATABASE")
     flag(group, "--user", dest="user", feature="USER")
     flag(group, "--client", dest="client", feature="CLIENT")

pgactivity/config.py

@@ -62,9 +62,9 @@ class Flag(enum.Flag):
     """Column flag.
 
     >>> Flag.names()
-    ['database', 'appname', 'client', 'user', 'cpu', 'mem', 'read', 'write', 'time', 'wait', 'relation', 'type', 'mode', 'iowait', 'pid']
+    ['database', 'appname', 'client', 'user', 'cpu', 'mem', 'read', 'write', 'time', 'wait', 'relation', 'type', 'mode', 'iowait', 'pid', 'xmin']
     >>> Flag.all()  # doctest: +ELLIPSIS
-    <Flag...: 32767>
+    <Flag...: 65535>
     """
 
     DATABASE = enum.auto()
@@ -82,6 +82,7 @@ class Flag(enum.Flag):
     MODE = enum.auto()
     IOWAIT = enum.auto()
     PID = enum.auto()
+    XMIN = enum.auto()
 
     @classmethod
     def names(cls) -> list[str]:
@@ -131,6 +132,7 @@ def load(
         user: bool | None,
         wait: bool | None,
         write: bool | None,
+        xmin: bool | None,
         **kwargs: Any,
     ) -> Flag:
         """Build a Flag value from command line options."""
@@ -150,6 +152,7 @@ def load(
             (user, cls.USER),
             (wait, cls.WAIT),
             (write, cls.WRITE),
+            (xmin, cls.XMIN),
         ):
             if opt is True:
                 flag |= value

pgactivity/profiles/minimal.conf

@@ -3,6 +3,9 @@ show_instance = no
 show_system = no
 show_workers = no
 
+[xmin]
+hidden = yes
+
 [database]
 hidden = yes
 

pgactivity/profiles/narrow.conf

@@ -1,3 +1,6 @@
+[xmin]
+hidden = yes
+
 [database]
 hidden = yes
 

pgactivity/profiles/wide.conf

@@ -1,3 +1,6 @@
+[xmin]
+hidden = no
+
 [database]
 hidden = no
 

pgactivity/queries/get_pg_activity_oldest.sql

@@ -1,6 +1,7 @@
 -- Get data from pg_activity before pg 9.2
 SELECT
       a.procpid AS pid,
+      NULL AS xmin,
       '<unknown>' AS application_name,
       a.datname AS database,
       a.client_addr AS client,