https://github.com/macielti/wraith-king
Microservice responsible for dead-letter queue
https://github.com/macielti/wraith-king
Last synced: 4 months ago
JSON representation
Microservice responsible for dead-letter queue
- Host: GitHub
- URL: https://github.com/macielti/wraith-king
- Owner: macielti
- License: other
- Created: 2022-05-24T13:50:39.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-09-16T14:21:07.000Z (almost 2 years ago)
- Last Synced: 2024-12-29T23:49:44.891Z (6 months ago)
- Language: Clojure
- Size: 181 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Wraith King
A Dota 2 hero that self-resurrecting ultimate ensures he'll have another chance to swing his sword
– https://www.dota2.com/hero/wraithking
## DLQs
Kafka messages that for some reason/problem couldn't be consumed, these messages are added to the DLQ queue were you are
able to check the stack-trace from the root cause for the message not being consumed, from that you can decide if you
want to replay the message and the consumer service will try to process it one more time. We should have in mind that
when using DLQs the consumers need to support process messages in any order without affecting bussiness logic.
## Database Entities
`dead-letter`:
- `topic` (the topic to where the original message was going)
- `exception-info` (the stack trace when that accused the problem while consuming the message)
- `payload` (the body wof the dead-letter message)
- `service` (name of the service from where the DQL was raised)
- `created-at` (when the dead-letter arrived)
- `updated-at` (when the last update was made to the entity)
- `replay-count` (number of times that the message was replayed)
- `status` (informs about the status of the dead-letter, if it's ":unprocessed", ":processed", or ":dropped")
## Kafka Consumers
`"create-dead-letter"` (A global topic that is used to create new dead-letter entity, so we can reproduce the message
later)
## Endpoints
- **[POST]** "api/dead-letters/:id" (replay dead-letter)
- **[DELETE]** "api/dead-letters/:id" (drop dead-letter)
- **[GET]** "api/dead-letters" (get unprocessed dead-letter list of id's)
- **[GET]** "api/dead-letters/:id" (get dead-letter info)
## License
Copyright © 2022 Bruno do Nascimento Maciel
This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which
is available at
http://www.eclipse.org/legal/epl-2.0.
This Source Code may also be made available under the following Secondary Licenses when the conditions for such
availability set forth in the Eclipse Public License, v. 2.0 are satisfied: GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or (at your option) any later version, with the GNU
Classpath Exception which is available at https://www.gnu.org/software/classpath/license.html.