Мониторинг

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 sparkline и обновляются каждые 60 секунд.

Проверка работоспособности (Health Check)

В процессе развертывания отображается индикатор проверки работоспособности:

Проверка работоспособности повторяется автоматически каждые 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 месяц назад ✏️ Обновлено 5 дней назад

Комментарии