ติดตั้ง Loki + Promtail บน VPS — Log Aggregation แบบครบจบ
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 ได้จริง
ความต้องการระบบ
| รายการ | ขั้นต่ำ | แนะนำ |
|---|---|---|
| RAM | 512 MB | 1 GB+ |
| CPU | 1 vCPU | 2 vCPU |
| Disk | 10 GB | 50 GB+ (เก็บ log) |
| OS | Ubuntu 20.04 | Ubuntu 22.04/24.04 |
ขั้นตอนที่ 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
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 ก่อน จากนั้น:
- เปิด Grafana → Connections → Add new data source
- เลือก Loki
- ใส่ URL:
http://localhost:3100 - คลิก 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'
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