injection_points: Add some cumulative stats for injection points
authorMichael Paquier <michael@paquier.xyz>
Mon, 5 Aug 2024 03:06:54 +0000 (12:06 +0900)
committerMichael Paquier <michael@paquier.xyz>
Mon, 5 Aug 2024 03:06:54 +0000 (12:06 +0900)
commit75534436a477474ea05004b7fbed21e20cea774a
tree9ead76178708c772eb43b27914d30aa434f2be94
parent2eff9e678d350882f7a4b6ec6361927c9093051c
injection_points: Add some cumulative stats for injection points

This acts as a template of what can be achieved with the pluggable
cumulative stats APIs introduced in 7949d9594582 for the
variable-numbered case where stats entries are stored in the pgstats
dshash, while being potentially useful on its own for injection points,
say to add starting and/or stopping conditions based on the statistics
(want to trigger a callback after N calls, for example?).

Currently, the only data gathered is the number of times an injection
point is run.  More fields can always be added as required.  All the
routines related to the stats are located in their own file, called
injection_stats.c in the test module injection_points, for clarity.

The stats can be used only if the test module is loaded through
shared_preload_libraries.  The key of the dshash uses InvalidOid for the
database, and an int4 hash of the injection point name as object ID.

A TAP test is added to provide coverage for the new custom cumulative
stats APIs, showing the persistency of the data across restarts, for
example.

Author: Michael Paquier
Reviewed-by: Dmitry Dolgov, Bertrand Drouvot
Discussion: https://postgr.es/m/Zmqm9j5EO0I4W8dx@paquier.xyz
doc/src/sgml/xfunc.sgml
src/test/modules/injection_points/Makefile
src/test/modules/injection_points/injection_points--1.0.sql
src/test/modules/injection_points/injection_points.c
src/test/modules/injection_points/injection_stats.c [new file with mode: 0644]
src/test/modules/injection_points/injection_stats.h [new file with mode: 0644]
src/test/modules/injection_points/meson.build
src/test/modules/injection_points/t/001_stats.pl [new file with mode: 0644]
src/tools/pgindent/typedefs.list