MOF cung cấp metric Prometheus: tiến trình, việc đồng bộ hóa đơn và tài nguyên, job nền, giấy phép, lưu lượng HTTP và MCP. Thêm Prometheus và Grafana bên cạnh MOF, hoặc trỏ hệ thống sẵn có của bạn tới MOF.
- Yêu cầu
- MOF v2.0.14+
- Endpoint metric
http://mof:8080/internal/v1/mof/metrics- Phạm vi truy cập
- Chỉ nội bộ: Dash không chuyển tiếp path này.
Docker Compose
Thêm Prometheus và Grafana bên cạnh MOF. Prometheus có sẵn quy tắc cảnh báo của MOF, Grafana có sẵn Prometheus làm nguồn dữ liệu.
Tải xuống
Đặt cả hai tệp cạnh compose.yaml.
Khởi động
docker compose -f compose.yaml -f compose.monitoring.yaml up -dNhập dashboard
- Mở
http://SERVER_IP:3000, đăng nhập bằng admin / admin và đặt mật khẩu mới. - Dashboards → New → Import → Upload dashboard JSON file, rồi chọn mof-grafana-dashboard.json.
- Chỉ cho phép cổng 3000 từ mạng của bạn.
- Thêm khoảng 300 MB bộ nhớ; Prometheus giữ dữ liệu 15 ngày. Image:
prom/prometheus:v2.53.1,grafana/grafana:11.1.0; Docker Compose v2.23+. - Truyền cả hai tệp ở các lệnh sau này (pull, up -d), nếu không các service giám sát sẽ bị bỏ sót.
Prometheus và Grafana sẵn có
| Tệp | Công dụng |
|---|---|
| prometheus.yml ↓ | Scrape job cho MOF. Prometheus phải truy cập được cổng 8080 của MOF qua mạng riêng của bạn. |
| mof-alerts.yml ↓ | Quy tắc cảnh báo; thêm vào mục rule_files. |
| mof-grafana-dashboard.json ↓ | Nhập vào Grafana và chọn nguồn dữ liệu Prometheus của bạn. |
Khi có nhiều tiến trình web, mỗi tiến trình báo cáo giá trị chung của toàn bộ triển khai (tiến trình, đồng bộ, job); dashboard và quy tắc dùng max(), nên scrape tất cả là được. Worker không phục vụ HTTP; công việc của chúng được phản ánh qua các tiến trình web.
Kubernetes
Các Pod MOF có sẵn annotation prometheus.io thông thường (scrape, cổng 8080, path), nên Prometheus phát hiện Pod theo annotation sẽ tự nhận. Với Prometheus Operator, thêm một 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: 30sMetric
| Metric | Label | Ý nghĩa |
|---|---|---|
mof_processes | mode | Các tiến trình hoạt động trong 90 giây gần nhất, theo chế độ (all-in-one, web, worker). |
mof_account_sync_last_success_timestamp_seconds | account, provider, data | Thời điểm hóa đơn / tài nguyên được đồng bộ thành công gần nhất. Một lần SyncAll được tính cho cả hai. |
mof_account_sync_failed | account, provider, data | 1 khi lần đồng bộ gần nhất của dữ liệu đó thất bại. |
mof_jobs | kind, state | Job nền theo loại và trạng thái (available, running, retryable, discarded…). |
mof_license_expiry_timestamp_seconds / mof_license_valid | Thời điểm giấy phép hết hạn, và giấy phép có hợp lệ không. | |
mof_mcp_requests_total | method, result | Số lần gọi tới MCP gateway từ xa. |
mof_metrics_database_up | 0 khi MOF không đọc được cơ sở dữ liệu của mình. | |
mof_http_requests_total | method, route, code | Request API. route là template của route (/v1/mof/prov/account/:accountId/bills), nên ID và các scanner dò quét không tạo thêm series; path không xác định được tính là unmatched. |
mof_http_request_duration_seconds | method, route | Độ trễ API (histogram, cộng dồn được giữa các tiến trình). |
mof_users / mof_accounts | state / provider | Người dùng (hoạt động, bị vô hiệu hóa) và tài khoản cloud theo provider. |
mof_database_size_bytes | database | Dung lượng của từng cơ sở dữ liệu MOF quản lý: Mof và các cơ sở dữ liệu hóa đơn của provider, tăng theo số tài khoản và số tháng. |
go_sql_*, go_memstats_*, go_goroutines | Pool kết nối cơ sở dữ liệu và Go runtime. |
Cảnh báo
Trong mof-alerts.yml. Prometheus đánh giá các quy tắc này; định tuyến bằng Alertmanager của bạn, hoặc xem trong Grafana → Alerting.
| Cảnh báo | Điều kiện |
|---|---|
MofDown | MOF ngừng phản hồi scrape trong 2 phút. |
MofDatabaseUnreachable | MOF không đọc được cơ sở dữ liệu của mình. |
MofAccountSyncFailing | Hóa đơn hoặc tài nguyên của một tài khoản liên tục đồng bộ thất bại (30 phút). |
MofAccountSyncStale | Không có lần đồng bộ hóa đơn hoặc tài nguyên thành công nào của một tài khoản trong 36 giờ. |
MofJobsDiscarded | Job nền thất bại vĩnh viễn trong một giờ qua. |
MofJobBacklog | Hơn 50 job chờ trong 30 phút: thêm worker hoặc tìm job bị treo. |
MofHighErrorRate | Hơn 5% request API lỗi 5xx trong 10 phút. |
MofLicenseExpiring | Giấy phép hết hạn trong vòng 14 ngày. |