emit_log_hook

中文定义与说明

在消息写入服务器日志之前拦截消息的钩子。

以下中文为本站依据所列 PostgreSQL 源码注释编译的说明。

接口声明

typedef void (*emit_log_hook_type) (ErrorData *edata);
extern PGDLLIMPORT emit_log_hook_type emit_log_hook;

源码说明

在消息写入服务器日志之前拦截消息。被 log_min_messages 抑制的消息不会调用此钩子；预加载库中的日志钩子也无法捕获该库加载之前产生的日志消息。

调用位置

• src/backend/utils/error/elog.c:1729

核心调用上下文：src/backend/utils/error/elog.c:1723–1737

	 * The log hook has access to both the translated and original English
	 * error message text, which is passed through to allow it to be used as a
	 * message identifier. Note that the original text is not available for
	 * detail, detail_log, hint and context text elements.
	 */
	if (edata->output_to_server && emit_log_hook)
		(*emit_log_hook) (edata);

	/* Send to server log, if enabled */
	if (edata->output_to_server)
		send_message_to_server_log(edata);

	/* Send to client, if enabled */
	if (edata->output_to_client)
		send_message_to_frontend(edata);