监控

Ultralytics 已部署的终端节点提供监控服务。通过自动轮询功能，可追踪请求指标、查看日志并检查健康状态。

部署仪表板

字段 Deploy 侧边栏中的页面作为所有部署的监控仪表板，将世界地图、概览指标和部署管理整合于单一视图中。查看 专用端点 用于创建和管理部署。

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

概览卡片

页面顶部的四张摘要卡显示：

世界地图

交互式世界地图显示：

• 所有43个可用区域的区域图钉
• 已部署区域的绿色图钉
• 正在进行部署的区域以蓝色动画图钉标注
• 引脚尺寸根据部署状态和延迟而变化

部署列表

在概览卡片下方，部署列表会显示您所有项目中的所有端点。使用视图模式切换按钮可在以下模式间切换：

按部署计费指标

每张部署卡（在卡片视图中）显示实时指标：

指标行

指标数据从微型图表API端点获取，并每60秒刷新一次。

健康检查

正在运行的部署显示健康检查指示器：

健康检查在状态异常时每20秒自动重试。点击刷新图标可手动触发健康检查。该检查采用55秒超时时间，以适应缩减至零端点的冷启动场景。

日志

每张部署卡包含一个 Logs 用于查看最近日志条目的标签页：

日志条目

每个日志条目显示：

用户界面显示最近的20条记录。API默认每次请求返回50条记录（最多200条）。

代码示例

每张部署卡包含一个 Code 标签页展示可直接使用的API代码，内含您的实际端点URL和API密钥：

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())

// Build form data with image and parameters
const formData = new FormData();
formData.append("file", fileInput.files[0]);
formData.append("conf", "0.25");
formData.append("iou", "0.7");
formData.append("imgsz", "640");

// Send image for inference
const response = await fetch(
  "https://predict-abc123.run.app/predict",
  {
    method: "POST",
    headers: { Authorization: "Bearer YOUR_API_KEY" },
    body: formData,
  }
);

const result = await response.json();
console.log(result);

# Send image for inference
curl -X POST "https://predict-abc123.run.app/predict" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@image.jpg" \
  -F "conf=0.25" \
  -F "iou=0.7" \
  -F "imgsz=640"

部署预测

字段 Predict 每个部署卡上的标签页都提供了一个内联预测面板——与模型的界面相同。 Predict 标签页，但通过部署端点而非共享服务运行推理。这有助于直接从浏览器测试已部署的端点。参见 推理 有关参数详情和响应格式。

API 端点

监控概览

GET /api/monitoring

返回经身份验证的用户拥有的所有部署的汇总指标。通过可选参数实现工作区感知。 owner 查询参数。

部署指标

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

返回特定部署的微型图数据和摘要指标。刷新间隔：60秒。

部署日志

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

返回最近日志条目，可选严重性过滤器和分页功能。

部署健康状况

GET /api/deployments/{deploymentId}/health

返回健康检查状态及响应延迟。

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

性能优化

利用监控数据优化部署：

常见问题

数据保留多长时间？

我能否设置外部监控？

是的，端点 URL 可与外部监控工具配合使用：

• 正常运行时间监控 (Pingdom, UptimeRobot)
• APM 工具 (Datadog, New Relic)
• 通过自定义健康检查 /health 端点

延迟数据的准确性如何？

延迟指标衡量：

• P50：中位响应时间
• P95：第95百分位
• P99：第99百分位

这些表示服务器端处理时间，不包括到用户端的网络延迟。

为什么我的指标会延迟？

指标存在约2分钟的延迟，原因如下：

• 指标聚合管道
• 聚合窗口
• 仪表板缓存

对于实时调试，请检查几乎即时的日志。

我能否同时监控多个端点？

是的，部署页面会显示所有端点及其汇总概览卡片。请使用表格视图来比较不同部署之间的性能表现。

📅 创建于 1 个月前 ✏️ 更新于 4 天前

评论