From 29deb9206dc459c1b8c52a2706e88fc1c0aff4a9 Mon Sep 17 00:00:00 2001 From: Matthias Hanel Date: Tue, 4 Feb 2020 11:41:21 -0500 Subject: [PATCH] Adding links, slight rewording, adding matcher example Signed-off-by: Matthias Hanel --- nats-concepts/intro.md | 3 +-- nats-concepts/reqreply.md | 2 +- nats-concepts/subjects.md | 2 +- 3 files changed, 3 insertions(+), 4 deletions(-) diff --git a/nats-concepts/intro.md b/nats-concepts/intro.md index dc202e9..14ac0e0 100644 --- a/nats-concepts/intro.md +++ b/nats-concepts/intro.md @@ -6,5 +6,4 @@ NATS makes it easy for programs to communicate across different environments, la ![](../.gitbook/assets/intro.svg) -NATS core offers an **at most once** quality of service. If a subscriber is not listening on the subject \(no subject match\), or is not active when the message is sent, the message is not received. This is the same level of guarantee that TCP/IP provides. By default, NATS is a fire-and-forget messaging system. If you need higher levels of service, you can use [NATS Streaming](../nats-streaming-concepts/intro.md) or build additional reliability into your client applications with proven and scalable reference designs. - +NATS core offers an **at most once** quality of service. If a subscriber is not listening on the subject \(no subject match\), or is not active when the message is sent, the message is not received. This is the same level of guarantee that TCP/IP provides. By default, NATS is a fire-and-forget messaging system. If you need higher levels of service, you can use [NATS Streaming](../nats-streaming-concepts/intro.md) or build additional reliability into your client applications with proven and scalable reference designs such as [acks](acks.md) and [sequence numbers](seq_num.md). diff --git a/nats-concepts/reqreply.md b/nats-concepts/reqreply.md index 38b3e80..eefbbbd 100644 --- a/nats-concepts/reqreply.md +++ b/nats-concepts/reqreply.md @@ -2,7 +2,7 @@ Request-Reply is a common pattern in modern distributed systems. A request is sent and the application either waits on the response with a certain timeout or receives a response asynchronously. The increased complexity of modern systems requires features such as location transparency, scale up and scale down, observability and more. Many technologies need additional components, sidecars and proxies to accomplish the complete feature set. -NATS supports this pattern with its core communication mechanism, publish and subscribe. A request is published on a given subject with a reply subject, and responders listen on that subject and send responses to the reply subject. Reply subjects are usually a subject called an \_INBOX that will be directed back to the requestor dynamically, regardless of location of either party. +NATS supports this pattern with its core communication mechanism, publish and subscribe. A request is published on a given subject with a reply subject, and responders listen on that subject and send responses to the reply subject. Reply subjects are unique subjects called _inbox_ that are dynamically directed back to the requestor, regardless of location of either party. NATS allows multiple responders to run and form dynamic queue groups for transparent scale up. The ability for NATS applications to drain before exiting allows scale down with no requests being dropped. And since NATS is based on publish-subscribe, observability is as simple as running another application that can view requests and responses to measure latency, watch for anomalies, direct scalability and more. diff --git a/nats-concepts/subjects.md b/nats-concepts/subjects.md index dc8634b..2af8b1e 100644 --- a/nats-concepts/subjects.md +++ b/nats-concepts/subjects.md @@ -40,4 +40,4 @@ Subject to your security configuration, wildcards can be used for monitoring by ### Mix Wildcards -The wildcard `*` can appear multiple times in the same subject. Both types be used as well. For example, `*.*.*.>` will receive `time.us.east.atlanta` as it is at least 4 tokens long. \ No newline at end of file +The wildcard `*` can appear multiple times in the same subject. Both types be used as well. For example, `*.*.east.>` will receive `time.us.east.atlanta`. \ No newline at end of file