Seamlessly Integrating EMQX Cloud with the New Timescale Service
Table of Contents
Introduction
The need for efficient and scalable database solutions has become paramount in a world where data is growing unprecedentedly. Timescale, a well-known player in the time-series database industry, has recently made a significant announcement, transforming itself into a cloud company with a robust database product.
This blog will explore how EMQX Cloud, a leading MQTT cloud service, integrates seamlessly with the new Timescale service, providing a powerful and comprehensive solution for managing time series data.
Timescale: A Shift in Focus
Timescale has been recognized for its database expertise, particularly with its open-source PostgreSQL extension, TimescaleDB. However, with their recent transformation, Timescale has emerged as a cloud company, placing their cloud product, formerly known as Timescale Cloud, at the forefront of their offering. By embracing the cloud-first approach, Timescale aims to empower businesses with a scalable, reliable, and flexible infrastructure for managing their data.
EMQX Cloud: Seamless Integration for Timescale
EMQX Cloud, on the other hand, is a reputable MQTT cloud service that specializes in handling large-scale, real-time data streams. EMQX Cloud provides a one-stop O&M colocation and a unique isolated environment for MQTT services. In the era of the Internet of Everything, EMQX Cloud can help you quickly build industry applications and easily realize the collection, transmission, computation, and persistence of IoT data.
The integration between EMQX Cloud and the new Timescale service brings together the strengths of both platforms, providing a comprehensive solution for managing time series data. With EMQX Cloud's robust MQTT connectivity and Timescale's scalable, high-performance database capabilities, businesses can unlock the full potential of their time series data.
Key Benefits of Integrating EMQX Cloud with Timescale
- Scalability and Performance: Timescale's architecture enables horizontal scalability, allowing businesses to handle ever-growing data volumes effortlessly. EMQX Cloud complements this by efficiently processing and managing real-time data streams, ensuring optimal performance.
- Advanced Time Series Capabilities: By leveraging this powerful database technology, businesses can perform complex analytics and queries on their time series data. EMQX Cloud seamlessly integrates with TimescaleDB, providing a unified solution for storing and analyzing MQTT data.
- Simplified Data Management: Integrating EMQX Cloud and Timescale simplifies data management processes. With EMQX Cloud securely collecting and processing MQTT data, and Timescale storing and organizing this data, businesses can focus on extracting valuable insights rather than worrying about infrastructure management.
- Enhanced Reliability and Security: EMQX Cloud and Timescale prioritize reliability and security. EMQX Cloud ensures reliable message delivery, even in challenging network conditions, while Timescale provides robust security measures to protect sensitive time series data. Together, they offer a highly reliable and secure environment for critical IoT applications.
5 Steps to Integrate EMQX Cloud with Timescale
Now let's see how to get data from EMQX Cloud to the new Timescale service.
Step1: Create a Timescale Service
Login to the Timescale and click Create a Service page, select a Region and then click Create service
button:
Now, a new Timescale service has been created. You can download the cheatsheet to initiate your Timescale deployment.
Step 2: Create an EMQX Deployment
Creating a dedicated MQTT broker on EMQX Cloud is as easy as a few clicks.
Get an EMQX Cloud Account
Go to EMQX Cloud and click start free to register an account if you are new to EMQX Cloud.
Create an EMQX Cloud Dedicated Professional Deployment
Once logged in, click on "Cloud Console" under the account menu, and you will see the green button to create a new deployment.
Select Dedicated Edition.
Select the 'Profession', choose the 'N.Virginial’ region, and click the 'Create Now' button.
In just a few minutes, you will get a fully managed MQTT broker.
Step 3: Setup NAT Gateway for Your EMQX Cloud Deployment
Before setting up the Timescale integration, we need to enable the NAT gateway. By default, the MQTT broker is deployed in a private VPC, which can not send data to third-party systems over the public network.
There are two ways to resolve this:
- One is to enable the NAT gateway and allow the broker to send data to Timescale through that gateway.
- The other is to set up VPC peering, which depends on whether the target cloud service supports VPC peering.
In this tutorial, we will use the first solution.
Go to the VAS page and scroll down to the bottom, where you will see the NAT Gateway widget.
Click the Subscribe button and follow the instructions to create a NAT Gateway.
When the status of the NAT gateway is running, the deployment can access public network resources.
Step 4: Setup EMQX Cloud Data Integration with Timescale
EMQX Cloud offers more than 30 native data integrations with popular data systems. Timescale is one of them.
Create Timescale Resource
Click 'Data Integrations' on the left menu and 'View All Resouces'. You will find the TimescaleDB in the list.
Click the TimescaleDB card to create a new resource, then you will go to the resource configuration page:
- Server: this is the address of your Timscale service. Remember, don't forget the port.
- Database: The database name we created in the previous steps, and the default is 'tsdb'.
- User: the username for connecting to your Timescale service, and the default is 'tsdbadmin'.
- Password: the password for the connection, and you can find it in the cheatsheet file.
- Click the 'Test' button to ensure the database can be connected.
Create A New Rule
EMQX Cloud provides a powerful rule engine to transform and enrich the raw MQTT message before sending it to third-party systems. You can learn more info about the usage of the rule engine here.
During the resource creation, you will see a popup, and clicking 'New' will lead you to the rule creation page.
The SQL defines how to select data from specific MQTT topics and payload :
SELECT
timestamp div 1000 AS up_timestamp, clientid AS client_id, payload.temp AS temp, payload.hum AS hum
FROM
"temp_hum/emqx"
You can also test your SQL to see if anything is incorrect.
Then we create an 'Action' with the following script:
INSERT INTO temp_hum(up_timestamp, client_id, temp, hum) VALUES (to_timestamp(${up_timestamp}), ${client_id}, ${temp}, ${hum})
This defines how we insert data into the Timescale database; Now Click on the "NEXT" button to finish creating the Rule.
View Rules Details
Now, you can see a rule of Timescale data integration that defines how to insert data from the MQTT topic temp_hum/emqx
into your Timescalse database.
Step5: Verify Your Integration
Simulate an MQTT Client to Connect to EMQX Cloud via MQTTX
You can use any MQTT client or SDK to publish the message. In this tutorial, we will use MQTTX, a powerful MQTT client application provided by EMQ.
Click 'New Connection' on MQTTX and fill out the connection form:
- Name: Connection name. Use whatever name you want.
- Host: the MQTT broker connection address. You can get it from the EMQX Cloud overview page.
- Port: MQTT broker connection port. You can get it from the EMQX Cloud overview page.
- Username/Password: The username/password we defined in EMQX Cloud Authentication settings.
Publish MQTT Messages to EMQX Cloud
Set payload format to 'JSON'.
Set to topic:
temp_hum/emqx
(the topic we just set in the rule)JSON body:
{ "temp": "45.5", "hum": "27.5" }
Click the send button on the right. You can change the temperature value and send more data to the EMQX Cloud.
Check Rule Status in EMQX Cloud
The data sent to EMQX Cloud should be processed by the rule engine and inserted into Timescale automatically, and we can check it from the EMQX Cloud Data Integration dashboard:
Check the Data Persisted in Timescale
Now it's time to take a look at the data on the Timescale. Ideally, the data you send from MQTTX will go to the EMQX Cloud and persist to the Timescale database with data integration.
You can connect to the SQL console on the Timescale Console or use any client tool to fetch data from your timescale database.
Run SQL to query the specific table we defined in the EMQX Cloud data integration rule, and you can see the data has been inserted correctly.
Conclusion
The integration of EMQX Cloud with the new Timescale service brings together the power of real-time data streams and scalable time series database technology. By seamlessly connecting these two platforms, businesses can efficiently collect, store, and analyze their time series data, unlocking valuable insights and accelerating their digital transformation initiatives. The collaboration between EMQX Cloud and Timescale represents a significant step towards building a comprehensive ecosystem for managing and leveraging time series data in the cloud.