README.md

GrafanaCon LA 2019 IoT Workshop

This project is a demonstration of how to monitor temperature and humidity using an ESP32 Pico board and DHT11 sensor, and store that data in a TSDB so it can be graphed with Grafana.

Presentation

https://docs.google.com/presentation/d/1_UPUbFjVLKdW6VeS-KdOSBvoTSDJDRgiEMtXPMg3ULw/edit?usp=sharing

Hardware

• ESP32 Pico Kit
• DHT11 or DHT22 Sensor
• Hookup wires
• USB Power supply

Serial Port Driver

You may need to manually install the driver for the USB to serial adapter if it doesn't show up automatically when you plug in the ESP32

• https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers

Arduino IDE Setup

• Arduino IDE
• ESP32 Arduino Core

Required Libraries

• Adafruit DHT Sensor Library
• Adafruit Unified Sensor Library
• NTPClient Library

Download project into your Arduino sketchbook folder

• git clone https://github.com/DanCech/IoTWorkshop.git, or
• Download Zip & extract it

Config file

• Copy config.h.example to config.h
• Fill in WiFi connection details
• Set timezone offset for formatted dates
• Set a unique name for this sensor
• Adjust reporting interval if required

How to get the root CA cert: https://techtutorialsx.com/2017/11/18/esp32-arduino-https-get-request/

Hosted Metrics

• Sign up at https://grafana.com/loki#get
• Create an API Key with MetricsPublisher role and add it to the config file
• Go to the details page for your hosted metrics Graphite instance and get the instance id
• Set that as HM_GRAPHITE_INSTANCE

Hosted Grafana

• Log in to your instance
• Import the dashboard from https://grafana.com/dashboards/9848
• Select your hosted metrics Graphite instance when prompted