Capture and analyze NATS logs and metrics in Elasticsearch using the new NATS modules, contributed, and battle-tested by real-world NATS users in production.

<p>In a world where stateless applications are optimized to run blazingly fast, message exchanging cannot be allowed to affect their performance. Having the ability to <a href="https://hackernoon.com/want-a-super-fast-messaging-system-c19c9f8cf560">process millions of messages per second</a>, NATS is the sprinter of messaging systems.
</p><p>While benchmarks are good indicators for choosing a tool, there is no way to confirm its value without monitoring its performance in production. As a team working together in the telecommunications sector, we're building NFV solutions on top of Kubernetes microservices, and we're using NATS as a messaging system to ensure the resiliency of the critical paths. These include the communication between the software components running on the clients’ data centers and our centralized platforms. It has allowed us to achieve high rates of message exchanging with great reliability. In this regard, we need to assure its health by providing actionable visibility in real-time. Given the fact that we use <a href="https://docs.fluentd.org/v/0.12/articles/kubernetes-fluentd">EFK</a> to monitor our <a href="https://github.com/fluent/fluentd-kubernetes-daemonset/blob/master/fluentd-daemonset-elasticsearch-rbac.yaml">Kubernetes</a> stack, monitoring of NATS had to be achieved by the exact same way.
</p><p>Everything started with a goal: Ship NATS monitoring data to Elasticsearch.&nbsp;
</p><p>What we achieved: Extending Beats, by providing NATS modules for both <a href="https://www.elastic.co/guide/en/beats/metricbeat/7.0/metricbeat-module-nats.html">Metricbeat</a> and <a href="https://www.elastic.co/guide/en/beats/filebeat/master/filebeat-module-nats.html">Filebeat</a> shippers. Get on board to find out how!
</p><h2>Motivated by an internal hackathon</h2><p>We wanted results and we wanted them fast, but our internal backlog was full of requirements forcing our time to be very limited. Luckily, our company was organizing its annual hackathon. Without hesitation, we grabbed the opportunity to work on creating our own NATS Beat by leveraging the <a href="https://github.com/nfvsap/natsbeat">Beats extension mechanism</a>. After two days of effort our NATS Beat succeeded into becoming part of the official list of <a href="https://www.elastic.co/guide/en/beats/libbeat/current/community-beats.html">community Beats</a>. And that was only the beginning. Intrigued by the idea, the Elastic Beats team encouraged us to put our code into the core Beats project. With their support, we managed to develop a Metricbeat module for metrics collection, and a Filebeat module, for log aggregation. Today, NATS monitoring is deeply integrated into the core of Beats upstream.
</p><h2>How to monitor NATS</h2><p>NATS is very helpful when it comes to providing <a href="https://nats.io/documentation/managing_the_server/monitoring/">monitoring data</a>. If requested, NATS server can serve such data in JSON format by exposing four different HTTP endpoints:
</p><ul>
	<li>/varz: reports general statistics such as CPU utilization, memory consumption, etc.
	</li>
	<li>/connz: reports detailed information on client connections
	</li>
	<li>/routez: reports information on routes between servers of the NATS cluster
	</li>
	<li>/subz: reports detailed information about current subscriptions and the routing data structure</li>
</ul><p>By querying these endpoints in a periodic way, user can understand a lot about the running state of his messaging queue. And so we did with the brand new NATS module of Metricbeat.
</p><p>But NATS can provide more. Another interesting place to find useful information regarding monitoring is the server’s logs. If requested, NATS server can provide <a href="https://nats.io/documentation/server/gnatsd-logging/">TRACE level logs</a> for every message received or transmitted. These log entries can be proven really valuable if handled properly. Our NATS module for Filebeat did exactly that. Every log is parsed and all its meaningful bits are squeezed out of it.
</p><h2>NATS as a Metricbeat module</h2><p>As it happens with any Metricbeat module, NATS needs to be activated and configured accordingly in order to fetch the data from the monitoring endpoints. Upon configured properly, it fetches data from the endpoints, curates them accordingly and ships them to Elasticsearch.
</p><h3>Configuration
</h3><p>The module can be configured as simple as this:
</p><pre class="prettyprint">metricbeat.modules:
- module: nats
  metricsets: ["connections", "routes", "stats", "subscriptions"]
  period: 10s
  hosts: ["localhost:8222"]
  stats.metrics_path: "/varz"
  connections.metrics_path: "/connz"
  routes.metrics_path: "/routez"
  subscriptions.metrics_path: "/subsz"
  enabled: true
</pre><p>The above configuration provides the location of the NATS server(s) we want to monitor, the query interval for metrics, which metrics to fetch and the URIs under which they can be accessed.
</p><h3>Let the metrics speak</h3><p>Fetching the data is one thing. Sending them to Elasticsearch is another. But what is the value of storing them if you cannot visualize them? With that in mind, this module ships with a pre-built dashboard which can be loaded automatically from Beats and give a good starting point to the user.
</p><p>Let’s take a sneak peak:
</p><p><img src="https://images.contentstack.io/v3/assets/bltf7afce26b89a5b33/blt28de268fcb47839e/5cabacdbef14588e0283421b/download" data-sys-asset-uid="blt28de268fcb47839e" alt="nats-let-metrics-speak.png">
</p><p>Users&nbsp;can detect slow consumers which may affect NATS performance, monitor how NATS cache is performing, or even realize the utilization of resources made by our NATS servers. Additionally, users can correlate the stored data according to their needs and extend the dashboard. It is in their&nbsp;hands!
</p><h2>NATS as a Filebeat module</h2><p>After making Metricbeat module a reality, a brilliant idea was put on the table: Is there something we could do for NATS server logs? The answer was standing in front of us… Filebeat!
</p><p>And so we did. Filebeat is an agent dedicated to fetching logs, parsing them with a wide range of text processors, and creating docs out of them in an Elasticsearch index. But to go far you need to start simple. Our very first version of NATS module was just extracting log timestamp, level, and message, and putting them into the datastore. The second version though is taking it to the next level. After investigating all log patterns we processed the log messages even more. The outcome is far more interesting, it can be visualized and it can offer a much deeper understanding of the NATS cluster’s state
</p><h3>Configuration</h3><p>Filebeat module can be configured as the Metricbeat module by adding the following lines to the configuration file:
</p><pre class="prettyprint">filebeat.modules:
- module: nats  
  log:
    enabled: true
    var.paths:
      - /var/log/nats/nats.log*
</pre><p>As it can be easily observed, apart from enabling the module, the only configurable field a user has to set is a list of log path regular expressions. Given the location of the logs, NATS module has everything it needs to start scraping data from them.
</p><h3>Logs as a Dashboard (LAAD)</h3><p>As the title implies, NATS module gives the opportunity to visualize the logs that the user's NATS cluster is producing. With the pre-built dashboard accompanying the module and the log trace option enabled to NATS server, user can come up with a dashboard as interesting as the following:
</p><p><img src="https://images.contentstack.io/v3/assets/bltf7afce26b89a5b33/blt3a5a663088e662c6/5cabacaa051f0ba57b53c4d5/download" data-sys-asset-uid="blt3a5a663088e662c6" alt="nats-logs-as-a-dashboard-filebeat-1.png">
</p><p>Filebeat dashboard can provide various forms of data and statistics. Users can observe the distribution of messages by its type, the heat received by the NATS subjects, and the type of logs produced in a timeline. Furthermore, users have a good indicator on messages’ traffic, both incoming and outgoing, as well as the IP range distribution of the clients. The most interesting part: All of the above can happen with a click of a button!
</p><h3>At the end of the day</h3><p>All in all, time invested on this effort was definitely worth it. Not only did we solve our problem of NATS monitoring, which could be achieved with only the community Beat, but we also gained a lot of experience on the way. We had the chance to work with excellent engineers from Elastic and we felt the joy of giving back to the community. So it goes without saying that we enjoyed that and we would suggest such kind of contributions to everyone who faces similar situations.
</p><p>Are you a NATS user?&nbsp; Download <a href="https://www.elastic.co/downloads/beats/metricbeat">Metricbeat</a> 7.0 and build <a href="https://www.elastic.co/downloads/beats/filebeat">Filebeat</a>&nbsp;master branch, enable the NATS modules, and start looking under the covers to see what you can discover about your NATS environment.&nbsp;
</p><hr><div>
	<p><img src="https://images.contentstack.io/v3/assets/bltf7afce26b89a5b33/bltdd3ec6d6a9397204/5cabb848ef14588e0283427f/download" data-sys-asset-uid="bltdd3ec6d6a9397204" alt="stamatis-katsaounis.png" width="100" style="width: 100px; float: left; margin: 10px;"><strong><em>Stamatis Katsaounis&nbsp;</em></strong><em>is a software engineer, focused mainly on the Cloud. He is an active member of the OPNFV community with contributions to various OPNFV projects. He experiments with OpenStack and Kubernetes deployments and is a Linux enthusiast. He speaks C, Bash and Python. Lately, he is a frequent visitor of Go playground</em>.
	</p>
</div><div>
	<p><img src="https://images.contentstack.io/v3/assets/bltf7afce26b89a5b33/bltb63f1699387ac50a/5cabb8978f70e39878691c08/download" data-sys-asset-uid="bltb63f1699387ac50a" alt="michael-katsoulis.jpg" width="100" style="width: 100px; float: left; margin: 10px;"><strong><em>Michael Katsoulis</em></strong><em> is a cloud software engineer, backed with working knowledge in telecommunications systems, currently focusing in SDN/NFV area. Leveraging Linux power and open source tools he always tries to combine work in internal projects with open source contributions.</em>
	</p>
</div><div>
	<p><br><strong><em>Christos Markou</em></strong><em> is a systems and software engineer that's passionate about distributed systems and cloud technologies. He has hands-on experience in web services, cloud computing and large system architecture, and is an open source enthusiast with various contributions in high class projects.</em>
	</p>
</div>

cloud-computing-nats-full-bleed.jpg

nats-logs-as-a-dashboard-filebeat-thumbnail.png

Monitoring a NATS messaging system with Beats

Start free trial

Blog Footer CTA

Sign up for Elastic Cloud free trial

Stamatis Katsaounis

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-terms" target="_self">Terms of Service</a>, and you agree to receive the <a href="/legal/privacy-statement#how-we-use-the-information" target="_self">selected communications</a> at the contact details you provided above. See <a href="/legal/privacy-statement/" target="_self">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p>

Communication Preferences - ONLY for /communication-preferences

<p>En confirmant votre envoi, vous reconnaissez que vous avez lu et que vous acceptez nos <a href="/fr/legal/elastic-cloud-account-terms" target="_self">Conditions générales d'utilisation</a>, et vous acceptez de recevoir les <a href="/fr/legal/privacy-statement#how-we-use-the-information" target="_self">types de notification sélectionnés</a> à l'adresse que vous avez fournie plus haut. Pour en savoir plus ou pour revenir sur votre décision (possible à tout moment), consultez la <a href="/fr/legal/privacy-statement/" target="_self">Déclaration de confidentialité d'Elastic</a>.</p>

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-terms" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p><p>By submitting this form, I agree to Elastic sharing my contact information with Google Cloud. I also agree to Elastic giving my information to the vendor for the purpose of shipping my food package.</p>

GDPR Text + Google Cloud

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/serverless-preview-terms" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p>

Serverless GDPR Text

<p>En confirmant votre envoi, vous reconnaissez que vous avez lu et que vous acceptez nos <a href="/fr/legal/serverless-preview-terms" target="_self">Conditions générales d'utilisation</a>, et vous permettez à Elastic de <a href="/fr/legal/privacy-statement#how-we-use-the-information" target="_self">vous contacter</a> à propos de produits et services similaires en utilisant les informations que vous avez fournies plus haut. Pour en savoir plus ou pour revenir sur votre décision (possible à tout moment), consultez la <a href="/fr/legal/privacy-statement/" target="_self">Déclaration de confidentialité d'Elastic</a>.</p>

<p>By submitting you agree to <a href="/agreements/global/cloud-services-monthly" rel="nofollow">Elastic Cloud Terms of Service</a>. Your personal data will be processed in accordance with <a href="/legal/privacy-statement">Elastic's Privacy Statement</a>.</p>

Cloud Trial GDPR Text

<p>En envoyant votre demande d'inscription, vous acceptez les <a href="/fr/agreements/global/cloud-services-monthly" rel="nofollow">conditions générales d'utilisation d'Elastic Cloud</a>. Vos données personnelles seront traitées conformément à la <a href="/fr/legal/privacy-statement">déclaration de confidentialité d'Elastic</a>.
</p>

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/terms-of-use" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p>

Newsletter GDPR Text

<p>En confirmant votre envoi, vous reconnaissez que vous avez lu et que vous acceptez nos <a href="/fr/legal/terms-of-use" target="_self">Conditions générales d'utilisation</a>, et vous permettez à Elastic de <a href="/fr/legal/privacy-statement#how-we-use-the-information" target="_self">vous contacter</a> à propos de produits et services similaires en utilisant les informations que vous avez fournies plus haut. Pour en savoir plus ou pour revenir sur votre décision (possible à tout moment), consultez la <a href="/fr/legal/privacy-statement/" target="_self">Déclaration de confidentialité d'Elastic</a>.</p>

Explore similar demos

Overview

You'll also receive an email with related content.

You'll also receive an email with related content

Nous vous enverrons plus de contenu susceptible de vous intéresser.

Speakers

Close

The content on this page is not available in the selected language. As Elastic grows globally, we continue to support content in multiple languages.

The content on this page is not available in the selected language.

Le contenu de cette page n'est pas disponible dans la langue sélectionnée. Chez Elastic, nous mettons tout en œuvre pour vous proposer du contenu dans différentes langues. En attendant, nous vous remercions de votre patience !

See more insights

Articles by

Author

Learn more

Watch now (no PT)

Watch now

See all top stories

All (no PT translation)

Contact information

Press Release

Share on Reddit

Share this story

Share by Email

Thank you for your interest!

Contact Info

Follow us on Youtube

Load More

Share on LinkedIn

Follow us on LinkedIn

Search Integrations

All Solutions

Video for

Follow us on Twitter

See when this webinar starts in my time zone

Voir à quelle heure débute le webinar dans mon fuseau horaire

Register to Watch

Register now

See All Posts

Can't make it? Register and we'll send you the recording. You'll also receive an email with related content

Si vous ne pouvez pas vous libérer le jour J, inscrivez-vous et nous vous enverrons l'enregistrement. Vous recevrez aussi un e-mail contenant des ressources connexes.

Small image for

On-demand webinar

Featured webinar

Register to Attend

Share on Facebook

Reset all

Upcoming webinar

View more posts

Print

Hosted by

Sign In to Attend

View next

Follow us on Facebook

Share

Highlights

Read less

Thank you for registering. We will send you a confirmation email soon.

Nous vous remercions de votre inscription. Vous allez recevoir un e-mail de confirmation.

Author

Articles by Stamatis Katsaounis

Monitoring a NATS messaging system with Beats

Sign up for Elastic Cloud free trial