Re: more descriptive message for process termination due to max_slot_wal_keep_size

Tom Lane <tgl@sss.pgh.pa.us>

From: Tom Lane <tgl@sss.pgh.pa.us>
To: Kyotaro Horiguchi <horikyota.ntt@gmail.com>
Cc: bdrouvot@amazon.com, sawada.mshk@gmail.com, ashutosh.bapat.oss@gmail.com, pgsql-hackers@postgresql.org
Date: 2022-09-28T20:30:37Z
Lists: pgsql-hackers
Kyotaro Horiguchi <horikyota.ntt@gmail.com> writes:
> Okay. the points you brought up above are sufficient grounds for not
> doing so.  Now they are in the following format.

> LOG: terminating process 16034 to release replication slot "rep1"
> because its restart_lsn 0/3158000 exceeds the limit by 15368192 bytes

This seems to me to be a pretty blatant violation of our first message
style guideline [1]:

    The primary message should be short, factual, and avoid reference to
    implementation details such as specific function names. “Short” means
    “should fit on one line under normal conditions”. Use a detail message
    if needed to keep the primary message short ...

I think you should leave the primary message alone and add a DETAIL,
as the first version of the patch did.

The existing "invalidating slot" message is already in violation
of this guideline, so splitting off a DETAIL from that seems
indicated as well.

			regards, tom lane

[1] https://www.postgresql.org/docs/devel/error-style-guide.html



Commits

  1. Improve wording of log messages triggered by max_slot_wal_keep_size.