Logging MQTT Sensor Data

Most MQTT brokers don’t provide any mechanism for logging historical data for later analysis.

However due to the publish/subscribe nature of MQTT is is easy to monitor, and log a data stream or streams using an MQTT client.

In fact this method may in many circumstances better than logging the data on the broker/server especially when the broker is being shared.

Logging Methods

There are two common ways of storing sensor data.

  • A file
  • A Database

Generally logging to a text file is faster and easier than logging to a database.

However if the data needs to be queried at a later date then logging to a database makes this much easier.

ref Using a database for logging

Database Types

There are two database types to choose from

  • SQL – SQlite, MYSQL etc
  • NOSQL -MongoDB etc

refSQL or NoSQL

Sensor Data

Many sensors like state sensors (ON/OFF), temperature etc will fluctuate very little over the course of a day so does it makes sense to store the same sensor value every x seconds?

Take for example a light sensor that publishes its status every second.

After 1 hour it has published 3600 status messages.

If we assume that the light status hasn’t changed during that period then it doesn’t make much sense to store the 3600 status messages.

The only messages that need to be stored are changed messages.

With this method if our light changed state twice in the hour then we would store 2 messages.

Over a day assuming 20 state changes we would store 20 messages rather than 86,400(24*3600) messages.

Preferably it would be better if the sensor only sent changes as this would also reduce the network traffic.

However even if the sensor does send data a regular intervals regardless of state then it doesn’t make sense to store it.

Therefore a data logger should have the ability to only log changes.


1. The sensor needs to publish with the retain message flag set.

2. A sensor shouldn’t publish a timestamp with the sensor data if it needs to be logged.

If it does the message will appear to have changed and the data logger would need to take this into account.

MQTT Data and topics

MQTT data is organised in topics and if you are monitoring several  MQTT topics then you may want to log each topic stream to its own file rather than logging all topics to a single file.

Data Loggers

I have created several data loggers for logging IOT data and specifically MQTT data.

Simple Python MQTT Data logger Python script Logs data to text file as JSON encoded Data.

SQL MQTT data Logger  Python script which logs data to a sqlite database.

Simple MQTT Topic logger -Python script Logs data by topic to a text file as JSON encoded Data

Node-Red Data and Topic Logger- Node Red Flow with web user interface that lets you choose to log by topic or not.

Logging Data To a SQL Database with Node-Red-How to store data in a SQL database using SQlite

Resources and related tutorials

Please rate? And use Comments to let me know more


  1. Steve, brilliant work and easy to understand.

    I am working on a system to monitor several beehives (beeyards) collecting several physical units (such as weight, temperature, humidity, sound level, …). I will need the data (logging periode 1 year and longer) for analytics of the bee’s behavious in relation to weather (e.g. precipitation) and other circumstances. Hence historic data are important. SQlite seems to be the best choice, as my MQTT broker in running on a Raspberry PI.

    Rgds Christian

  2. You said that “A sensor shouldn’t publish a timestamp with the sensor data if it needs to be logged.” Why not? In my thinking, it seems almost elemental that you would want a timestamp from the sensor to accompany the sensor data, regardless of logging status.

    1. When logging sensor data you can choose to log only changes if you send a timestamp then the data always changes.
      So when looking at what data you send then you should also consider what you are doing with it. Even if you send the timestamp you could always ignore it when considering a change. The data logger available on the site doesn’t do this but you can always change that.
      When creating sensors being able to disable sending a time stamp would be useful as well as only sending data changes.

  3. Thanks for you project.

    is there a project which allows to visualize the information of the log files in a graphical interface?

    1. Hi
      No not at the moment but I will be doing a video on using node-red graphs to display both real time and stored data in a few weeks time as time permits.
      What programming language would you be using ? Python ?

  4. Hi Steve, your work is amazing. Your work helped me a lot. I am using this data logger with little modifications in my major project of IoT. I am building an IOT based system which gathers sensor data for monitoring activities of elderly people. Your explanation is also good.

Leave a Reply

Your email address will not be published. Required fields are marked *