Giám sát

Ultralytics Platform cung cấp tính năng giám sát cho các endpoint đã triển khai. Theo dõi các chỉ số yêu cầu, xem nhật ký (log) và kiểm tra trạng thái sức khỏe hệ thống thông qua cơ chế thăm dò tự động.

Bảng điều khiển triển khai

Trang Deploy trong thanh bên đóng vai trò là bảng điều khiển giám sát cho tất cả các triển khai của bạn. Nó kết hợp bản đồ thế giới, các chỉ số tổng quan và quản lý triển khai vào một chế độ xem duy nhất. Xem Dedicated Endpoints để biết cách tạo và quản lý các triển khai.

graph TB
    subgraph Dashboard
        Map[World Map] --- Cards[Overview Cards]
        Cards --- List[Deployments List]
    end
    subgraph "Per Deployment"
        Metrics[Metrics Row]
        Health[Health Check]
        Logs[Logs Tab]
        Code[Code Tab]
        Predict[Predict Tab]
    end
    List --> Metrics
    List --> Health
    List --> Logs
    List --> Code
    List --> Predict

    style Dashboard fill:#f5f5f5,color:#333
    style Map fill:#2196F3,color:#fff
    style Cards fill:#FF9800,color:#fff
    style List fill:#4CAF50,color:#fff

Thẻ tổng quan

Bốn thẻ tóm tắt ở đầu trang hiển thị:

Bản đồ thế giới

Bản đồ thế giới tương tác hiển thị:

• Ghim khu vực cho tất cả 43 khu vực khả dụng
• Ghim màu xanh lá cho các khu vực đã triển khai
• Ghim màu xanh dương động cho các khu vực đang có triển khai đang được thực hiện
• Kích thước ghim thay đổi dựa trên trạng thái triển khai và độ trễ

Danh sách triển khai

Bên dưới các thẻ tổng quan, danh sách triển khai hiển thị tất cả endpoint trong các dự án của bạn. Sử dụng nút chuyển đổi chế độ xem để chọn giữa:

Chỉ số theo từng triển khai

Mỗi thẻ triển khai (trong chế độ xem thẻ) hiển thị các chỉ số thời gian thực:

Hàng chỉ số

Các chỉ số được lấy từ API endpoint dạng sparkline và làm mới mỗi 60 giây.

Kiểm tra tình trạng dữ liệu (Health Check)

Các triển khai đang chạy hiển thị chỉ báo kiểm tra sức khỏe:

Kiểm tra sức khỏe tự động thử lại sau mỗi 20 giây khi trạng thái không khỏe mạnh. Nhấp vào biểu tượng làm mới để kích hoạt kiểm tra sức khỏe theo cách thủ công. Quá trình kiểm tra sức khỏe sử dụng thời gian chờ 55 giây để đáp ứng các trường hợp khởi động nguội (cold start) trên các endpoint có quy mô thu nhỏ về không.

Nhật ký (Logs)

Mỗi thẻ triển khai bao gồm tab Logs để xem các mục nhật ký gần đây:

Mục nhật ký

Mỗi mục nhật ký hiển thị:

Giao diện người dùng hiển thị 20 mục gần nhất. API mặc định lấy 50 mục cho mỗi yêu cầu (tối đa 200).

Ví dụ mã nguồn

Mỗi thẻ triển khai bao gồm tab Code hiển thị mã API sẵn sàng sử dụng với URL endpoint thực tế và khóa API của bạn:

import requests

# Deployment endpoint
url = "https://predict-abc123.run.app/predict"

# Headers with your deployment API key
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# Inference parameters
data = {"conf": 0.25, "iou": 0.7, "imgsz": 640}

# Send image for inference
with open("image.jpg", "rb") as f:
    response = requests.post(url, headers=headers, data=data, files={"file": f})

print(response.json())

Triển khai Predict

Tab Predict trên mỗi thẻ triển khai cung cấp bảng dự đoán nội dòng — cùng giao diện với tab Predict của model, nhưng thực hiện suy luận thông qua endpoint triển khai thay vì dịch vụ dùng chung. Điều này hữu ích để kiểm tra endpoint đã triển khai trực tiếp từ trình duyệt. Xem Inference để biết chi tiết tham số và định dạng phản hồi.

API Endpoints

Tổng quan về giám sát

GET /api/monitoring

Trả về các số liệu tổng hợp cho tất cả các bản triển khai thuộc sở hữu của người dùng đã xác thực. Hỗ trợ nhận diện workspace thông qua tham số truy vấn tùy chọn owner.

Số liệu triển khai

GET /api/deployments/{deploymentId}/metrics?sparkline=true&range=24h

Trả về dữ liệu sparkline và các số liệu tóm tắt cho một bản triển khai cụ thể. Khoảng thời gian làm mới: 60 giây.

Nhật ký triển khai

GET /api/deployments/{deploymentId}/logs?limit=50&severity=ERROR,WARNING

Trả về các mục nhật ký gần đây với bộ lọc mức độ nghiêm trọng tùy chọn và phân trang.

Tình trạng triển khai

GET /api/deployments/{deploymentId}/health

Trả về trạng thái kiểm tra sức khỏe kèm theo độ trễ phản hồi.

{
    "healthy": true,
    "status": 200,
    "latencyMs": 142
}

Tối ưu hóa hiệu năng

Sử dụng dữ liệu giám sát để tối ưu hóa các bản triển khai của bạn:

Câu hỏi thường gặp (FAQ)

Dữ liệu được lưu giữ trong bao lâu?

Tôi có thể thiết lập giám sát bên ngoài không?

Có, các URL endpoint hoạt động với các công cụ giám sát bên ngoài:

• Giám sát thời gian hoạt động (Pingdom, UptimeRobot)
• Các công cụ APM (Datadog, New Relic)
• Kiểm tra tình trạng sức khỏe tùy chỉnh qua endpoint /health

Các số liệu độ trễ chính xác đến mức nào?

Các số liệu độ trễ đo lường:

• P50: Thời gian phản hồi trung vị
• P95: Phân vị thứ 95
• P99: Phân vị thứ 99

Đây là thời gian xử lý phía máy chủ, không bao gồm độ trễ mạng đến người dùng của bạn.

Tại sao các số liệu của tôi bị trễ?

Các số liệu có độ trễ khoảng ~2 phút do:

• Pipeline tổng hợp số liệu
• Các cửa sổ tổng hợp
• Caching trên bảng điều khiển (Dashboard)

Để gỡ lỗi thời gian thực, hãy kiểm tra nhật ký vì chúng hiển thị gần như tức thì.

Tôi có thể giám sát nhiều endpoint cùng lúc không?

Có, trang triển khai hiển thị tất cả các endpoint với các thẻ tổng quan đã được tập hợp. Sử dụng chế độ xem bảng để so sánh hiệu suất giữa các bản triển khai.