Release Notes
NATS Concepts
Using NATS
Running a NATS service
Reference
What is NATS
NATS is what is called "message oriented middleware", meaning that it is a software infrastructure providing the exchange of data that is segmented into messages among computer applications and services.
NATS allows Application developers to easily and simply create distributed scalable client-server applications and generally store and distribute in real-time data between applications across different environments, languages, cloud providers and on-premise systems
NATS Client Applications
Developers use one of the NATS client libraries in their application code to allow them to publish, subscribe, request and reply between instances of the application or between completely separate applications. Those applications are generally referred to as 'client Applications' or sometimes just as 'clients' (as they are clients from the NATS servers' point of view) throughout this manual.
NATS Service Infrastructure
The NATS services are provided by one or more NATS server processes that are configured to interconnect with each other and provide a NATS service infrastructure. The NATS service infrastructure can scale from a single NATS server process running on an end device (the
nats-server process is less than 20 MB in size!) all the way to a public global super-cluster of many clusters spanning all major cloud providers and all regions of the world such as Synadia's NGS.Connecting NATS Client applications to the NATS servers
In order for a NATS client application to connect to the NATS service, and then subscribe or publish messages to subjects, it only needs to be configured with:
- 1.A 'NATS URL' which is a string (in a URL format) that specifies the IP address and port where the NATS server(s) can be reached, and what kind of connection to establish (plain TCP, TLS, or Websocket)
- 2.When required, authentication details for the application to identify itself with the NATS server(s), NATS supports multiple authentication schemes (username/password, decentralized JWT, token, TLS certificates and Nkey with challenge)
Messages and Publish-Subscribe
NATS makes it easy for applications to communicate by sending and receiving messages. These messages are addressed by subjects and do not depend on network location.
Data is encoded and framed as a message and sent by a publisher. The message is received, decoded, and processed by one or more subscribers.
With this simple design, NATS lets programs share common message-handling code, isolate resources and interdependencies, and scale by easily handling an increase in message volume, whether those are service requests or stream data.
Qualities of service
NATS offers multiple qualities of service depending on whether the application uses just the Core NATS functionality or also leverages the added functionalities enabled by NATS JetStream (JetStream is built into
nats-server but may not be enabled on all service infrastructures).Core NATS 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. Core NATS is a fire-and-forget messaging system, will only hold messages in memory and will never write messages directly to disk.
If you need higher qualities of service (at least once and exactly once), or functionalities such as persistent streaming, de-coupled flow control, and Key/Value Store, you can use NATS JetStream, which is built in to the NATS server (but needs to be enabled). Of course, you can also always build additional reliability into your client applications yourself with proven and scalable reference designs such as acks and sequence numbers.
Last modified 10d ago
Export as PDF
Copy link
Edit on GitHub