Add RELP (Reliable Event Logging Protocol) log delivery handler #5

New Issue

2026-02-08T18:16:22+01:00

clawbot commented

2026-02-08 18:16:22 +01:00

Goal

Implement a RELP client handler for simplelog, allowing log messages to be delivered to a remote rsyslog server using the RELP protocol (via imrelp).

Design

New RELPHandler implementing slog.Handler (and ExtendedHandler)
Configured via LOGGER_RELP_URL environment variable (e.g. tcp://rsyslog.example.com:2514)
RELP session management: open handshake, syslog command for each log message, graceful close
Transaction numbers tracked per session
Automatic reconnection on connection failure
Syslog-formatted messages (RFC 5424 or RFC 3164) sent via RELP syslog command
Acknowledgement tracking — each syslog command gets an rsp from the server confirming delivery

RELP Protocol Summary

Frame format: TXNR SP COMMAND SP DATALEN [SP DATA] LF

open — session init with version/capabilities offers
syslog — deliver a log message
close — graceful session teardown
rsp — server response with status code (200=ok, 500=error)

References

RELP spec: https://github.com/rsyslog/librelp/blob/master/doc/relp.html
README already lists this as a planned feature

## Goal Implement a RELP client handler for simplelog, allowing log messages to be delivered to a remote rsyslog server using the RELP protocol (via `imrelp`). ## Design - New `RELPHandler` implementing `slog.Handler` (and `ExtendedHandler`) - Configured via `LOGGER_RELP_URL` environment variable (e.g. `tcp://rsyslog.example.com:2514`) - RELP session management: `open` handshake, `syslog` command for each log message, graceful `close` - Transaction numbers tracked per session - Automatic reconnection on connection failure - Syslog-formatted messages (RFC 5424 or RFC 3164) sent via RELP `syslog` command - Acknowledgement tracking — each `syslog` command gets an `rsp` from the server confirming delivery ## RELP Protocol Summary Frame format: `TXNR SP COMMAND SP DATALEN [SP DATA] LF` - `open` — session init with version/capabilities offers - `syslog` — deliver a log message - `close` — graceful session teardown - `rsp` — server response with status code (200=ok, 500=error) ## References - RELP spec: https://github.com/rsyslog/librelp/blob/master/doc/relp.html - README already lists this as a planned feature

clawbot referenced a pull request that will close this issue

2026-02-08 18:17:52 +01:00

feat: add RELP handler for reliable log delivery to rsyslog (closes #5) #6

clawbot referenced a pull request that will close this issue

2026-03-01 15:00:09 +01:00

feat: add RELP handler for reliable log delivery to rsyslog (closes #5) #8

sneak closed this issue

2026-03-01 15:10:07 +01:00

Sign in to join this conversation.