Struct DlqEntry 

pub struct DlqEntry {
    pub timestamp: i64,
    pub service: String,
    pub reason: String,
    pub attempts: u32,
    pub payload: Vec<u8>,
    pub destination: Option<String>,
    pub source: Option<DlqSource>,
}

Available on crate feature dlq only.

A failed message routed to the dead letter queue.

This envelope is backend-agnostic – it carries the original payload plus metadata about why and where the failure occurred.

Fields

timestamp: i64

When the failure occurred (epoch milliseconds).

service: String

Service that generated this entry (e.g. “loader”, “receiver”).

reason: String

Why the message failed processing.

attempts: u32

How many times the message was retried before being sent to DLQ.

payload: Vec<u8>

Original message payload (base64-encoded in JSON).

destination: Option<String>

Intended destination (e.g. “db.table” or topic name).

source: Option<DlqSource>

Where the message originated.

Implementations

impl DlqEntry

pub fn new( service: impl Into<String>, reason: impl Into<String>, payload: Vec<u8>, ) -> Self

Create a new DLQ entry with the current timestamp.

pub fn with_destination(self, dest: impl Into<String>) -> Self

Set the intended destination.

pub fn with_source(self, source: DlqSource) -> Self

Set the source metadata.

pub fn with_attempts(self, attempts: u32) -> Self

Set the retry attempt count.

Trait Implementations

impl Clone for DlqEntry

fn clone(&self) -> DlqEntry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DlqEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DlqEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DlqEntry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.