ติดตั้ง Loki + Promtail บน VPS — Log Aggregation แบบครบจบ

Loki Promtail log aggregation บน VPS Linux

Grafana Loki คือระบบ log aggregation ที่ออกแบบมาให้ทำงานคู่กับ Prometheus และ Grafana — แทนที่จะ index ข้อความทุกคำ Loki จะ index เฉพาะ label (เช่น hostname, service, level) ทำให้ประหยัด storage กว่า Elasticsearch หลายเท่า Promtail คือ agent ที่อ่าน log จากไฟล์และส่งไปยัง Loki

บทความนี้จะพาติดตั้ง Loki + Promtail บน VPS Ubuntu 22.04/24.04 ตั้งแต่ต้นจนเปิดดู log ใน Grafana ได้จริง

ความต้องการระบบ

รายการขั้นต่ำแนะนำ
RAM512 MB1 GB+
CPU1 vCPU2 vCPU
Disk10 GB50 GB+ (เก็บ log)
OSUbuntu 20.04Ubuntu 22.04/24.04
หมายเหตุ: Loki และ Promtail ไม่จำเป็นต้องอยู่บนเครื่องเดียวกัน — ในบทความนี้ติดตั้งบนเครื่องเดียวกันเพื่อความง่าย

ขั้นตอนที่ 1 — เตรียมระบบและดาวน์โหลด Loki

อัปเดตระบบและสร้าง user สำหรับ Loki:

sudo apt update && sudo apt upgrade -y
sudo useradd --system --no-create-home --shell /bin/false loki
sudo mkdir -p /etc/loki /var/lib/loki /var/log/loki
sudo chown -R loki:loki /var/lib/loki /var/log/loki

ดาวน์โหลด Loki binary ล่าสุด:

# ดู version ล่าสุดที่ https://github.com/grafana/loki/releases
LOKI_VER="3.3.2"
cd /tmp
wget "https://github.com/grafana/loki/releases/download/v${LOKI_VER}/loki-linux-amd64.zip"
unzip loki-linux-amd64.zip
sudo mv loki-linux-amd64 /usr/local/bin/loki
sudo chmod +x /usr/local/bin/loki
loki --version

ขั้นตอนที่ 2 — สร้าง config สำหรับ Loki

sudo tee /etc/loki/loki-config.yaml << 'EOF'
auth_enabled: false

server:
  http_listen_port: 3100
  grpc_listen_port: 9096

common:
  instance_addr: 127.0.0.1
  path_prefix: /var/lib/loki
  storage:
    filesystem:
      chunks_directory: /var/lib/loki/chunks
      rules_directory: /var/lib/loki/rules
  replication_factor: 1
  ring:
    kvstore:
      store: inmemory

query_range:
  results_cache:
    cache:
      embedded_cache:
        enabled: true
        max_size_mb: 100

schema_config:
  configs:
    - from: 2020-10-24
      store: tsdb
      object_store: filesystem
      schema: v13
      index:
        prefix: index_
        period: 24h

limits_config:
  retention_period: 30d

compactor:
  working_directory: /var/lib/loki/compactor
  retention_enabled: true
EOF

ขั้นตอนที่ 3 — สร้าง systemd service สำหรับ Loki

sudo tee /etc/systemd/system/loki.service << 'EOF'
[Unit]
Description=Loki Log Aggregation System
Documentation=https://grafana.com/docs/loki/
After=network.target

[Service]
User=loki
Group=loki
Type=simple
ExecStart=/usr/local/bin/loki -config.file=/etc/loki/loki-config.yaml
Restart=on-failure
RestartSec=5s
StandardOutput=journal
StandardError=journal
SyslogIdentifier=loki
PrivateTmp=true
ProtectSystem=full
NoNewPrivileges=true
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable loki
sudo systemctl start loki
sudo systemctl status loki --no-pager

ขั้นตอนที่ 4 — ติดตั้ง Promtail

Promtail คือ agent ที่ทำหน้าที่อ่าน log file และส่งไป Loki:

PROMTAIL_VER="3.3.2"
cd /tmp
wget "https://github.com/grafana/loki/releases/download/v${PROMTAIL_VER}/promtail-linux-amd64.zip"
unzip promtail-linux-amd64.zip
sudo mv promtail-linux-amd64 /usr/local/bin/promtail
sudo chmod +x /usr/local/bin/promtail

# สร้าง user สำหรับ promtail
sudo useradd --system --no-create-home --shell /bin/false promtail
sudo usermod -aG adm promtail

ขั้นตอนที่ 5 — สร้าง config สำหรับ Promtail

sudo mkdir -p /etc/promtail
sudo tee /etc/promtail/promtail-config.yaml << 'EOF'
server:
  http_listen_port: 9080
  grpc_listen_port: 0

positions:
  filename: /tmp/positions.yaml

clients:
  - url: http://localhost:3100/loki/api/v1/push

scrape_configs:
  - job_name: syslog
    static_configs:
      - targets: [localhost]
        labels:
          job: syslog
          __path__: /var/log/syslog

  - job_name: auth
    static_configs:
      - targets: [localhost]
        labels:
          job: auth
          __path__: /var/log/auth.log

  - job_name: nginx
    static_configs:
      - targets: [localhost]
        labels:
          job: nginx
          __path__: /var/log/nginx/access.log

  - job_name: nginx_error
    static_configs:
      - targets: [localhost]
        labels:
          job: nginx_error
          __path__: /var/log/nginx/error.log

  - job_name: journal
    journal:
      max_age: 12h
      labels:
        job: systemd-journal
    relabel_configs:
      - source_labels: ['__journal__systemd_unit']
        target_label: 'unit'
EOF
Tip: เพิ่ม label host: ชื่อเครื่อง ใน labels ของแต่ละ job เพื่อให้ filter ใน Grafana ได้ง่ายขึ้น

ขั้นตอนที่ 6 — สร้าง systemd service สำหรับ Promtail

sudo tee /etc/systemd/system/promtail.service << 'EOF'
[Unit]
Description=Promtail Log Agent
After=network.target loki.service

[Service]
User=promtail
Group=promtail
Type=simple
ExecStart=/usr/local/bin/promtail -config.file=/etc/promtail/promtail-config.yaml
Restart=on-failure
RestartSec=5s
StandardOutput=journal
StandardError=journal
SyslogIdentifier=promtail

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable promtail
sudo systemctl start promtail
sudo systemctl status promtail --no-pager

ขั้นตอนที่ 7 — เชื่อม Grafana กับ Loki

หาก Grafana ยังไม่ได้ติดตั้ง ดูได้ที่บทความ ติดตั้ง Prometheus + Grafana ก่อน จากนั้น:

  1. เปิด Grafana → Connections → Add new data source
  2. เลือก Loki
  3. ใส่ URL: http://localhost:3100
  4. คลิก Save & test — ต้องขึ้น "Data source connected"

Query Log ด้วย LogQL

LogQL คือภาษา query ของ Loki คล้าย PromQL — ตัวอย่างที่ใช้บ่อย:

# ดู log ทั้งหมดจาก nginx
{job="nginx"}

# กรองเฉพาะ HTTP 500
{job="nginx"} |= "\" 5"

# นับ request per minute
rate({job="nginx"}[1m])

# ดู error จาก auth log
{job="auth"} |= "Failed password"

# กรองด้วย regex
{job="syslog"} |~ "error|warning|critical"

# นับ log level
sum by (unit) (count_over_time({job="systemd-journal"}[5m]))

ตรวจสอบว่า Loki + Promtail ทำงานถูกต้อง

# ตรวจสอบ Loki health
curl -s http://localhost:3100/ready

# ดู label ที่ Loki รับมาแล้ว
curl -s http://localhost:3100/loki/api/v1/labels

# ตรวจสอบ Promtail targets
curl -s http://localhost:9080/targets

# ดู log ของ Loki เอง
sudo journalctl -u loki -f --no-pager

# ดู log ของ Promtail เอง
sudo journalctl -u promtail -f --no-pager

# Query log ล่าสุด 5 รายการผ่าน API
curl -G -s "http://localhost:3100/loki/api/v1/query" \
  --data-urlencode 'query={job="syslog"}' \
  --data-urlencode 'limit=5'
Tip: ถ้า curl http://localhost:3100/ready ตอบ ready แสดงว่า Loki พร้อมใช้งานแล้ว ถ้า Promtail ส่ง log ได้จะเห็น label ปรากฏใน /loki/api/v1/labels

แก้ปัญหาที่พบบ่อย

Error: "permission denied" เมื่อ Promtail อ่าน /var/log

Promtail ต้องอยู่ใน group adm เพื่ออ่าน system log:

sudo usermod -aG adm promtail
# ตรวจสอบ group
id promtail
# restart หลังแก้
sudo systemctl restart promtail

Error: "context deadline exceeded" เมื่อ Promtail ส่ง log

มักเกิดเมื่อ Loki ยังไม่พร้อมหรือ port ถูก block — ตรวจสอบ:

# ตรวจ Loki ฟัง port อยู่หรือเปล่า
ss -tlnp | grep 3100

# ตรวจ firewall
sudo ufw status
# ถ้า Loki และ Promtail อยู่คนละเครื่อง ต้องเปิด port 3100
sudo ufw allow from PROMTAIL_IP to any port 3100

Error: "invalid schema version" ใน Loki log

เกิดเมื่อ config schema ไม่ตรงกับ version ของ Loki — ลบ data เก่าออก (ทำเฉพาะตอน Loki ยังใหม่ ไม่มี production data):

sudo systemctl stop loki
sudo rm -rf /var/lib/loki/*
sudo systemctl start loki

Loki ใช้ disk มากเกินไป

ตั้ง retention period ใน config เพื่อลบ log เก่าอัตโนมัติ:

# ใน /etc/loki/loki-config.yaml
limits_config:
  retention_period: 7d   # เก็บไว้ 7 วัน

compactor:
  working_directory: /var/lib/loki/compactor
  retention_enabled: true

# restart เพื่อให้มีผล
sudo systemctl restart loki

Error: "entry out of order" ใน Promtail

เกิดเมื่อ timestamp ของ log ย้อนหลัง — เพิ่ม max_chunk_age ใน Loki config:

# ใน /etc/loki/loki-config.yaml
ingester:
  max_chunk_age: 1h
  chunk_idle_period: 30m
  chunk_retain_period: 1m

sudo systemctl restart loki

คำถามที่พบบ่อย

Loki ต่างจาก Elasticsearch อย่างไร?

Loki จะ index เฉพาะ label (metadata) ไม่ใช่เนื้อหา log ทั้งหมด ทำให้ใช้ RAM และ disk น้อยกว่า Elasticsearch มาก เหมาะกับ VPS ขนาดเล็ก แต่แลกมาด้วยความสามารถ full-text search ที่จำกัดกว่า — ถ้าต้องการค้นหาแบบ complex ใน log ขนาดใหญ่ Elasticsearch อาจเหมาะกว่า

Promtail อ่าน log จาก Docker container ได้ไหม?

ได้ — ตั้ง path เป็น /var/lib/docker/containers/*/*.log และเพิ่ม pipeline stage สำหรับ parse Docker JSON log format ได้เลย นอกจากนี้ยังใช้ Docker plugin ของ Loki ที่ส่ง log โดยตรงโดยไม่ต้องผ่านไฟล์ก็ได้

ต้องเปิด port 3100 ออก internet ไหม?

ไม่แนะนำ — ถ้า Promtail และ Loki อยู่เครื่องเดียวกันใช้ localhost ได้เลย ถ้าอยู่คนละเครื่องให้ใช้ private network หรือ VPN เชื่อม แล้วเปิด port เฉพาะ IP ที่อนุญาตเท่านั้น เพราะ Loki ไม่มี auth ในโหมด default