วิธีติดตั้ง Superlog ระบบวิเคราะห์ Log ด้วย AI บน VPS
เรียนรู้วิธีติดตั้ง Superlog ด้วย Docker Compose เพื่อจัดการ OTLP traces และ logs ด้วย AI พร้อมข้อควรระวังเรื่องการเลือก commit เนื่องจากโปรเจกต์ยังไม่มี release tag
สิ่งที่ Superlog ติดตั้งจริงเมื่อทำ self-hosting
ในการทำ self-hosting สำหรับ Superlog คุณต้อง clone repository, สั่งรัน Postgres, ClickHouse และ OpenTelemetry collector ด้วย Docker Compose, รัน database migration หนึ่งครั้ง จากนั้นจึงเริ่มรัน Node service สี่รายการจาก source code แอปพลิเคชันของคุณจะส่ง OTLP (OpenTelemetry protocol) traces, logs และ metrics ไปยังพอร์ตรับข้อมูล จากนั้น Superlog จะทำ fingerprint ข้อมูลเหล่านั้น จัดกลุ่มรายการที่ซ้ำกันให้เป็น incident เดียวกัน และตัว agent runner มาตรฐานของชุมชนจะบันทึกสรุป incident ไว้ในเครื่อง การติดตั้งใช้เวลาประมาณหนึ่งช่วงบ่าย สิ่งที่ควรศึกษาให้เข้าใจก่อนเริ่มคือการใช้ทรัพยากรและข้อจำกัดที่แท้จริงของระบบ
Superlog ใช้สัญญาอนุญาตแบบ Apache 2.0 และอยู่ที่ github.com/superloglabs/superlog ณ วันที่ 13 ตุลาคม 2026 มีดาวประมาณ 1.5k ดวง มีการ commit ประมาณ 490 ครั้งบน main และยังไม่มี release tag ใดๆ ทั้งสิ้น คุณควรระบุ commit ที่ต้องการใช้งานด้วยตนเอง แทนการรันสิ่งที่ main บังเอิญเป็นอยู่ในเช้าวันที่คุณ clone มา
สิ่งที่ Superlog ตอบโจทย์ได้แต่ Uptime Kuma และ Langfuse ทำไม่ได้
เครื่องมือ monitoring แบบ self-hosted ดูเหมือนจะใช้งานแทนกันได้เมื่อมองจากภายนอก แต่ในความเป็นจริงนั้นไม่ใช่ และการเลือกใช้เครื่องมือที่ไม่เหมาะสมอาจทำให้คุณเสียทรัพยากรเซิร์ฟเวอร์ไปโดยเปล่าประโยชน์
- Uptime Kuma ทำการ probe endpoint ของคุณจากภายนอก และตอบคำถามเพียงข้อเดียวคือ: บริการยังทำงานอยู่หรือไม่
- Zabbix คอยเฝ้าดูโฮสต์และบริการบน Ubuntu 24.04 โดยตรวจสอบ CPU, memory, disk และสถานะของบริการเทียบกับเกณฑ์ที่คุณกำหนดไว้
- Langfuse ติดตามการเรียกใช้งาน LLM โดยบันทึก prompt, โมเดล, จำนวน token, latency และค่าใช้จ่ายของการเรียกแต่ละครั้ง
- Superlog นำ telemetry ที่บริการทั่วไปของคุณส่งออกมาอยู่แล้ว มาเปลี่ยนความล้มเหลวที่เกิดขึ้นซ้ำๆ ให้กลายเป็น incident
Superlog ตอบคำถามในมุมที่ต่างออกไป คือ: เมื่อมีบางอย่างพัง อะไรคือสิ่งที่พัง และพังเพราะอะไร เครื่องมือนี้ไม่มีความเห็นเกี่ยวกับการเรียกใช้งาน LLM และไม่ได้ทำการ probe คุณจากภายนอก แต่จะรับข้อมูล OTLP จากโค้ดแอปพลิเคชันปกติของคุณ และวาง agent ไว้ในขั้นตอนการคัดกรอง (triage) ซึ่งเป็นขั้นตอนแรกที่เจ้าหน้าที่ on-call ต้องทำอยู่แล้ว
ความแตกต่างที่สำคัญสำหรับงบประมาณ VPS คือเรื่องการจัดเก็บข้อมูล Superlog ใช้ column store เนื่องจาก telemetry เป็นข้อมูลที่เขียนครั้งเดียวแล้วถูกเรียกดูตามช่วงเวลาจากแถวข้อมูลนับล้านรายการ ซึ่งนั่นคือสิ่งที่ ClickHouse ออกแบบมาเพื่อรองรับ ในขณะที่ Postgres ไม่ได้ถูกออกแบบมาเพื่อการนี้ Postgres ยังคงอยู่ใน stack เพื่อเก็บข้อมูลเชิงสัมพันธ์ขนาดเล็ก เช่น โปรเจกต์, ผู้ใช้งาน, incident และ ingest key
คำสั่ง docker compose up -d เริ่มการทำงานของอะไรบ้าง
มีคอนเทนเนอร์ 3 รายการ และไม่มีรายการใดที่เป็น Superlog ซึ่งสร้างความประหลาดใจให้กับผู้ที่คาดหวังการติดตั้งด้วยคำสั่งเดียว
postgres:16ซึ่งเปิดใช้งานบนพอร์ต 5434 ของโฮสต์clickhouse/clickhouse-server:26.1บนพอร์ต 8123 สำหรับ HTTP และ 9000 สำหรับโปรโตคอลแบบ nativeotel/opentelemetry-collector-contrib:0.150.1บนพอร์ต 4317 สำหรับ gRPC และ 4318 สำหรับ OTLP ผ่าน HTTP
แอปพลิเคชัน Superlog ทำงานบนโฮสต์โดยตรงจากซอร์สโค้ด ซึ่งเริ่มการทำงานโดย pnpm dev ณ วันที่ 13 ตุลาคม 2026 ยังไม่มีไฟล์ compose สำหรับการใช้งานจริง (production) ใน repository ดังนั้นการติดตั้งแบบถาวรจึงหมายถึงการที่คุณต้องสร้าง systemd unit ของตนเอง หรือใช้ Dockerfiles ของแต่ละแอปที่มาพร้อมกับซอร์สโค้ด แอป api, worker และ proxy แต่ละตัวจะมีสคริปต์ start สำหรับใช้ครอบ unit ส่วนแอป web นั้นไม่มีสคริปต์ดังกล่าว เนื่องจากเป็นแอป Vite คุณจึงต้อง build ด้วยสคริปต์ build และให้บริการไฟล์ที่ได้ในรูปแบบ static files ผ่าน nginx หรือ Caddy หรือรันด้วยสคริปต์ preview ซึ่งก็คือ vite preview
โปรดทำความเข้าใจเส้นทางที่ข้อมูลเดินทาง เพราะความล้มเหลวทุกอย่างที่ระบุไว้ด้านล่างคือจุดที่เส้นทางดังกล่าวขาดช่วง แอปของคุณส่งข้อมูล OTLP ไปยัง proxy รับข้อมูลของ Superlog จากนั้น proxy จะตรวจสอบสิทธิ์คำขอด้วย ingest key ของคุณ ประทับรหัสโปรเจกต์ลงไป แล้วส่งต่อไปยัง collector ตัว collector จะลบ attribute superlog.* ใดๆ ที่ไคลเอนต์พยายามกำหนดเอง เพิ่ม superlog.project_id จาก header ที่ proxy ระบุมา จากนั้นทำการ batch ข้อมูลและเขียนลงใน ClickHouse ต่อมาแอป web และ API จะอ่านข้อมูล telemetry กลับมาจาก ClickHouse และอ่านข้อมูลส่วนอื่นจาก Postgres
การลบ attribute ดังกล่าวเป็นการควบคุมแบบ multi-tenancy ที่แท้จริง ไม่ใช่เพียงแค่การตกแต่ง หากไม่มีการควบคุมนี้ ผู้ที่มี ingest key ที่ถูกต้องเพียงหนึ่งชุดจะสามารถกำหนด superlog.project_id ได้ด้วยตนเองและเขียนข้อมูลลงในโปรเจกต์ของผู้อื่นได้
VPS ต้องมีขนาดเท่าใด
ควรวางแผนใช้ 4 vCPU, 8 GB RAM และ 40 GB SSD สำหรับการติดตั้งแบบ single node ที่มีปริมาณข้อมูลขาเข้าต่ำ นี่เป็นเพียงขนาดเริ่มต้นสำหรับการวางแผนเท่านั้น ไม่ใช่ค่ามาตรฐานที่ตายตัว ดังนั้นให้ถือว่าเป็นขนาดเริ่มต้นและตรวจสอบกับปริมาณ traffic ของคุณเอง
หน่วยความจำจะถูกแบ่งไปใช้ใน 4 ส่วน ClickHouse ถูกออกแบบมาสำหรับเครื่องที่มี RAM จำนวนมากและค่าเริ่มต้นก็ตั้งไว้ตามนั้น Postgres 16 ใช้ทรัพยากรไม่มากนักเนื่องจากเก็บข้อมูล metadata แทนที่จะเป็น telemetry ส่วน collector ก็ใช้ทรัพยากรไม่มากเช่นกัน กระบวนการ Node ทั้ง 4 รายการประกอบด้วย Vite development server และกระบวนการ tsx watch อีก 3 รายการ ให้วัดการใช้หน่วยความจำบนเครื่องของคุณเอง
พื้นที่ดิสก์เป็นปัญหาที่เงียบกว่า pnpm install ใน monorepo นี้จะดึง AWS SDK, ClickHouse client, OpenTelemetry SDK และ React toolchain มาก่อนที่คุณจะเริ่มรับข้อมูล span แรกเสียอีก จากนั้น ClickHouse จะขยายตัวตามปริมาณ traffic ของคุณ ให้วัดค่าทั้งสองส่วน:
df -h /
free -m
docker stats --no-stream
docker compose exec clickhouse clickhouse-client --database superlog --query "SELECT table, formatReadableSize(sum(bytes_on_disk)) AS size FROM system.parts WHERE active AND database = 'superlog' GROUP BY table ORDER BY sum(bytes_on_disk) DESC"ภาระงานที่ส่งผลกระทบมากที่สุดคือช่วงที่มีการใช้งานหนาแน่น (burst): เช่น การ deploy ที่ผิดพลาดจนทำให้เกิด error ซ้ำๆ นับพันรายการต่อนาที แม้ว่าระบบ fingerprinting จะยุบรวม error เหล่านั้นให้เป็น incident เดียวเพื่อให้คุณอ่านได้ง่าย แต่ ClickHouse ก็ยังคงต้องเขียนข้อมูลทุกแถวลงในฐานข้อมูลอยู่ดี
คุณเป็นผู้กำหนดระยะเวลาการเก็บรักษาข้อมูล (retention) ตัว ClickHouse exporter ของ collector จะสร้างตาราง otel_traces, otel_logs และตารางสำหรับ metric แต่ละประเภท โดยจะใช้ค่า time to live ก็ต่อเมื่อมีการตั้งค่าไว้ใน infra/collector/config.yaml เท่านั้น ข้อมูลจะไม่ถูกลบโดยอัตโนมัติ ดังนั้นหากเดือนนั้นมีข้อมูลเข้ามามาก พื้นที่ดิสก์จะเต็มได้หากคุณไม่ได้วางแผนรองรับไว้
การติดตั้งจาก commit ที่ระบุไว้
git clone https://github.com/superloglabs/superlog.git
cd superlog
git tag -l
git log -1 --format='%H %cs %s'git tag -l การไม่แสดงผลลัพธ์ใดๆ คือผลลัพธ์ที่คาดหวัง ณ วันที่ 13 ตุลาคม 2026 ให้เลือก commit ที่คุณทดสอบแล้วและใช้งาน commit นั้นต่อไป:
git checkout 0d3a6c8bb63eda3493e6ba0003e7c2a70750bc1eถัดไปคือ toolchain:
node -v
corepack enable
corepack prepare pnpm@9.12.0 --activate
pnpm -vpackage.json ประกาศให้ engines.node เป็น >=20.0.0 และ packageManager เป็น pnpm@9.12.0 เวอร์ชันของ Node ที่ไม่เข้ากันจะไม่หยุดการติดตั้งโดยอัตโนมัติ การบังคับใช้ engine ขึ้นอยู่กับการตั้งค่า และ pnpm 9.12.0 มีเส้นทางการแจ้งเตือนเมื่อ engineStrict ถูกปิดใช้งาน แพ็กเกจ nodejs ในคลังซอฟต์แวร์ของ Ubuntu 24.04 นั้นเก่ากว่าเวอร์ชัน 20 ดังนั้นให้ติดตั้ง Node 20 หรือใหม่กว่าจาก NodeSource หรือ nvm ตัว repository มีไฟล์ .nvmrc อยู่ ดังนั้น nvm use จะเลือกเวอร์ชันที่ตั้งใจไว้ให้หากคุณใช้ nvm อยู่
pnpm install
docker compose up -d
docker compose psให้รอการตรวจสอบสถานะ (health check) แทนการเชื่อว่า up -d หมายถึงพร้อมใช้งาน Postgres และ ClickHouse ต่างประกาศสถานะไว้ในไฟล์ compose:
curl -sS http://127.0.0.1:8123/ping
pg_isready -h 127.0.0.1 -p 5434 -U postgresClickHouse ตอบกลับด้วย Ok. และ pg_isready ตอบกลับด้วย accepting connections หากได้รับข้อความ Connection refused บนพอร์ต 8123 หมายความว่า container กำลังเริ่มทำงานหรือหยุดทำงานไปแล้ว docker compose logs clickhouse จะแสดงให้เห็นว่าเกิดจากสาเหตุใด และ docker inspect $(docker compose ps -q clickhouse) | grep -i oomkilled จะรายงาน true เมื่อ kernel สั่งยุติการทำงานเนื่องจากหน่วยความจำไม่เพียงพอ ซึ่งชี้ให้เห็นว่าเซิร์ฟเวอร์มีขนาดเล็กเกินไป ไม่ใช่ปัญหาที่การตั้งค่าของคุณ
จากนั้นเป็นการ migration และแอปพลิเคชัน:
pnpm --filter @superlog/db db:migrate
pnpm devสังเกตพอร์ต: 5434 ไม่ใช่ 5432 ไฟล์ compose เผยแพร่ Postgres บนพอร์ต 5434 เพื่อไม่ให้ชนกับ Postgres ที่ติดตั้งอยู่บน host เดิม และไฟล์ .env.example ของแอปพลิเคชันก็ตรงกันด้วย DATABASE_URL=postgres://postgres:postgres@localhost:5434/superlog หากคุณชี้การ migration ไปที่พอร์ต 5432 บนเครื่องที่มี Postgres ทำงานอยู่แล้ว คุณจะพบกับข้อความปฏิเสธการเชื่อมต่อ หรือที่แย่กว่านั้นคือการ migration จะถูกนำไปใช้กับฐานข้อมูลผิดตัว
pnpm dev รัน turbo run dev ซึ่งจะเริ่มสคริปต์ dev ของแต่ละแอปผ่าน Turborepo รวมถึง api, web, worker และ proxy โดยแสดงผลรวมกันใน terminal เดียว ไฟล์ Procfile ของ repository ระบุรายการกระบวนการทั้งสี่นี้และส่งผลลัพธ์ของแต่ละตัวไปยัง tmp/logs/ ให้เริ่มการทำงานด้วยตัวรัน Procfile เช่น overmind หรือ foreman แทน pnpm dev หากคุณต้องการให้ tail -f tmp/logs/proxy.log เป็นจุดที่คุณตรวจสอบข้อมูลนำเข้า README ระบุให้ web app อยู่บน http://localhost:5173, API บน http://localhost:4100 และ OTLP intake บน http://localhost:4101
ตรวจสอบว่าพอร์ตใดถูกใช้งานจริงก่อนที่จะชี้บริการใดๆ ไปที่พอร์ตนั้น:
ss -lntp | grep -E '4000|4100|4101|5173'
curl -sS http://127.0.0.1:4101/healthเรื่องนี้สำคัญในภายหลัง ตัว proxy จะอ่านพอร์ตของตัวเองจากตัวแปรสภาพแวดล้อม PORT และจะใช้ค่าเริ่มต้นเป็น 4000 เมื่อ PORT ไม่ได้ถูกตั้งค่าไว้ และ apps/proxy/.env.example ที่มันโหลดมายังตั้งค่า PORT=4000 ไว้ด้วย แม้ว่า README จะระบุ intake ไว้ที่ 4101 (ตรวจสอบข้อมูล ณ วันที่ 13 ตุลาคม 2026) ให้ใช้พอร์ตที่ ss แสดงผล ตัวอย่างด้านล่างใช้ 4101 ดังนั้นให้เปลี่ยนเป็น 4000 หากนั่นคือพอร์ตที่ถูกใช้งานจริง systemd unit ที่คุณเขียนขึ้นเองจะไม่ตั้งค่าใดๆ เว้นแต่คุณจะใส่ PORT ลงไป ดังนั้น exporter ที่ชี้ไปที่ 4101 ในขณะที่ proxy ฟังอยู่ที่ 4000 จะล้มเหลวด้วยข้อความ connection refused โดยไม่มีเบาะแสอื่นให้คุณทราบ
ส่งหนึ่ง trace, สร้างหนึ่ง error, พบหนึ่ง incident
สร้างโปรเจกต์ในเว็บแอปพลิเคชันแล้วคัดลอก ingest key ของโปรเจกต์นั้น ระบบ intake จะตรวจสอบสิทธิ์ทุกคำขอด้วยคีย์นี้ ดังนั้น telemetry ที่ส่งมาโดยไม่มีคีย์จะไม่ถูกบันทึกลงใน ClickHouse
ชี้ OpenTelemetry SDK ไปที่ intake โดยใช้ environment variable มาตรฐาน:
export OTEL_SERVICE_NAME=checkout-api
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4101
export OTEL_EXPORTER_OTLP_HEADERS='x-api-key=YOUR_INGEST_KEY'ระบบ intake จะอ่านคีย์จาก header x-api-key และยังรองรับ authorization: bearer YOUR_INGEST_KEY หาก exporter ของคุณตั้งค่าด้วยวิธีนั้นได้ง่ายกว่า ระบบรองรับ OTLP path มาตรฐาน 3 รายการคือ /v1/traces, /v1/logs และ /v1/metrics รวมถึง /health
มีข้อควรระวังที่สำคัญประการหนึ่งคือ OTEL_EXPORTER_OTLP_ENDPOINT เป็น base URL ซึ่ง SDK จะต่อท้ายด้วย signal path โดยอัตโนมัติ ส่วนตัวแปรเฉพาะของ signal เช่น OTEL_EXPORTER_OTLP_TRACES_ENDPOINT จะถูกใช้งานตามที่ระบุไว้โดยไม่มีการต่อท้าย path หากคุณตั้งค่าตัวแปรเฉพาะของ signal เป็น http://127.0.0.1:4101 ข้อมูลทั้งหมดจะถูกส่งไปที่ / ซึ่งไม่ใช่ route ที่ถูกต้อง ส่งผลให้ไม่มีข้อมูลเข้ามา และ SDK จะบันทึกว่าการส่งข้อมูลล้มเหลวในขณะที่แอปพลิเคชันของคุณยังทำงานปกติ
สำหรับ Node service การใช้ zero code path ก็เพียงพอที่จะพิสูจน์การทำงานของ pipeline:
npm install @opentelemetry/api @opentelemetry/auto-instrumentations-node
node --require @opentelemetry/auto-instrumentations-node/register server.jsจากนั้นให้ลองทำให้ระบบเกิดข้อผิดพลาดโดยเจตนา โดยใช้ route ใดก็ได้ที่ทำให้เกิด exception:
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3000/boomตรวจสอบขั้นตอนการส่งข้อมูลตามลำดับ เพราะช่องว่างแรกจะบอกคุณว่าจุดใดที่ล้มเหลว:
tail -n 50 tmp/logs/proxy.log
docker compose exec clickhouse clickhouse-client --database superlog --query 'SELECT count() FROM otel_traces'หากตัวเลขใน otel_traces เพิ่มขึ้นแต่ในเว็บแอปพลิเคชันว่างเปล่า แสดงว่าโปรเจกต์ไม่ตรงกัน ให้ตรวจสอบว่า ingest key นั้นเป็นของโปรเจกต์ใด หากตัวเลขคงที่แต่มีกิจกรรมใน proxy log แสดงว่าปัญหาอยู่ที่ collector หรือการเขียนข้อมูลลง ClickHouse ให้ตรวจสอบ docker compose logs collector หากไม่มีกิจกรรมใน proxy log เลย แสดงว่า exporter ไม่สามารถเข้าถึง intake ได้ อาจเกิดจากพอร์ตผิด, path ผิด หรือคีย์ถูกปฏิเสธ
ในเว็บแอปพลิเคชัน ความล้มเหลวที่เกิดขึ้นซ้ำๆ จะถูกรวมเป็นหนึ่ง incident แทนที่จะแสดงแยกทีละแถวต่อหนึ่งคำขอ Superlog จะสร้าง fingerprint ให้กับสัญญาณที่เข้ามาและจัดกลุ่มรายการที่ตรงกัน ซึ่งช่วยลดภาระจากการมี error ซ้ำๆ 4,000 รายการใน inbox ให้เหลือเพียงหน้าเดียวที่สรุปข้อมูลไว้ โดย default community agent runner จะบันทึกสรุป incident ในเครื่องสำหรับกลุ่มนั้นๆ
การตรวจสอบโดยใช้ model จำเป็นต้องมี model provider และ agent runner ที่เข้ากันได้ โดย default community runner จะบันทึกสรุปในเครื่อง ให้ใช้ชื่อตัวแปรจากไฟล์ .env.example ภายในไดเรกทอรีของแต่ละแอปใน commit ที่คุณเลือกไว้ แทนที่จะใช้จากเอกสารภายนอก เนื่องจากชื่อตัวแปรอาจเปลี่ยนแปลงตาม main เช่นเดียวกับการเชื่อมต่อกับ GitHub และ Sentry ซึ่งมีเอกสารการตั้งค่าของตนเองที่ docs/github-app-setup.md และ docs/sentry-app-setup.md โดยมีรายละเอียด webhook payload อยู่ที่ docs/webhooks.md
รักษาความเป็นส่วนตัวของข้อมูลขาเข้าและจำกัดสิทธิ์ของ agent
โดยปกติ Docker จะเผยแพร่พอร์ตของคอนเทนเนอร์บน 0.0.0.0 ซึ่งพอร์ตที่เผยแพร่เหล่านี้จะข้ามการทำงานของ ufw ไป Docker จัดเส้นทางทราฟฟิกของคอนเทนเนอร์ในตาราง nat ดังนั้นแพ็กเก็ตที่มุ่งหน้าไปยังพอร์ตที่เผยแพร่จะถูกเบี่ยงเบนก่อนที่จะถึงเชน INPUT และ OUTPUT ซึ่งเป็นที่อยู่ของกฎ ufw ทำให้ ufw ไม่สามารถควบคุมได้ บน VPS ที่มี IP สาธารณะ ไฟล์ compose ที่มาพร้อมกับซอฟต์แวร์จะตั้งค่า ClickHouse HTTP ไว้ที่พอร์ต 8123 และ Postgres ที่พอร์ต 5434 ซึ่งทำให้เข้าถึงได้จากอินเทอร์เน็ต ข้อมูลรับรองในไฟล์นั้นเป็นค่าเริ่มต้นสำหรับการพัฒนา ได้แก่ ผู้ใช้ ClickHouse default ที่ไม่มีรหัสผ่าน และ Postgres ที่ใช้ postgres เป็นทั้งชื่อผู้ใช้และรหัสผ่าน
ให้ผูกพอร์ตเหล่านี้ไว้กับ loopback พอร์ตที่เผยแพร่ทุกพอร์ตในไฟล์ compose จะดึงค่าฝั่งโฮสต์มาจากตัวแปรสภาพแวดล้อม ดังนั้นการสร้างไฟล์ .env ไว้ที่ root ของ repository ก็เพียงพอแล้ว:
POSTGRES_HOST_PORT=127.0.0.1:5434
CLICKHOUSE_HTTP_HOST_PORT=127.0.0.1:8123
CLICKHOUSE_TCP_HOST_PORT=127.0.0.1:9000
COLLECTOR_GRPC_HOST_PORT=127.0.0.1:4317
COLLECTOR_HTTP_HOST_PORT=127.0.0.1:4318ตรวจสอบผลลัพธ์ก่อนที่จะเชื่อมั่น จากนั้นจึงสร้างคอนเทนเนอร์ขึ้นใหม่:
docker compose config
docker compose up -d
ss -lntp | grep -E '5434|8123|9000|4317|4318'docker compose config จะแสดงไฟล์ที่รวมค่าตัวแปรแล้ว คุณจึงสามารถอ่าน 127.0.0.1:5434:5432 ได้โดยไม่ต้องคาดเดา ss ควรแสดงค่าเป็น 127.0.0.1:5434 และไม่ควรเป็น 0.0.0.0:5434 การประกาศ ports ซ้ำในไฟล์ Compose override จะช่วยรักษาการผูกพอร์ตทั้งสองไว้ได้เมื่อ IP ของโฮสต์แตกต่างกัน โดย Compose เวอร์ชัน 2.24.4 ขึ้นไปรองรับ ports: !override เพื่อใช้แทนที่รายการเดิม
ข้อมูลขาเข้าต้องการการดูแลเช่นเดียวกัน กุญแจสำหรับการรับข้อมูล (ingest key) ของคุณจะถูกส่งผ่าน header จึงจำเป็นต้องมี TLS (transport layer security) อยู่เบื้องหน้า: ให้ทำ TLS termination ที่ nginx หรือ Caddy ก่อนถึง proxy หรือเก็บการรับข้อมูลไว้ภายในเครือข่ายส่วนตัวหรือผ่าน WireGuard tunnel ส่วนเว็บแอปบนพอร์ต 5173 นั้นเป็น Vite development server ซึ่งไม่ควรเปิดรับการเชื่อมต่อจากอินเทอร์เน็ตโดยเด็ดขาด
สำหรับตัว agent เอง จุดเด่นของ Superlog คือการที่ agent จะตรวจสอบและเสนอแนวทางแก้ไข ซึ่งคำสำคัญคือ "เสนอ" ให้จำกัดสิทธิ์เป็นแบบอ่านอย่างเดียว (read-only) กับระบบ production จนกว่าคุณจะมั่นใจจากการเฝ้าดูการทำงานของมันในเหตุการณ์จริงสักสองสามครั้ง GitHub App ที่มีสิทธิ์อ่านอย่างเดียวจะไม่สามารถ push branch แก้ไขหรือเปิด pull request ได้ คู่มือการตั้งค่ากำหนดให้ต้องมีสิทธิ์เขียน (write permissions) ในส่วน Contents และ Pull requests สำหรับ workflow นั้น รวมถึงสิทธิ์เขียนในส่วน Issues สำหรับการแสดงความคิดเห็น Agent ที่อ่าน telemetry และเขียน patch ได้นั้นมีประโยชน์ แต่ agent ที่สามารถรีสตาร์ทบริการของคุณได้นั้นมีความเสี่ยงในระดับที่ต่างออกไป ซึ่งควรเป็นการตัดสินใจที่คุณเลือกเองโดยเจตนา ไม่ใช่ค่าเริ่มต้นที่คุณได้รับมาโดยไม่รู้ตัว เรื่องค่าใช้จ่ายก็ควรได้รับความสนใจเช่นเดียวกันเมื่อคุณกำหนดค่า runner ที่ใช้โมเดล: งบประมาณสำหรับค่าใช้จ่ายของ agent บน VPS ก่อนที่จะให้มันทำงานกับระบบ production ที่มีทราฟฟิกสูง และควร บันทึกสิ่งที่ agent ได้ทำลงไปจริง เพื่อให้ pull request ที่น่าประหลาดใจมีร่องรอยการตรวจสอบรองรับอยู่เบื้องหลัง
ข้อผิดพลาดที่คุณจะพบและสตริงที่ระบุข้อผิดพลาดเหล่านั้น
ERR_PNPM_UNSUPPORTED_ENGINEระหว่างpnpm installหมายความว่าความต้องการของเอนจินไม่เข้ากัน pnpm 9.12.0 จะตรวจสอบทั้งความต้องการของ Node และ pnpm ให้อ่านเวอร์ชันที่ต้องการและเวอร์ชันปัจจุบันในข้อความผิดพลาด จากนั้นตรวจสอบnode -vและpnpm -vECONNREFUSED 127.0.0.1:5434ระหว่างการย้ายข้อมูลหมายความว่า compose stack ยังไม่ทำงาน หรือDATABASE_URLระบุพอร์ตที่ไม่ถูกต้อง- ตรวจสอบการรีสตาร์ทของ ClickHouse ด้วย
docker compose logs clickhouseจากนั้นตรวจสอบคอนเทนเนอร์ว่าOOMKilledมีค่าเป็นtrueหรือไม่ - Exporter ที่รายงานว่าสำเร็จในขณะที่เว็บแอปยังว่างเปล่า มักหมายความว่าข้อมูลถูกส่งตรงไปยัง collector ที่พอร์ต 4318 ซึ่งข้ามขั้นตอนการประทับตราโปรเจกต์ที่ proxy ทำไว้
- Connection refused ที่พอร์ต 4101 มักหมายความว่า proxy กำลังฟังอยู่ที่พอร์ต 4000 ซึ่งเป็นพอร์ตสำรองที่โค้ดจะเลือกใช้หากไม่ได้กำหนดค่าไว้ และเป็นพอร์ตที่
.env.exampleของมันตั้งค่าไว้ ให้กำหนดPORTให้ชัดเจนใน unit file หรือใน.envของแอป docker compose psที่แสดง0.0.0.0:8123หมายความว่าการผูกค่า loopback ของคุณไม่มีผล ให้รันdocker compose configแล้วอ่านพอร์ตที่ถูก resolve ออกมา
Flawless, HyperProbe และตำแหน่งของ Superlog
หมวดหมู่นี้ยังถือว่าใหม่ และเครื่องมือแต่ละตัวมีความแตกต่างกันในเรื่องขอบเขตที่อนุญาตให้ agent เข้าถึงได้ ปัจจุบัน repository ของ Flawless ได้นำเสนอ CISRE ซึ่งเป็นแพลตฟอร์ม AI SRE (site reliability engineering) สำหรับ Kubernetes และโครงสร้างพื้นฐานบนคลาวด์ ภายใต้สัญญาอนุญาต PolyForm Noncommercial ส่วน HyperProbe จะทำการฝัง probe ไว้ภายใน process ที่กำลังทำงานอยู่เพื่อดักจับสถานะของตัวแปร และเปิดเผยสถานะดังกล่าวให้กับผู้ช่วยผ่านโปรโตคอล MCP (model context protocol) นอกจากนี้ยังมีการจัดทำเอกสารสำหรับการ self-hosting ด้วย Docker Compose และการใช้ license key ไว้ด้วย
Superlog มีตำแหน่งอยู่กึ่งกลางระหว่างเครื่องมือทั้งสองตัว โดยเป็นเจ้าของ pipeline ตั้งแต่ต้นจนจบ ตั้งแต่การรับข้อมูลผ่าน OTLP ไปจนถึงการจัดเก็บข้อมูลใน ClickHouse และวางตำแหน่ง agent ไว้ในขั้นตอนการคัดกรอง (triage) แทนที่จะเป็นขั้นตอนการแก้ไข (fix) การออกแบบเช่นนี้คือเหตุผลว่าทำไมการ self-host Superlog จึงเป็นการตัดสินใจในระดับโครงสร้างพื้นฐาน ไม่ใช่แค่ container ที่ติดตั้งแล้วปล่อยทิ้งไว้ เมื่อคุณรัน Superlog คุณกำลังรัน column store ซึ่งจำเป็นต้องได้รับการดูแลเช่นเดียวกับฐานข้อมูลอื่นๆ ที่คุณเป็นเจ้าของ
FAQ
Superlog ที่โฮสต์เองต้องใช้ RAM เท่าไร?
ควรเตรียม RAM 8 GB, 4 vCPU และพื้นที่ดิสก์ 40 GB สำหรับโหนดเดียวที่มีปริมาณการรับข้อมูลต่ำ สแต็กประกอบด้วย Postgres, ClickHouse, OpenTelemetry collector และ Node process อีกสี่รายการ โดย ClickHouse ต้องการหน่วยความจำสำรองไว้ใช้งาน ควรวัดค่าด้วยตนเองโดยใช้ docker stats --no-stream และ free -m แทนการเชื่อตัวเลขที่เผยแพร่ทั่วไป รวมถึงตัวเลขนี้ด้วย
ฉันควรชี้ OTLP exporter ไปที่พอร์ตใด?
ให้ชี้ไปที่ Superlog intake proxy ซึ่ง README ระบุไว้ที่ http://localhost:4101 โดย proxy นี้ให้บริการ /v1/traces, /v1/logs และ /v1/metrics และจะตรวจสอบสิทธิ์ด้วย ingest key ของโปรเจกต์คุณที่ดึงมาจาก header x-api-key หรือ header authorization: bearer ส่วนพอร์ต 4318 คือ OpenTelemetry collector ที่อยู่เบื้องหลัง หากส่งข้อมูลไปที่นั่นโดยตรงจะเป็นการข้าม proxy ซึ่งเป็นส่วนประกอบที่ทำหน้าที่ระบุ project id ลงในข้อมูลของคุณ โดยปกติ proxy จะใช้พอร์ต 4000 หากไม่ได้ตั้งค่า PORT และค่า .env.example ก็กำหนดไว้ที่ 4000 เช่นกัน ดังนั้นให้รันคำสั่ง ss -lntp เพื่อยืนยันว่าพอร์ตใดถูกใช้งานจริงก่อนจะสรุปว่าเป็น 4101
Superlog สามารถแทนที่ Uptime Kuma หรือ Zabbix ได้หรือไม่?
ไม่ได้ Uptime Kuma ทำหน้าที่ตรวจสอบว่า endpoint ตอบสนองจากภายนอกเครือข่ายหรือไม่ ส่วน Zabbix ทำหน้าที่เฝ้าระวัง metric ของโฮสต์และบริการตามเกณฑ์ที่คุณกำหนด ในขณะที่ Superlog ทำหน้าที่รับ traces, logs และ metrics ที่แอปพลิเคชันของคุณส่งออกมา และจัดกลุ่มความล้มเหลวที่เกิดขึ้นซ้ำๆ ให้เป็น incident คุณควรมีเครื่องมือตรวจสอบ uptime จากภายนอกควบคู่ไปด้วย เพราะเครื่องมือที่รันจากที่อื่นจะยังคงรายงานผลได้แม้ในกรณีที่เซิร์ฟเวอร์ซึ่งรัน telemetry pipeline ของคุณเกิดล่มไป
Superlog agent สามารถเปลี่ยนแปลงระบบ production ของฉันได้หรือไม่?
ทำได้เฉพาะผ่านสิทธิ์ที่คุณอนุญาตเท่านั้น ตัว community runner เริ่มต้นจะบันทึกสรุป incident ไว้ในเครื่อง ส่วน runtime สำหรับการตรวจสอบอื่นๆ จะขึ้นอยู่กับ runner ที่คุณกำหนดค่าไว้ ควรจำกัดสิทธิ์ของ credentials ใน production ให้ทำได้เพียงการอ่านเท่านั้น การเปิด pull requests ต้องใช้สิทธิ์เขียน GitHub แยกต่างหากสำหรับ branch และ pull requests การให้สิทธิ์เขียนใน production เป็นการตัดสินใจที่ต้องพิจารณาอย่างรอบคอบ เพราะ agent ที่สามารถรีสตาร์ทบริการได้นั้นมีความเสี่ยงสูงกว่า agent ที่ทำหน้าที่เพียงอ่าน telemetry และเขียน patch เพื่อให้ตรวจสอบก่อนนำไปใช้
ฉันควรล็อกเวอร์ชันด้วย commit หรือติดตาม branch main?
ควรล็อกเวอร์ชันด้วย commit เนื่องจาก ณ วันที่ 13 ตุลาคม 2026 ยังไม่มีการทำ release tags ใน repository ให้บันทึกค่า SHA ที่คุณทดสอบแล้วนำไป deploy และอ่าน diff ก่อนที่จะอัปเดตเวอร์ชันถัดไป git log --oneline <old-sha>..main คือส่วนของการตรวจสอบ และไฟล์ .env.example ของแต่ละแอปคือจุดแรกที่คุณควรตรวจสอบเพื่อดูตัวแปรที่จำเป็นต้องใช้ใหม่หลังจากมีการอัปเดตเวอร์ชัน