YOLO Vision 2026:

Мониторинг#

Ultralytics Platform предоставляет мониторинг для развернутых эндпоинтов. Отслеживай метрики запросов, просматривай логи и проверяй статус работоспособности с помощью автоматического опроса.

Ultralytics Platform Deploy Page Overview Cards And World Map

Дашборд развертываний#

Страница Deploy в боковой панели служит дашбордом для мониторинга всех твоих развертываний. Она объединяет карту мира, обзорные метрики и управление развертываниями в одном представлении. Ознакомься с разделом Выделенные эндпоинты для создания и управления развертываниями.

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

Карточки обзора#

Четыре сводные карточки в верхней части страницы показывают:

Ultralytics Platform Deploy Page Four Overview Cards

МетрикаОписание
Всего запросов (24ч)Запросы по всем эндпоинтам
Активные развертыванияЗапущенные в данный момент эндпоинты
Частота ошибок (24ч)Процент неудачных запросов
P95 задержка (24ч)95-й перцентиль времени отклика
Оповещение о частоте ошибок

Карточка частоты ошибок подсвечивается красным, если этот показатель превышает 5%. Перейди на вкладку Logs для конкретного развертывания, чтобы диагностировать ошибки.

Карта мира#

Интерактивная карта мира показывает:

  • Региональные пины для всех 42 доступных регионов
  • Зеленые пины для развернутых регионов
  • Анимированные синие пины для регионов, в которых идет процесс развертывания
  • Размер пина меняется в зависимости от статуса развертывания и задержки

Ultralytics Platform Deploy Page World Map With Deployed Regions

Список развертываний#

Под карточками обзора находится список всех эндпоинтов в твоих проектах. Используй переключатель режима просмотра для выбора между:

ВидОписание
CardsКарточками с полной информацией, включая вкладки метрик, логов, кода и предсказаний
CompactСеткой из компактных карточек (1–4 столбца) с основными метриками
TableТаблицей данных с сортируемыми столбцами: Имя, Регион, Статус, Запросы, P95, Ошибки
Обновления в реальном времени

Дашборд опрашивает сервер каждые 15 секунд для получения обновлений статуса развертывания. Когда развертывания находятся в переходном состоянии (creating, deploying или stopping), частота опроса увеличивается до одного раза в 3 секунды. Метрики для каждого развертывания обновляются каждые 60 секунд. Нажми кнопку обновления для получения актуальных данных.

Метрики для каждого развертывания#

Каждая карточка развертывания (в режиме отображения карточками) показывает метрики в реальном времени:

Ряд метрик#

МетрикаОписание
ЗапросыКоличество запросов (24ч) со значком
P95 задержка95-й перцентиль времени отклика
Частота ошибокПроцент неудачных запросов

Метрики извлекаются из эндпоинта спарклайн API и обновляются каждые 60 секунд.

Проверка работоспособности#

Запущенные развертывания отображают индикатор работоспособности:

ИндикаторЗначение
Зеленое сердцеРаботает исправно — показывает задержку отклика
Красное сердцеОшибка — показывает сообщение об ошибке
Вращающийся значокИдет проверка работоспособности

Проверки работоспособности автоматически повторяются каждые 20 секунд в случае ошибки. Нажми на значок обновления, чтобы запустить проверку вручную. Проверка использует тайм-аут 55 секунд, чтобы учесть холодный старт эндпоинтов с масштабированием до нуля.

Ultralytics Platform Deployment Card Health Check Healthy With Latency

Устойчивость к холодному старту

Запрос проверки работоспособности ожидает ответа до 55 секунд, чтобы у эндпоинта с масштабированием до нуля было время на запуск.

Логи#

Каждая карточка развертывания содержит вкладку Logs для просмотра последних записей:

Ultralytics Platform Deployment Card Logs Tab With Severity Filter

Записи логов#

Каждая запись лога показывает:

ПолеОписание
СерьезностьЦветовая полоса (см. ниже)
Метка времениВремя запроса (локальный формат)
СообщениеСодержимое лога
HTTP информацияКод статуса и задержка (если применимо)

Фильтруй логи по уровню серьезности с помощью кнопок:

УровеньЦветОписание
DEBUGСерыйОтладочные сообщения
INFOСинийОбычные запросы
WARNINGЖелтыйНекритические проблемы
ERRORКрасныйНеудачные запросы
CRITICALТемно-красныйКритические сбои

Интерфейс показывает 20 последних записей. API по умолчанию возвращает 50 записей на запрос (макс. 200).

Процесс отладки

При расследовании ошибок: сначала нажми Ошибки, чтобы отфильтровать записи ERROR и WARNING, затем проверь метки времени и HTTP-коды статусов. Копируй логи в буфер обмена, чтобы поделиться ими с командой.

Примеры кода#

Каждая карточка развертывания содержит вкладку 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())
Автоматически заполняемые учетные данные

При просмотре вкладки Code на платформе URL твоего эндпоинта и API-ключ заполняются автоматически. Скопируй код и запусти его напрямую. См. раздел API Ключи для генерации ключа.

Инференс развертывания (Deployment Predict)#

Вкладка Predict на каждой карточке развертывания предоставляет встроенную панель предсказаний — это тот же интерфейс, что и вкладка Predict у модели, но запуск инференса происходит через эндпоинт развертывания, а не через общий сервис. Это полезно для тестирования развернутого эндпоинта прямо из браузера. Подробную информацию о параметрах и форматах ответов смотри в Inference.

API эндпоинты#

Обзор мониторинга#

GET /api/monitoring

Возвращает агрегированные метрики для всех развертываний, принадлежащих авторизованному пользователю. Учитывает рабочую область через необязательный параметр запроса owner.

Метрики развертывания#

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

Возвращает спарклайн-данные и сводные метрики для конкретного развертывания. Интервал обновления: 60 секунд.

ПараметрТипОписание
sparklineboolВключить спарклайн-данные
rangestringВременной диапазон: 1h, 6h, 24h, 7d или 30d

Логи развертывания#

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

Возвращает последние записи логов с возможностью фильтрации по уровню серьезности и пагинацией.

ПараметрТипОписание
limitintМаксимальное количество записей (по умолчанию: 50, макс: 200)
severitystringФильтр серьезности, разделенный запятыми
pageTokenstringТокен пагинации из предыдущего ответа

Состояние развертывания#

GET /api/deployments/{deploymentId}/health

Возвращает статус проверки работоспособности (health check) с задержкой ответа.

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

Оптимизация производительности#

Используй данные мониторинга для оптимизации своих развертываний:

Если задержка слишком высокая:

  1. Убедись, что размер модели подходит
  2. Рассмотри использование более близкого региона
  3. Проверь размер изображения, отправляемого с каждым запросом
Снижение задержки

Попробуй уменьшить значение imgsz и сравни получившуюся задержку и точность для своей модели. Разверни в регионе ближе к клиентам, чтобы уменьшить сетевую задержку.

FAQ#

Как долго хранятся данные?#

API метрик поддерживает выборку временных окон от 1 часа до 30 дней. Карточка развертывания показывает 20 последних записей логов; API логов может возвращать до 200 записей за запрос и поддерживает пагинацию.

Можно ли мониторить несколько эндпоинтов вместе?#

Да, страница развертываний показывает все эндпоинты с карточками общего обзора. Используй табличный вид для сравнения производительности между развертываниями.

Комментарии