![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/04\/ESP32-Getting-Started-with-InfluxDB.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nUpdated 14 May 2024<\/em><\/p>\n\n\n\n We have a similar tutorial for the ESP8266 NodeMCU board: Getting Started with InfluxDB<\/a><\/p>\n\n\n\n Table of Contents<\/strong><\/p>\n\n\n\n InfluxDB is an open-source high-performance time series database (TSDB) that can store large amounts of data per second. Each data point you submit to the database is associated with a particular timestamp. So, it is ideal for IoT datalogging projects like storing data from your weather station sensors.<\/p>\n\n\n\n You can run InfluxDB in InfluxDB Cloud<\/a>, or locally on your laptop or Raspberry Pi<\/a>.<\/p>\n\n\n\n “Why use InfluxDB Cloud?<\/strong> It’s a fast, elastic, serverless real-time monitoring platform, dashboarding engine, analytics service and event and metrics processor.”<\/p>\nhttps:\/\/www.influxdata.com\/products\/influxdb-cloud\/<\/cite><\/blockquote>\n\n\n\n Before getting started, there are some important terms you need to understand. We’ll just take a look at the most relevant terms, you can read the complete glossary<\/a>. Don’t worry if some of the terms are confusing. You’ll better understand those terms when you start writing to the database.<\/p>\n\n\n\n In InfluDB, a bucket<\/strong> is named location where the time series data is stored. All buckets have a retention period<\/strong>\u2014it defines the duration of time that a bucket retains data. Points with timestamps older than the retention period are dropped.<\/p>\n\n\n\n Data in InfluxDB is stored in tables within rows and columns. A set of data in a row is known as point<\/strong> (similar to a row in a SQL database table). Each point has a measurement<\/strong>, a tag set<\/strong>, a field key<\/strong>, a field value<\/strong>, and a timestamp<\/strong>;<\/p>\n\n\n\n Columns store tag sets<\/strong> (indexed) and fields sets<\/strong>. The only required column is time<\/strong>, which stores timestamps <\/strong>and is included in all InfluxDB tables.<\/p>\n\n\n\n We also recommend taking a quick look at the InfluxDB key concepts<\/a>.<\/p>\n\n\n\n If you want to run InfluxDB locally on a Raspberry Pi, follow the next tutorial first: Install InfluxDB 2 on Raspberry Pi<\/a>. Then, proceed to the Loading Data in InfluxDB<\/a> section.<\/p>\n\n\n\n 1) <\/strong>Go to https:\/\/cloud2.influxdata.com\/signup<\/a> and create an InfluxDB account.<\/p>\n\n\n 2)<\/strong> Select where you want to save your data. Choose the place closer to your location. Insert a name for the Company and Organization.<\/p>\n\n\n 3)<\/strong> Select the InfluxDB plan. For this example, we’ll be using the Free plan. For most of our IoT projects, the Free plan works just fine. <\/p>\n\n\n 4)<\/strong> Then, fill out the form to continue.<\/p>\n\n\n 5)<\/strong> Finally, you’ll be redirected to the resource center.<\/p>\n\n\n 6)<\/strong> Click on the Load Data<\/strong> icon and select Sources<\/strong>.<\/p>\n\n\n 7)<\/strong> Scroll down until you find the Arduino <\/strong>option under the Client Libraries<\/strong> section.<\/p>\n\n\n 8)<\/strong> Click on Initialize Client.<\/p>\n\n\n The page that opens allows you to create buckets, and it also shows some sample code to interface the ESP8266 or ESP32 boards with InfluxDB.<\/p>\n\n\n\n 9)<\/strong> Create a new bucket to store your data. Click on + Create Bucket<\/strong> to create a new bucket for this example. You can use the settings by default, or you can customize them.<\/p>\n\n\n 10)<\/strong> Get your InfluxDB URL* and other details you’ll need later. Scroll down to the Configure InfluxDB profile<\/em> snippet. Then, copy the INFLUXDB_URL<\/span>, INFLUXDB_TOKEN<\/span>, INFLUXDB_ORG<\/span>, and INFLUXDB_BUCKET<\/span>.<\/p>\n\n\n *<\/strong> if you’re running InfluxDB locally on a Raspberry Pi, the URL will be the Raspberry Pi IP address on port 8086. For example 192.168.1.106:8086<\/span>.<\/p>\n\n\n\n If you’ve followed the previous steps, InfluxDB Cloud has already created an API token that you can find in the snippet presented in the previous step. If you go to the Load Data icon and select API Tokens, you’ll find the previously generated API token.<\/p>\n\n\n On this page, you can generate a new API token if needed.<\/p>\n\n\n\n At this moment, you should have saved the following:<\/p>\n\n\n\n We’ll program the ESP32 using Arduino IDe, so make sure you have the ESP32 boards add-on installed:<\/p>\n\n\n\n Alternatively, you can use VS Code with the PlatformIO extension. Check the following tutorial to get started with VS Code + PlatformIO:<\/p>\n\n\n\n There is a library that makes it easy to interface the ESP32 with InfluxDB: the InfluxDB Arduino Client Library<\/a>. This library is also compatible with ESP8266 boards.<\/p>\n\n\n\n If you\u2019re using Arduino IDE, follow the next steps to install the library.<\/p>\n\n\n\n If you’re using VS Code with the PlatformIO extension, start by creating an Arduino project for your ESP32 board.<\/p>\n\n\n\n Then, click on the PIO Home<\/strong> icon and then select the Libraries tab<\/strong>. Search for \u201cinfluxdb<\/strong>\u201c. Select the ESP8266 Influxdb<\/strong> byt Tobias Sch\u00fcrg.<\/p>\n\n\n To show you how to save data to InfluxDB using the ESP32, we’ll take a look at one of the examples provided by the library. In your Arduino IDE, go to File > Examples > ESP8266 Infuxdb > Secure Write. Or simply copy the code below to your Arduino IDE.<\/p>\n\n\n View raw code<\/a><\/p>\n\n\n\n Before uploading the code to your board, you need to insert your network credentials, InfludDB URL, organization ID, and bucket name.<\/p>\n\n\n\n This example illustrates how to create a data point on the database with tags and fields. It saves the RSSI of the connected network (Wi-Fi strength between the ESP32 and your router) every 10 seconds.<\/p>\n\n\n\n Let’s take a quick look at how the code works.<\/p>\n\n\n\n First, it starts by including the required libraries. In this example, it uses the WiFiMulti<\/span> instead of the WiFi<\/span> library to connect the ESP32 to a network. It also defines the DEVICE<\/span> name depending on the selected board.<\/p>\n\n\n\n Note<\/strong>: the WiFiMulti<\/span> library allows the ESP32 to connect to the network with the best RSSI (received signal strength indicator) among a list of added networks. In this example, it only connects to one network.<\/p>\n\n\n\n Include the required InfluxDB libraries to e able to communicate with InfluxDB:<\/p>\n\n\n\n Insert your network credentials in the following variables so that the ESP32 can connect to the internet:<\/p>\n\n\n\n Insert the InfluxDB server URL on the following lines\u2014the one you’ve gotten in this step<\/a>:<\/p>\n\n\n\n Note: <\/strong> if you’re running InfluxDB locally on a Raspberry Pi, the URL will be the Raspberry Pi IP address on port 8086. For example 192.168.1.106:8086<\/span>.<\/p>\n\n\n\n Insert your InfluxDB token\u2014saved in this step<\/a>:<\/p>\n\n\n\n Add your InfluxDB organization name\u2014check this step<\/a>.<\/p>\n\n\n\n Finally, add your InfluxDB bucket name:<\/p>\n\n\n\n You must set your timezone accordingly to these instructions<\/a>. The easiest way is to check this table and copy your timezone from there<\/a>.<\/strong> In my case, it’s Lisbon timezone:<\/p>\n\n\n\n\n
What is InfluxDB?<\/h2>\n\n\n
![\"What](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/04\/influxdb-logo.png?resize=400%2C104&quality=100&strip=all&ssl=1\"){kind=logo}
<\/figure><\/div>\n\n\n\n
InfluxDB Key Terms<\/h3>\n\n\n\n
\n
\n
\n
\n
\n
\n
\n
Creating an InfluxDB Account<\/h2>\n\n\n\n
![\"Creating](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/04\/InfluxDB-create-account.png?resize=431%2C826&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"InfluxDB-set-up-account-organization\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/02\/set-up-influxdb-2.png?resize=750%2C804&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"InfluxDB](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/04\/Influx-DB-Select-Plan.png?resize=746%2C664&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"InfluxDB](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/05\/how-do-you-plan-use-influxdb.png?resize=750%2C743&quality=100&strip=all&ssl=1\")
<\/a><\/figure><\/div>\n\n\n![\"InfluxDB](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/05\/influxdb-resource-center.png?resize=750%2C461&quality=100&strip=all&ssl=1\")
<\/a><\/figure><\/div>\n\n\nLoading Data in InfluxDB<\/h2>\n\n\n\n
![\"InfluxDB](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/02\/influxdb-sources-1.png?resize=655%2C319&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"InfluxDB-Client-Libraries\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/05\/influxdb-client-libraries-arduino.png?resize=750%2C481&quality=100&strip=all&ssl=1\")
<\/a><\/figure><\/div>\n\n\n![\"InfluxDB](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/05\/influx-db-initialize-arduino-client.png?resize=750%2C565&quality=100&strip=all&ssl=1\")
<\/a><\/figure><\/div>\n\n\nCreating an InfluxDB Bucket<\/h3>\n\n\n\n
![\"InfluxDB](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/05\/influxdb-creating-bucket.png?resize=643%2C386&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nGetting InfluxDB URL and API Token<\/h3>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/02\/influxdb-details-arduino-client.png?resize=750%2C412&quality=100&strip=all&ssl=1\")
<\/a><\/figure><\/div>\n\n\nAPI Tokens<\/h3>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/05\/influxdb-api-token.png?resize=750%2C261&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n
\n\n\n\nInterfacing the ESP32 with InfluxDB<\/h2>\n\n\n\n
\n
\n
Install the InfluxDB Arduino Client Library<\/h3>\n\n\n\n
Installation \u2013 Arduino IDE<\/h4>\n\n\n\n
\n
![\"Install](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/05\/install-influxdb-library.png?resize=750%2C520&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nInstallation \u2013 VS Code<\/h4>\n\n\n\n
![\"Install](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/04\/Install-InfluxDB-library-VS-Code.png?resize=734%2C648&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nESP32 Save Data in InfluxDB<\/h3>\n\n\n\n
\/**\r\n * Secure Write Example code for InfluxDBClient library for Arduino\r\n * Enter WiFi and InfluxDB parameters below\r\n *\r\n * Demonstrates connection to any InfluxDB instance accesible via:\r\n * - unsecured http:\/\/...\r\n * - secure https:\/\/... (appropriate certificate is required)\r\n * - InfluxDB 2 Cloud at https:\/\/cloud2.influxdata.com\/ (certificate is preconfigured)\r\n * Measures signal level of the actually connected WiFi network\r\n * This example demonstrates time handling, secure connection and measurement writing into InfluxDB\r\n * Data can be immediately seen in a InfluxDB 2 Cloud UI - measurement wifi_status\r\n * \r\n * Complete project details at our blog: https:\/\/RandomNerdTutorials.com\/\r\n * \r\n **\/\r\n\r\n#if defined(ESP32)\r\n #include <WiFiMulti.h>\r\n WiFiMulti wifiMulti;\r\n#define DEVICE "ESP32"\r\n #elif defined(ESP8266)\r\n#include <ESP8266WiFiMulti.h>\r\n ESP8266WiFiMulti wifiMulti;\r\n #define DEVICE "ESP8266"\r\n#endif\r\n\r\n#include <InfluxDbClient.h>\r\n#include <InfluxDbCloud.h>\r\n\r\n\/\/ WiFi AP SSID\r\n#define WIFI_SSID "REPLACE_WITH_YOUR_SSID"\r\n\/\/ WiFi password\r\n#define WIFI_PASSWORD "REPLACE_WITH_YOUR_PASSWORD"\r\n\/\/ InfluxDB v2 server url, e.g. https:\/\/eu-central-1-1.aws.cloud2.influxdata.com (Use: InfluxDB UI -> Load Data -> Client Libraries)\r\n#define INFLUXDB_URL "REPLACE_WITH_YOUR_DATABASE_URL"\r\n\/\/ InfluxDB v2 server or cloud API token (Use: InfluxDB UI -> Data -> API Tokens -> Generate API Token)\r\n#define INFLUXDB_TOKEN "REPLACE_WITH_YOUR_TOKEN"\r\n\/\/ InfluxDB v2 organization id (Use: InfluxDB UI -> User -> About -> Common Ids )\r\n#define INFLUXDB_ORG "REPLACE_WITH_YOUR_ORG"\r\n\/\/ InfluxDB v2 bucket name (Use: InfluxDB UI -> Data -> Buckets)\r\n#define INFLUXDB_BUCKET "ESP32"\r\n\r\n\/\/ Set timezone string according to https:\/\/www.gnu.org\/software\/libc\/manual\/html_node\/TZ-Variable.html\r\n\/\/ Examples:\r\n\/\/ Pacific Time: "PST8PDT"\r\n\/\/ Eastern: "EST5EDT"\r\n\/\/ Japanesse: "JST-9"\r\n\/\/ Central Europe: "CET-1CEST,M3.5.0,M10.5.0\/3"\r\n#define TZ_INFO "WET0WEST,M3.5.0\/1,M10.5.0"\r\n\r\n\/\/ InfluxDB client instance with preconfigured InfluxCloud certificate\r\nInfluxDBClient client(INFLUXDB_URL, INFLUXDB_ORG, INFLUXDB_BUCKET, INFLUXDB_TOKEN, InfluxDbCloud2CACert);\r\n\/\/ InfluxDB client instance without preconfigured InfluxCloud certificate for insecure connection \r\n\/\/InfluxDBClient client(INFLUXDB_URL, INFLUXDB_ORG, INFLUXDB_BUCKET, INFLUXDB_TOKEN);\r\n\r\n\/\/ Data point\r\nPoint sensor("wifi_status");\r\n\r\nvoid setup() {\r\n Serial.begin(115200);\r\n\r\n \/\/ Setup wifi\r\n WiFi.mode(WIFI_STA);\r\n wifiMulti.addAP(WIFI_SSID, WIFI_PASSWORD);\r\n\r\n Serial.print("Connecting to wifi");\r\n while (wifiMulti.run() != WL_CONNECTED) {\r\n Serial.print(".");\r\n delay(500);\r\n }\r\n Serial.println();\r\n\r\n \/\/ Add tags\r\n sensor.addTag("device", DEVICE);\r\n sensor.addTag("SSID", WiFi.SSID());\r\n\r\n \/\/ Alternatively, set insecure connection to skip server certificate validation \r\n \/\/client.setInsecure();\r\n\r\n \/\/ Accurate time is necessary for certificate validation and writing in batches\r\n \/\/ For the fastest time sync find NTP servers in your area: https:\/\/www.pool.ntp.org\/zone\/\r\n \/\/ Syncing progress and the time will be printed to Serial.\r\n timeSync(TZ_INFO, "pool.ntp.org", "time.nis.gov");\r\n\r\n \/\/ Check server connection\r\n if (client.validateConnection()) {\r\n Serial.print("Connected to InfluxDB: ");\r\n Serial.println(client.getServerUrl());\r\n } else {\r\n Serial.print("InfluxDB connection failed: ");\r\n Serial.println(client.getLastErrorMessage());\r\n }\r\n}\r\n\r\nvoid loop() {\r\n \/\/ Store measured value into point\r\n sensor.clearFields();\r\n \/\/ Report RSSI of currently connected network\r\n sensor.addField("rssi", WiFi.RSSI());\r\n \/\/ Print what are we exactly writing\r\n Serial.print("Writing: ");\r\n Serial.println(client.pointToLineProtocol(sensor));\r\n \/\/ If no Wifi signal, try to reconnect it\r\n if (wifiMulti.run() != WL_CONNECTED) {\r\n Serial.println("Wifi connection lost");\r\n }\r\n \/\/ Write point\r\n if (!client.writePoint(sensor)) {\r\n Serial.print("InfluxDB write failed: ");\r\n Serial.println(client.getLastErrorMessage());\r\n }\r\n\r\n \/\/Wait 10s\r\n Serial.println("Wait 10s");\r\n delay(10000);\r\n}\r\n<\/code><\/pre>\n\tHow the Code Works<\/h2>\n\n\n\n
#if defined(ESP32)\n #include <WiFiMulti.h>\n WiFiMulti wifiMulti;\n #define DEVICE \"ESP32\"\n#elif defined(ESP8266)\n #include <ESP8266WiFiMulti.h>\n ESP8266WiFiMulti wifiMulti;\n #define DEVICE \"ESP8266\"\n#endif<\/code><\/pre>\n\n\n\n#include <InfluxDbClient.h>\n#include <InfluxDbCloud.h><\/code><\/pre>\n\n\n\n\/\/ WiFi AP SSID\n#define WIFI_SSID \"REPLACE_WITH_YOUR_SSID\"\n\/\/ WiFi password\n#define WIFI_PASSWORD \"REPLACE_WITH_YOUR_PASSWORD\"<\/code><\/pre>\n\n\n\n\/\/ InfluxDB v2 server url, e.g. https:\/\/eu-central-1-1.aws.cloud2.influxdata.com (Use: InfluxDB UI -> Load Data -> Client Libraries)\n#define INFLUXDB_URL \"REPLACE_WITH_YOUR_INFLUXDB_URL\"<\/code><\/pre>\n\n\n\n#define INFLUXDB_TOKEN \"REPLACE_WITH_YOUR_INFLUXDB_TOKEN\"<\/code><\/pre>\n\n\n\n#define INFLUXDB_ORG \"REPLACE_WITH_YOUR_INFLUXXDB_ORGANIZATION_ID\"<\/code><\/pre>\n\n\n\n#define INFLUXDB_BUCKET \"ESP32\"<\/code><\/pre>\n\n\n\nSetting your Timezone<\/h3>\n\n\n\n
#define TZ_INFO \"WET0WEST,M3.5.0\/1,M10.5.0\"<\/code><\/pre>\n\n\n\nInfluxDB Client<\/h3>\n\n\n\n