Link to this sectionGiá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 số liệu yêu cầu, xem nhật ký và kiểm tra trạng thái hoạt động với cơ chế tự động thăm dò (polling).

Link to this sectionBảng điều khiển triển khai#

Trang Deploy ở 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. Trang này kết hợp bản đồ thế giới, số liệu tổng quan và quản lý triển khai trong một chế độ xem duy nhất. Xem Dedicated Endpoints để biết cách tạo và quản lý các bản 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

Link to this sectionThẻ tổng quan#

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

Link to this sectionBản đồ thế giới#

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

• Ghim vùng cho tất cả 43 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ễ

Link to this sectionDanh 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:

Link to this sectionSố 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:

Link to this sectionHà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.

Link to this sectionKiể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.

Link to this sectionNhật ký#

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

Link to this sectionMụ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).

Link to this sectionVí 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à API key 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())

Link to this sectionSuy luận triển khai#

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 inference thông qua endpoint triển khai thay vì dịch vụ dùng chung. Điều này hữu ích cho việc kiểm thử một 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.

Link to this sectionCác API Endpoints#

Link to this sectionTổ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 triển khai thuộc sở hữu của người dùng đã xác thực. Nhận biết không gian làm việc (workspace) thông qua tham số truy vấn owner tùy chọn.

Link to this sectionSố 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.

Link to this sectionNhậ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.

Link to this sectionTì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 }
}

Link to this sectionTố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:

Link to this sectionCâu hỏi thường gặp#

Link to this sectionDữ liệu được lưu trữ trong bao lâu?#

Link to this sectionTô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 tùy chỉnh thông qua endpoint /health

Link to this sectionCác con số độ trễ chính xác đến mức nào?#

Số liệu độ trễ đo lường:

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

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

Link to this sectionTại sao số liệu của tôi bị trễ?#

Số liệu có độ trễ ~2 phút do:

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

Để gỡ lỗi thời gian thực, hãy kiểm tra nhật ký vốn có độ trễ gần như tức thì.

Link to this sectionTô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 gộp lại. Sử dụng chế độ xem bảng để so sánh hiệu suất giữa các triển khai.