Monitorización#

Ultralytics Platform proporciona monitorización para endpoints desplegados. Haz el seguimiento de las métricas de peticiones, visualiza registros y comprueba el estado de salud con sondeo automático.

Panel de despliegues#

La página Deploy en la barra lateral sirve como panel de control de monitorización para todos tus despliegues. Combina el mapa mundial, métricas generales y la gestión de despliegues en una única vista. Consulta Dedicated Endpoints para crear y gestionar despliegues.

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

Tarjetas de resumen#

Cuatro tarjetas de resumen en la parte superior de la página muestran:

Mapa mundial#

El mapa mundial interactivo muestra:

• Marcadores de región para las 42 regiones disponibles
• Marcadores verdes para las regiones desplegadas
• Marcadores azules animados para regiones con despliegues activos en progreso
• El tamaño del marcador varía según el estado del despliegue y la latencia

Lista de despliegues#

Debajo de las tarjetas de resumen, la lista de despliegues muestra todos los endpoints de tus proyectos. Utiliza el selector de modo de vista para cambiar entre:

Métricas por despliegue#

Cada tarjeta de despliegue (en la vista de tarjetas) muestra métricas en tiempo real:

Fila de métricas#

Las métricas se obtienen del endpoint de la API de sparkline y se actualizan cada 60 segundos.

Comprobación de estado#

Los despliegues en ejecución muestran un indicador de comprobación de estado:

Las comprobaciones de estado se reintentan automáticamente cada 20 segundos cuando no son saludables. Haz clic en el icono de refrescar para activar manualmente una comprobación de estado. La comprobación utiliza un tiempo de espera de 55 segundos para adaptarse a arranques en frío en endpoints con escalado a cero.

Registros#

Cada tarjeta de despliegue incluye una pestaña Logs para ver las entradas de registro recientes:

Entradas de registro#

Cada entrada de registro muestra:

La interfaz muestra las 20 entradas más recientes. La API tiene un límite por defecto de 50 entradas por solicitud (máximo 200).

Ejemplos de código#

Cada tarjeta de despliegue incluye una pestaña Code que muestra código de API listo para usar con tu URL de endpoint real y clave de 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())

Inferencia de despliegue#

La pestaña Predict en cada tarjeta de implementación proporciona un panel de predicción integrado: la misma interfaz que la pestaña Predict del modelo, pero ejecutando la inferencia a través del endpoint de implementación en lugar del servicio compartido. Esto es útil para probar un endpoint implementado directamente desde el navegador. Consulta Inference para ver los detalles de los parámetros y los formatos de respuesta.

Endpoints de la API#

Descripción general de la monitorización#

GET /api/monitoring

Devuelve métricas agregadas para todas las implementaciones propiedad del usuario autenticado. Reconoce el espacio de trabajo mediante el parámetro de consulta opcional owner.

Métricas de implementación#

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

Devuelve datos de minigráficos (sparkline) y métricas de resumen para una implementación específica. Intervalo de actualización: 60 segundos.

Registros de implementación#

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

Devuelve entradas de registro recientes con filtro de gravedad y paginación opcionales.

Estado de la implementación#

GET /api/deployments/{deploymentId}/health

Devuelve el estado de la comprobación de salud junto con la latencia de respuesta.

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

Optimización del rendimiento#

Usa los datos de monitorización para optimizar tus implementaciones:

FAQ#

¿Cuánto tiempo se retienen los datos?#

La API de métricas admite ventanas seleccionables desde 1 hora hasta 30 días. La tarjeta de despliegue muestra las 20 entradas de registro más recientes; la API de registros puede devolver hasta 200 entradas por solicitud y admite paginación.

¿Puedo monitorizar varios endpoints juntos?#

Sí, la página de implementaciones muestra todos los endpoints con tarjetas de resumen agregadas. Utiliza la vista de tabla para comparar el rendimiento entre implementaciones.