Bỏ qua để đến nội dung
mofcloud

Giám sát

Cập nhật lần cuối:

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

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

Nhập dashboard

  1. Mở http://SERVER_IP:3000, đăng nhập bằng admin / admin và đặt mật khẩu mới.
  2. 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ệpCô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:

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

Metric

MetricLabelÝ nghĩa
mof_processesmodeCá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_secondsaccount, provider, dataThờ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_failedaccount, provider, data1 khi lần đồng bộ gần nhất của dữ liệu đó thất bại.
mof_jobskind, stateJob nền theo loại và trạng thái (available, running, retryable, discarded…).
mof_license_expiry_timestamp_seconds / mof_license_validThờ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_totalmethod, resultSố lần gọi tới MCP gateway từ xa.
mof_metrics_database_up0 khi MOF không đọc được cơ sở dữ liệu của mình.
mof_http_requests_totalmethod, route, codeRequest 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_secondsmethod, routeĐộ trễ API (histogram, cộng dồn được giữa các tiến trình).
mof_users / mof_accountsstate / providerNgười dùng (hoạt động, bị vô hiệu hóa) và tài khoản cloud theo provider.
mof_database_size_bytesdatabaseDung 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_goroutinesPool 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
MofDownMOF ngừng phản hồi scrape trong 2 phút.
MofDatabaseUnreachableMOF không đọc được cơ sở dữ liệu của mình.
MofAccountSyncFailingHó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).
MofAccountSyncStaleKhô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ờ.
MofJobsDiscardedJob nền thất bại vĩnh viễn trong một giờ qua.
MofJobBacklogHơn 50 job chờ trong 30 phút: thêm worker hoặc tìm job bị treo.
MofHighErrorRateHơn 5% request API lỗi 5xx trong 10 phút.
MofLicenseExpiringGiấy phép hết hạn trong vòng 14 ngày.