Monitorización

Ultralytics Platform proporciona monitorización para los endpoints desplegados. Realiza un seguimiento de las métricas de solicitud, consulta los registros y comprueba el estado de salud con sondeos automáticos.

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, las métricas de resumen y la gestión de despliegues en una sola vista. Consulta Dedicated Endpoints para crear y gestionar despliegues.

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

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 43 regiones disponibles
• Marcadores verdes para las regiones desplegadas
• Marcadores azules animados para regiones con despliegues activos en curso
• 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 alternar 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 desde el endpoint de la API sparkline y se actualizan cada 60 segundos.

Control de salud (Health Check)

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 están saludables. Haz clic en el icono de actualización para activar manualmente una comprobación de estado. La comprobación utiliza un tiempo de espera de 55 segundos para adaptarse a los 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 como valor predeterminado 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 tu 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())

Predict en despliegue

La pestaña Predict en cada tarjeta de despliegue 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 despliegue en lugar del servicio compartido. Esto es útil para probar un endpoint desplegado directamente desde el navegador. Consulta Inference para conocer 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 todos los despliegues propiedad del usuario autenticado. Reconoce el espacio de trabajo mediante el parámetro de consulta opcional owner.

Métricas de despliegue

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

Devuelve datos de sparkline y métricas de resumen para un despliegue específico. Intervalo de actualización: 60 segundos.

Registros de despliegue

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

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

Estado del despliegue

GET /api/deployments/{deploymentId}/health

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

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

Optimización del rendimiento

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

Preguntas frecuentes

¿Cuánto tiempo se retienen los datos?

¿Puedo configurar una monitorización externa?

Sí, las URLs de endpoint funcionan con herramientas de monitorización externas:

• Monitorización de tiempo de actividad (Pingdom, UptimeRobot)
• Herramientas APM (Datadog, New Relic)
• Comprobaciones de salud personalizadas a través del endpoint /health

¿Qué precisión tienen las cifras de latencia?

Las métricas de latencia miden:

• P50: Tiempo de respuesta mediano
• P95: Percentil 95
• P99: Percentil 99

Estos valores representan el tiempo de procesamiento en el lado del servidor, sin incluir la latencia de red para tus usuarios.

¿Por qué mis métricas tienen retraso?

Las métricas tienen un retraso de ~2 minutos debido a:

• Canalización de agregación de métricas
• Ventanas de agregación
• Almacenamiento en caché del panel

Para una depuración en tiempo real, consulta los registros, que son casi instantáneos.

¿Puedo monitorizar varios endpoints juntos?

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