ข้ามไปยังเนื้อหา
mofcloud

การมอนิเตอร์

อัพเดทล่าสุด:

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

เริ่มทำงาน

Terminal
docker compose -f compose.yaml -f compose.monitoring.yaml up -d

นำเข้าแดชบอร์ด

  1. เปิด http://SERVER_IP:3000 ลงชื่อเข้าใช้ด้วย admin / admin แล้วตั้งรหัสผ่านใหม่
  2. 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:

podmonitor.yaml
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_processesmodeโปรเซสที่พบใน 90 วินาทีล่าสุด แยกตามโหมด (all-in-one, web, worker)
mof_account_sync_last_success_timestamp_secondsaccount, provider, dataเวลาที่ซิงค์บิล / ทรัพยากรสำเร็จครั้งล่าสุด SyncAll นับให้ทั้งสองอย่าง
mof_account_sync_failedaccount, provider, data1 เมื่อการซิงค์ข้อมูลนั้นครั้งล่าสุดล้มเหลว
mof_jobskind, stateงานเบื้องหลังแยกตามประเภทและสถานะ (available, running, retryable, discarded…)
mof_license_expiry_timestamp_seconds / mof_license_validวันที่ไลเซนส์หมดอายุ และไลเซนส์ถูกต้องหรือไม่
mof_mcp_requests_totalmethod, resultการเรียกไปยัง MCP gateway ระยะไกล
mof_metrics_database_up0 เมื่อ MOF อ่านฐานข้อมูลของตัวเองไม่ได้
mof_http_requests_totalmethod, route, codeคำขอ API โดย route คือเทมเพลตของเส้นทาง (/v1/mof/prov/account/:accountId/bills) ดังนั้น ID และสแกนเนอร์ที่สุ่มยิงจะไม่เพิ่ม series ส่วน path ที่ไม่รู้จักนับเป็น unmatched
mof_http_request_duration_secondsmethod, routeความหน่วงของ API (histogram รวมข้ามโปรเซสได้)
mof_users / mof_accountsstate / providerผู้ใช้ (ใช้งานอยู่ ถูกปิดใช้งาน) และบัญชีคลาวด์แยกตาม provider
mof_database_size_bytesdatabaseขนาดของแต่ละฐานข้อมูลที่ MOF จัดการ: Mof และฐานข้อมูลบิลของ provider ซึ่งโตขึ้นตามจำนวนบัญชีและจำนวนเดือน
go_sql_*, go_memstats_*, go_goroutinesconnection pool ของฐานข้อมูลและ Go runtime

การแจ้งเตือน

อยู่ใน mof-alerts.yml โดย Prometheus เป็นผู้ประเมิน ส่งต่อด้วย Alertmanager ของคุณ หรือดูใน Grafana → Alerting

การแจ้งเตือนเงื่อนไข
MofDownMOF หยุดตอบการ scrape เป็นเวลา 2 นาที
MofDatabaseUnreachableMOF อ่านฐานข้อมูลของตัวเองไม่ได้
MofAccountSyncFailingบิลหรือทรัพยากรของบัญชีหนึ่งซิงค์ล้มเหลวต่อเนื่อง (30 นาที)
MofAccountSyncStaleไม่มีการซิงค์บิลหรือทรัพยากรของบัญชีหนึ่งที่สำเร็จเลยเป็นเวลา 36 ชั่วโมง
MofJobsDiscardedมีงานเบื้องหลังล้มเหลวถาวรในชั่วโมงที่ผ่านมา
MofJobBacklogมีงานรอมากกว่า 50 งานเป็นเวลา 30 นาที: เพิ่ม worker หรือหางานที่ค้างอยู่
MofHighErrorRateคำขอ API มากกว่า 5% ล้มเหลวด้วย 5xx เป็นเวลา 10 นาที
MofLicenseExpiringไลเซนส์จะหมดอายุภายใน 14 วัน