@cqrs-ddd/pipeline-deadletter
Καταγράφει μια αποτυχημένη λειτουργία ως dead letter: το αίτημα, το σφάλμα, το tenant και το correlation id της, αποστέλλοντάς τα σε ένα transport (BullMQ, RabbitMQ ή PostgreSQL). Εξ ορισμού καταγράφονται μόνο events, καθώς ο καλών ενός command ή query λαμβάνει ήδη το σφάλμα. Το DeadLetterRedriver εκτελεί ένα καταγεγραμμένο αίτημα εκ νέου αργότερα.
Εγκατάσταση
Ενότητα με τίτλο «Εγκατάσταση»Κάθε transport δέχεται client του αντίστοιχου broker ή βάσης δεδομένων (bullmq queue, amqplib confirm channel, pg pool).
Transports
Ενότητα με τίτλο «Transports»| Transport | Σημειώσεις |
|---|---|
BullMqDeadLetterTransport |
προσθέτει κάθε dead letter ως job σε ουρά BullMQ (προεπιλογή: dead-letter) |
RabbitMqDeadLetterTransport |
δημοσιεύει στο RabbitMQ μέσω confirm channel |
PostgresDeadLetterTransport |
εισάγει σε πίνακα (προεπιλογή: dead_letters). Αποτελεί επίσης DeadLetterStore, απαραίτητο για το redrive |
Οποιοδήποτε άλλο backend υλοποιεί το interface DeadLetterTransport: send(record).
Επιλογές
Ενότητα με τίτλο «Επιλογές»| Επιλογή | Σημασία | Προεπιλογή |
|---|---|---|
captureKinds |
είδη αιτημάτων που καταγράφονται | ['event'] |
rethrow |
επανέγερση του σφάλματος μετά την καταγραφή. Με false το αποσιωπά (μόνο σε events) |
true |
ignoreErrors |
κλάσεις σφαλμάτων ή συνάρτηση ελέγχου για σφάλματα που δεν καταγράφονται (π.χ. validation) | κανένα |
redactKeys |
πεδία που καλύπτονται στο καταγεγραμμένο payload | κανένα |
redact |
συνάρτηση που αντικαθιστά την προεπιλεγμένη κάλυψη payload | κανένα |
metadata |
συνάρτηση που επιστρέφει πρόσθετα πεδία | κανένα |
includeStack |
συμπερίληψη του stack trace | true |
Σειρά τοποθέτησης (Ordering)
Ενότητα με τίτλο «Σειρά τοποθέτησης (Ordering)»Τοποθετήστε το behavior έξω από retries (ώστε να καταγράφει αποτυχία μόνο μετά την εξάντλησή τους), και μέσα από το validation (ώστε αναμενόμενα validation errors να μην καταγράφονται).
Επαναπροώθηση (Redriving)
Ενότητα με τίτλο «Επαναπροώθηση (Redriving)»Το redriver ανακατασκευάζει το αίτημα από την εγγραφή, αντιστοιχίζοντας το record.requestName με τα ονόματα των κλάσεων στο requestTypes, το δρομολογεί, και επισημαίνει την εγγραφή ως επιλυμένη.
Πριν από τη δρομολόγηση, το redriver δεσμεύει την εγγραφή στο store. Ένα δεύτερο redrive της ίδιας εγγραφής, από την ίδια ή από άλλη διεργασία, απορρίπτεται με DeadLetterRedriveError και δεν δρομολογεί τίποτα. Η δέσμευση λήγει όταν τελειώσει το redrive. Αν η διεργασία σταματήσει κατά την εκτέλεση, η δέσμευση λήγει μετά από leaseMs (προεπιλογή: πέντε λεπτά)· ορίστε το leaseMs μεγαλύτερο από την πιο αργή εκτέλεση.
Το PostgresDeadLetterTransport κρατά τη δέσμευση στη στήλη claimed_until και το tenant του αποτυχημένου αιτήματος στη στήλη tenant_id. Εκτελέστε ξανά το createDeadLetterTableSql() για να προστεθούν οι στήλες σε πίνακα που δεν τις έχει. Το list({ tenantId }) επιστρέφει τις εγγραφές ενός tenant.
Η συνάρτηση dispatch εκτελείται στο context αυτού που καλεί το redrive. Όταν ο handler διαβάζει το tenant, επαναφέρετε το record.tenantId μέσα στη συνάρτηση dispatch πριν ξεκινήσει η εκτέλεση.