MOF เปิดเผยเมตริก Prometheus ได้แก่ โปรเซส สถานะการซิงค์บิลและทรัพยากร งานเบื้องหลัง ไลเซนส์ และทราฟฟิก HTTP และ MCP เพิ่ม Prometheus และ Grafana ไว้ข้าง MOF หรือชี้ระบบที่มีอยู่แล้วมาที่ MOF
- ต้องการ
- MOF v2.0.14+
- Endpoint เมตริก
http://mof:8080/internal/v1/mof/metrics- การเปิดเผย
- ภายในเท่านั้น: Dash ไม่ส่งต่อ path นี้
Docker Compose
เพิ่ม Prometheus และ Grafana ไว้ข้าง MOF โดย Prometheus มาพร้อมกฎการแจ้งเตือนของ MOF และ Grafana ใช้ Prometheus เป็นแหล่งข้อมูล
ดาวน์โหลด
วางทั้งสองไฟล์ไว้ข้าง compose.yaml
เริ่มทำงาน
docker compose -f compose.yaml -f compose.monitoring.yaml up -dนำเข้าแดชบอร์ด
- เปิด
http://SERVER_IP:3000ลงชื่อเข้าใช้ด้วย admin / admin แล้วตั้งรหัสผ่านใหม่ - Dashboards → New → Import → Upload dashboard JSON file แล้วเลือก mof-grafana-dashboard.json
- อนุญาตพอร์ต 3000 จากเครือข่ายของคุณเท่านั้น
- ใช้หน่วยความจำเพิ่มประมาณ 300 MB และ Prometheus เก็บข้อมูล 15 วัน อิมเมจ:
prom/prometheus:v2.53.1,grafana/grafana:11.1.0ต้องใช้ Docker Compose v2.23 ขึ้นไป - ระบุทั้งสองไฟล์ในคำสั่งต่อๆ ไปด้วย (pull, up -d) มิฉะนั้น service มอนิเตอร์จะถูกข้ามไป
Prometheus และ Grafana ที่มีอยู่
| ไฟล์ | ใช้สำหรับ |
|---|---|
| prometheus.yml ↓ | scrape job สำหรับ MOF โดย Prometheus ต้องเข้าถึงพอร์ต 8080 ของ MOF ผ่านเครือข่ายส่วนตัวของคุณได้ |
| mof-alerts.yml ↓ | กฎการแจ้งเตือน ให้เพิ่มไว้ใต้ rule_files |
| mof-grafana-dashboard.json ↓ | นำเข้าใน Grafana แล้วเลือกแหล่งข้อมูล Prometheus ของคุณ |
เมื่อมีโปรเซส web หลายตัว แต่ละตัวจะรายงานค่าของทั้ง deployment (โปรเซส การซิงค์ งาน) แดชบอร์ดและกฎใช้ max() จึง scrape ทุกตัวได้ไม่มีปัญหา worker ไม่ให้บริการ HTTP งานของ worker จะแสดงผ่านโปรเซส web
Kubernetes
Pod ของ MOF มี annotation prometheus.io ตามปกติ (scrape, พอร์ต 8080, path) ดังนั้น Prometheus ที่ค้นหา Pod ด้วย annotation จะพบเอง หากใช้ Prometheus Operator ให้เพิ่ม PodMonitor:
apiVersion: monitoring.coreos.com/v1
kind: PodMonitor
metadata:
name: mof
namespace: mof
spec:
selector:
matchLabels:
app: mof
podMetricsEndpoints:
- port: api
path: /internal/v1/mof/metrics
interval: 30sเมตริก
| เมตริก | Label | ความหมาย |
|---|---|---|
mof_processes | mode | โปรเซสที่พบใน 90 วินาทีล่าสุด แยกตามโหมด (all-in-one, web, worker) |
mof_account_sync_last_success_timestamp_seconds | account, provider, data | เวลาที่ซิงค์บิล / ทรัพยากรสำเร็จครั้งล่าสุด SyncAll นับให้ทั้งสองอย่าง |
mof_account_sync_failed | account, provider, data | 1 เมื่อการซิงค์ข้อมูลนั้นครั้งล่าสุดล้มเหลว |
mof_jobs | kind, state | งานเบื้องหลังแยกตามประเภทและสถานะ (available, running, retryable, discarded…) |
mof_license_expiry_timestamp_seconds / mof_license_valid | วันที่ไลเซนส์หมดอายุ และไลเซนส์ถูกต้องหรือไม่ | |
mof_mcp_requests_total | method, result | การเรียกไปยัง MCP gateway ระยะไกล |
mof_metrics_database_up | 0 เมื่อ MOF อ่านฐานข้อมูลของตัวเองไม่ได้ | |
mof_http_requests_total | method, route, code | คำขอ API โดย route คือเทมเพลตของเส้นทาง (/v1/mof/prov/account/:accountId/bills) ดังนั้น ID และสแกนเนอร์ที่สุ่มยิงจะไม่เพิ่ม series ส่วน path ที่ไม่รู้จักนับเป็น unmatched |
mof_http_request_duration_seconds | method, route | ความหน่วงของ API (histogram รวมข้ามโปรเซสได้) |
mof_users / mof_accounts | state / provider | ผู้ใช้ (ใช้งานอยู่ ถูกปิดใช้งาน) และบัญชีคลาวด์แยกตาม provider |
mof_database_size_bytes | database | ขนาดของแต่ละฐานข้อมูลที่ MOF จัดการ: Mof และฐานข้อมูลบิลของ provider ซึ่งโตขึ้นตามจำนวนบัญชีและจำนวนเดือน |
go_sql_*, go_memstats_*, go_goroutines | connection pool ของฐานข้อมูลและ Go runtime |
การแจ้งเตือน
อยู่ใน mof-alerts.yml โดย Prometheus เป็นผู้ประเมิน ส่งต่อด้วย Alertmanager ของคุณ หรือดูใน Grafana → Alerting
| การแจ้งเตือน | เงื่อนไข |
|---|---|
MofDown | MOF หยุดตอบการ scrape เป็นเวลา 2 นาที |
MofDatabaseUnreachable | MOF อ่านฐานข้อมูลของตัวเองไม่ได้ |
MofAccountSyncFailing | บิลหรือทรัพยากรของบัญชีหนึ่งซิงค์ล้มเหลวต่อเนื่อง (30 นาที) |
MofAccountSyncStale | ไม่มีการซิงค์บิลหรือทรัพยากรของบัญชีหนึ่งที่สำเร็จเลยเป็นเวลา 36 ชั่วโมง |
MofJobsDiscarded | มีงานเบื้องหลังล้มเหลวถาวรในชั่วโมงที่ผ่านมา |
MofJobBacklog | มีงานรอมากกว่า 50 งานเป็นเวลา 30 นาที: เพิ่ม worker หรือหางานที่ค้างอยู่ |
MofHighErrorRate | คำขอ API มากกว่า 5% ล้มเหลวด้วย 5xx เป็นเวลา 10 นาที |
MofLicenseExpiring | ไลเซนส์จะหมดอายุภายใน 14 วัน |