Giám sát#

Ultralytics Platform cung cấp khả năng giám sát cho các endpoint đã triển khai. Theo dõi các metric yêu cầu, xem nhật ký và kiểm tra trạng thái sức khỏe với cơ chế polling 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 bản triển khai của bạn. Nó kết hợp bản đồ thế giới, các metric tổng quan và quản lý triển khai trong một giao diện duy nhất. Xem phần Dedicated Endpoints để tạo và quản lý các bản triển khai.

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

    classDef proc fill:#2196F3,color:#fff
    classDef decide fill:#FF9800,color:#fff
    classDef out fill:#9C27B0,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 đồ tương tác thế giới hiển thị:

• Ghim vùng (Region pins) cho tất cả 42 vùng khả dụng
• Ghim màu xanh lá cho các vùng đã triển khai
• Ghim xanh dương động cho các vùng đang có triển khai thực thi
• 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ả các endpoint trong các dự án của bạn. Sử dụng nút chuyển chế độ xem để thay đổi giữa:

Số liệu theo từng bản triển khai#

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

Hàng số liệu#

Các số liệu được lấy từ endpoint API sparkline và làm mới mỗi 60 giây.

Kiểm tra tình trạng#

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

Các đợt kiểm tra sức khỏe sẽ 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 thủ công. Quá trình kiểm tra sức khỏe sử dụng thời gian chờ 55 giây để thích ứng với các trạng thái khởi động lạnh (cold start) trên các endpoint mở rộng về 0.

Nhật ký#

Mỗi thẻ triển khai bao gồm một 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 hiển thị 20 mục gần nhất. API mặc định cung cấp 50 mục mỗi yêu cầu (tối đa 200).

Ví dụ mã nguồn#

Mỗi thẻ triển khai bao gồm một tab Code hiển thị mã API sẵn sàng sử dụng kèm theo 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())

Suy luận triển khai#

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

Các API Endpoints#

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

GET /api/monitoring

Trả về các metric 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ợ 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 biểu đồ sparkline và các số liệu tóm tắt cho một 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 tình trạng (health check) cùng với độ trễ phản hồi.

{
    "healthy": true,
    "status": 200,
    "latencyMs": 142,
    "serverTiming": { "db": 8, "ping": 142, "total": 150 }
}

Tối ưu hóa hiệu suất#

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

Câu hỏi thường gặp#