สร้าง Dashboard ด้วย Grafana และ InfluxDB ด้วย Docker บน Ubuntu

ในบทความนี้เราจะมาสร้าง Dashboard ด้วย Grafana และ InfluxDB ด้วย Docker บน Ubuntu กัน !!! ก่อนอื่นเรามาทำความรู้จักกับ Grafana และ InfluxDB กันก่อนครับ และเราจะใช้ Docker ในการสร้าง Container ของ Grafana และ InfluxDB

ทำความรู้จักกับ Grafana และ InfluxDB

Grafana

Grafana

เป็นแพลตฟอร์มที่ใช้ในการสร้างแดชบอร์ด (dashboard) สำหรับการแสดงผลข้อมูลจากแหล่งข้อมูลหลายๆ แห่ง มีความสามารถในการสร้างภาพกราฟิกส์แบบต่างๆ ไม่ว่าจะเป็นกราฟเส้น กราฟแท่ง แผนภูมิ และแผนที่

InfluxDB

InfluxDB

เป็นฐานข้อมูลที่ออกแบบมาเพื่อการจัดเก็บและจัดการข้อมูลที่เกิดขึ้นตามเวลา (time series data) โดยเฉพาะ ไม่ว่าจะเป็นข้อมูลจากเซนเซอร์, log data, หรือ metrics จากระบบคอมพิวเตอร์ InfluxDB มีความสามารถในการจัดการข้อมูลจำนวนมหาศาลได้อย่างรวดเร็วและมีประสิทธิภาพ

Note

InfluxDB มีภาษา query ของตัวเองที่คล้ายกับ SQL ทำให้ง่ายต่อการใช้งานและการเรียนรู้

ตัวอย่างภาษา query ของ InfluxDB

  • เราสามารถเลือกข้อมูลในช่วงเวลาที่ต้องการ เช่น ข้อมูลอุณหภูมิในช่วง 24 ชั่วโมงที่ผ่านมา
เลือกข้อมูลจากช่วงเวลาที่กำหนด
SELECT * FROM temperature WHERE time > now() - 24h
  • เราสามารถใช้ฟังก์ชันเชิงรวมเพื่อคำนวณค่าเฉลี่ย, ค่าสูงสุด, หรือต่ำสุดของข้อมูลได้ เช่น คำนวณค่าเฉลี่ยของอุณหภูมิในช่วง 24 ชั่วโมงที่ผ่านมา
Aggregate Function
SELECT MEAN(value) FROM temperature WHERE time > now() - 24h
  • เราสามารถจัดกลุ่มข้อมูลตามเวลาเพื่อดูการเปลี่ยนแปลงของข้อมูลในแต่ละช่วงเวลา เช่น ค่าเฉลี่ยของอุณหภูมิทุกๆ 1 ชั่วโมง ในช่วง 24 ชั่วโมงที่ผ่านมา
Group by time
SELECT MEAN(value) FROM temperature WHERE time > now() - 24h GROUP BY time(1h)

ตัวอย่างภาษา query ของ InfluxDB รูปแบบ Flux

  • Flux เป็นภาษา query ใหม่ของ influxdb
Flux Query
from(bucket: "mydb/autogen")
  |> range(start: -1h)
  |> filter(fn: (r) => r._measurement == "cpu")
  |> filter(fn: (r) => r.cpu == "cpu-total")
  |> aggregateWindow(every: 1m, fn: mean, createEmpty: false)
  |> yield(name: "mean")
Note

query นี้ดึงข้อมูลจาก bucket mydb/autoge ในช่วง 1 ชั่วโมงที่ผ่านมา โดยกรองข้อมูลที่มี _measurement เป็น "cpu" และ cpu เป็น "cpu-total" จากนั้นคำนวณค่าเฉลี่ยทุก ๆ 1 นาที และส่งผลลัพธ์ออกมาด้วยชื่อ "mean"

ขั้นตอนการติดตั้ง

อัปเดตแพคเกจของ Ubuntu

sudo apt-get update && sudo apt-get upgrade

ติดตั้ง Docker บน Ubuntu

  • Set up apt repository
# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
 
# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
  • ติดตั้ง Docker packages
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  • ตรวจสอบการติดตั้ง Docker
sudo docker --version
Note

ถ้าหากใช้คำสั่ง sudo docker --version แล้วขึ้นเลขเวอร์ชันของ Docker แสดงว่าการติดตั้งสำเร็จ

การติดตั้ง และสร้างไฟล์ Docker Compose

  • ติดตั้ง Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
  • ตรวจสอบการติดตั้ง Docker Compose
docker-compose --version
  • สร้างไฟล์ docker-compose.yml ด้วยคำสั่ง
touch docker-compose.yml
  • แก้ไขไฟล์ docker-compose.yml ด้วยโปรแกรมที่ต้องการ เช่น nano, vim, หรือ Visual Studio Code
nano docker-compose.yml
  • แก้ไขไฟล์ docker-compose.yml ด้วยโค้ดด้านล่าง
docker-compose.yml
version: '3.1'
 
services:
  influxdb:
    image: influxdb:latest
    container_name: influxdb
    ports:
      - "8086:8086"
    environment:
      - INFLUXDB_DB=mydatabase
      - INFLUXDB_ADMIN_USER=admin
      - INFLUXDB_ADMIN_PASSWORD=adminpassword
    volumes:
      - influxdb-data:/var/lib/influxdb
 
  grafana:
    image: grafana/grafana:latest
    container_name: grafana
    ports:
      - "3000:3000"
    environment:
      - GF_SECURITY_ADMIN_USER=admin
      - GF_SECURITY_ADMIN_PASSWORD=adminpassword
    volumes:
      - grafana-data:/var/lib/grafana
 
volumes:
  influxdb-data:
  grafana-data:

รัน Container ด้วย Docker Compose

  • รันคำสั่งเพื่อสร้าง Container จากไฟล์ docker-compose.yml
sudo docker-compose up -d
Note

-d คือคำสั่งที่ใช้ในการรัน Container ในโหมด background (จะรัน Container ตลอดเวลา)

  • กำลัง Download pulling images

การตั้งค่า InfluxDB

  • หลังจากที่ Container ของ InfluxDB รันเสร็จแล้ว ให้เข้าไปที่ http://localhost:8086 หรือ http://server-ip:8086 ในเว็บเบราวเซอร์

InfluxDB

  • ตั้งค่า Username, Password, Organization, Bucket

Create Bucket

  • เมื่อตั้งค่าเสร็จแล้ว คุณจะได้ API Token มา ให้เก็บไว้เพื่อใช้ในการเชื่อมต่อกับ Grafana

API Token

การตั้งค่า Grafana

  • เข้าไปที่ http://localhost:3000 หรือ http://server-ip:8086 ในเว็บเบราวเซอร์ แล้วเข้าสู่ระบบด้วยข้อมูลผู้ใช้ admin และรหัสผ่าน adminpassword ที่ได้กำหนดไว้ในไฟล์ docker-compose.yml

Login Grafana

เพิ่ม Data Source

  • ให้ไปที่ Connection -> Data Source แล้วเลือก InfluxDB

Data Source

  • เลือก Query Language เป็น Flux

Query Language

  • ตั้งค่า URL ให้เป็น http://localhost:8086 หรือ http://server-ip:8086

URL

  • เปิดใช้งาน Basic Auth และกรอก Username และ Password ให้ตรงกับที่ได้ตั้งค่าใน docker-compose.yml

Basic Auth

  • กรอกข้อมูล Organization, Bucket, Token ที่ได้จากการตั้งค่า InfluxDB

InfluxDB Details

  • คลิก Save & Test เพื่อทดสอบการเชื่อมต่อ

Save & Test

Note

ถ้าหากขึ้นข้อความ Data source is working แสดงว่าการเชื่อมต่อสำเร็จ !!!

สร้าง Dashboard

สร้าง Dashboard ใหม่

  • ให้ไปที่เมนู Dashboards -> Create Dashboard

Create Dashboard

  • กด Add visualization เพื่อเพิ่มกราฟ และเลือก Data Source ที่เราตั้งค่าไว้

Add Visualization

  • ช่องสำหรับเขียน Query เพื่อดึงข้อมูลจาก InfluxDB มาแสดงผลเป็นกราฟ

Query

เพิ่มข้อมูลใน InfluxDB เพื่อทดสอบ

  • หลักจากที่เราได้ตั้งค่าทุกอย่างเสร็จเรียบร้อยแล้ว ให้เข้าไปที่ http://localhost:8086 หรือ http://server-ip:8086 ในเว็บเบราวเซอร์ เพื่อเข้าไปเพิ่มข้อมูลใน InfluxDB ของเรากัน
  • ตอนนี้ Bucket ของเราจะว่างเปล่าอยู่ ให้เราเพิ่มข้อมูลเข้าไปเพื่อนำไปแสดงผลใน Grafana

ให้กดที่ Data Explorer แล้วเลือก Bucket ที่เราตั้งค่าไว้ และกดไปที่ Script Editor

Data Explorer

  • ใช้สคริปต์ Flux เพื่อเพิ่มข้อมูลจำลองเข้าไปใน Bucket ของเรา
Flux Script
import "experimental"
import "array"
 
data = array.from(rows: [
  {_time: experimental.addDuration(d: -10m, to: now()), _measurement: "measurement", tag1: "value1", _field: "field1", _value: 1},
  {_time: experimental.addDuration(d: -9m, to: now()), _measurement: "measurement", tag1: "value1", _field: "field1", _value: 2},
  {_time: experimental.addDuration(d: -8m, to: now()), _measurement: "measurement", tag1: "value1", _field: "field1", _value: 3},
  {_time: experimental.addDuration(d: -7m, to: now()), _measurement: "measurement", tag1: "value1", _field: "field1", _value: 4},
  {_time: experimental.addDuration(d: -6m, to: now()), _measurement: "measurement", tag1: "value1", _field: "field1", _value: 5},
  {_time: experimental.addDuration(d: -5m, to: now()), _measurement: "measurement", tag1: "value1", _field: "field1", _value: 6},
  {_time: experimental.addDuration(d: -4m, to: now()), _measurement: "measurement", tag1: "value1", _field: "field1", _value: 7},
  {_time: experimental.addDuration(d: -3m, to: now()), _measurement: "measurement", tag1: "value1", _field: "field1", _value: 8},
  {_time: experimental.addDuration(d: -2m, to: now()), _measurement: "measurement", tag1: "value1", _field: "field1", _value: 9},
  {_time: experimental.addDuration(d: -1m, to: now()), _measurement: "measurement", tag1: "value1", _field: "field1", _value: 10}
])
 
data
  |> to(bucket: "test")
Note

สคริปต์นี้จะสร้างข้อมูลจำลอง 10 แถวใน bucket test โดยมีเวลาเป็นช่วงเวลาที่แตกต่างกันภายใน 10 นาทีที่ผ่านมา และค่า field1 เป็นตัวเลขตั้งแต่ 1 ถึง 10

  • หลังจากนั้นกด Submit เพื่อเพิ่มข้อมูลเข้าไปใน Bucket

Submit

  • เมื่อไม่มีอะไรผิดพลาดขึ้น ข้อมูลจะถูกเพิ่มเข้าไปใน Bucket ของเรา และจะแสดงเส้นกราฟใน Data Explorer

Data Added

Query ข้อมูลจาก InfluxDB ใน Grafana

  • ให้เพิ่มคำสั่ง Query ใน Visualization ของเรา
Flux Query
from(bucket: "test")
  |> range(start: -1h)
  |> filter(fn: (r) => r._measurement == "measurement")
  |> filter(fn: (r) => r.tag1 == "value1")
  |> aggregateWindow(every: 1m, fn: mean, createEmpty: false)
  |> yield(name: "mean")

Query

อธิบายการทำงานของคำสั่ง

  • from(bucket: "test")
    • เลือก bucket ชื่อ test เป็นแหล่งข้อมูลเริ่มต้นที่จะทำการ query
  • |> range(start: -1h)
    • กำหนดช่วงเวลาของข้อมูลที่ต้องการดึงมา โดยจะดึงข้อมูลตั้งแต่ 1 ชั่วโมงที่ผ่านมาจนถึงปัจจุบัน
    • -1h หมายถึง 1 ชั่วโมงที่ผ่านมาจากเวลาปัจจุบัน
  • |> filter(fn: (r) => r._measurement == "measurement")
    • กรองข้อมูลให้เหลือเฉพาะที่ _measurement มีค่าเป็น "measurement"
    • ฟังก์ชั่น filter จะทำการประเมินเงื่อนไข fn: (r) => r._measurement == "measurement" โดย r คือแต่ละแถวของข้อมูล
  • |> filter(fn: (r) => r.tag1 == "value1")
    • กรองข้อมูลเพิ่มเติมให้เหลือเฉพาะที่ tag1 มีค่าเป็น "value1"
  • |> aggregateWindow(every: 1m, fn: mean, createEmpty: false)
    • ทำการรวมข้อมูลในช่วงเวลาที่กำหนดโดยใช้ฟังก์ชั่น mean (ค่าเฉลี่ย)
    • every: 1m หมายถึงช่วงเวลา 1 นาที
    • createEmpty: false หมายถึงไม่สร้างช่วงเวลาที่ไม่มีข้อมูล
  • |> yield(name: "mean")
    • ส่งผลลัพธ์ออกมาโดยใช้ชื่อ "mean"
    • yieldเป็นคำสั่งที่บอกให้ query สิ้นสุดและส่งผลลัพธ์

ตัวอย่างตารางของข้อมูล

ตารางข้อมูลที่ได้จาก Query
_time_value
2024-06-01T12:00:00Z10.5
2024-06-01T12:01:00Z11
2024-06-01T12:02:00Z10.2

บันทึกการตั้งค่า

  • กด Apply เพื่อบันทึกการตั้งค่า
  • เราก็จะได้ข้อมูลจาก InfluxDB มาแสดงผลใน Grafana เรียบร้อย
Note

คุณสามารถเปลี่ยนรูปแบบของกราฟได้โดยกดไปที่ Visualization และเลือกรูปแบบที่ต้องการ

Graph

สรุป

ในบทความนี้เราได้เรียนรู้วิธีการสร้าง Dashboard ด้วย Grafana และ InfluxDB ด้วย Docker บน Ubuntu และเราได้ทำการตั้งค่าและเชื่อมต่อ Grafana กับ InfluxDB และสร้าง Dashboard แสดงผลข้อมูลจาก InfluxDB ได้เรียบร้อย ไว้เจอกันใน Blog ต่อไปครับ 👋👋👋

Buy Me A Coffee