1
0
mirror of https://github.com/taigrr/nats.docs synced 2025-01-18 04:03:23 -08:00
Derek Collison 99da6d13d0 Updates
Signed-off-by: Derek Collison <derek@nats.io>
2019-06-06 15:42:25 -07:00

1.4 KiB

Acknowledgements

In a system with at-most-once semantics, there are times when messages can be lost. If your application is doing request-reply it should use timeouts to handle any network or application failures. It is always a good idea to place a timeout on a requests and have code that deals with timeouts. When you are publishing an event or data stream, one way to insure message delivery is to turn it into a request-reply with the concept of an acknowledgement message, or ACKs. In NATS an ACK can simply be an empty message, a message with no payload.

digraph nats_request_reply { rankdir=LR

subgraph { publisher [shape=box, style="rounded", label="Publisher"]; }

subgraph { subject [shape=circle, label="Subject"]; reply [shape=circle, label="Reply"]; {rank = same subject reply} }

subgraph { sub1[shape=box, style="rounded", label="Subscriber"]; }

publisher -> subject [label="msg1"]; publisher -> reply [style="invis", weight=2]; subject -> sub1 [label="msg1"]; sub1 -> reply [label="ack"]; reply -> publisher; }

Because the ACK can be empty it can take up very little network bandwidth, but the idea of the ACK turns a simple fire-and-forget into a fire-and-know world where the sender can be sure that the message was received by the other side, or with a scatter-gather pattern, several other sides.