Monitorización

Ultralytics proporciona supervisión para los terminales implementados. Realice un seguimiento de las métricas de las solicitudes, consulte los registros y compruebe el estado de salud con sondeos automáticos.

Panel de control de implementaciones

El Deploy La página de la barra lateral sirve como panel de control para todas tus implementaciones. Combina el mapa mundial, las métricas generales y la gestión de implementaciones en una sola vista. Ver Endpoints Dedicados para crear y gestionar implementaciones.

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

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

Mapa del mundo

El mapa interactivo del mundo muestra:

• Pines de todas las 43 regiones disponibles
• Pines verdes para regiones desplegadas
• Pines azules animados para regiones con implementaciones activas en curso.
• El tamaño del pin varía en función del estado de implementación y la latencia.

Lista de implementaciones

Debajo de las tarjetas de resumen, la lista de implementaciones muestra todos los puntos finales de sus proyectos. Utilice el botón de cambio de modo de visualización para alternar entre:

Métricas por implementación

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

Fila de métricas

Las métricas se obtienen del punto final de la API de minigráficos y se actualizan cada 60 segundos.

Comprobación del estado

Las implementaciones en ejecución muestran un indicador de estado:

Las comprobaciones de estado se repiten automáticamente cada 20 segundos cuando no están en buen estado. Haga clic en el icono de actualización para activar manualmente una comprobación de estado. La comprobación de estado utiliza un tiempo de espera de 55 segundos para adaptarse a los arranques en frío en los puntos finales de escala a cero.

Registros

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

Entradas de Registro

Cada entrada de registro muestra:

La interfaz de usuario muestra las 20 entradas más recientes. La API muestra por defecto 50 entradas por solicitud (máximo 200).

Ejemplos de Código

Cada tarjeta de despliegue incluye un Code pestaña que muestra el código API listo para usar con su URL de punto final real y su clave 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"

Predicción de implementación

El Predict La pestaña de cada tarjeta de implementación proporciona un panel de predicción en línea, la misma interfaz que el modelo. Predict pestaña, pero ejecutando la inferencia a través del punto final de implementación en lugar del servicio compartido. Esto resulta útil para probar un punto final implementado directamente desde el navegador. Véase Inferencia para obtener detalles sobre los parámetros y los formatos de respuesta.

Puntos finales de API

Descripción general de la supervisión

GET /api/monitoring

Devuelve métricas agregadas para todas las implementaciones propiedad del usuario autenticado. Compatible con el espacio de trabajo a través de opcional. owner parámetro de consulta.

Métricas de implementación

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

Devuelve datos de minigráficos y métricas resumidas 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 recientes del registro con filtro de gravedad opcional y paginación.

Salud de implementación

GET /api/deployments/{deploymentId}/health

Devuelve el estado del chequeo de salud con la latencia de respuesta.

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

Optimización del rendimiento

Utilice los datos de supervisión para optimizar sus implementaciones:

Preguntas frecuentes

¿Cuánto tiempo se retienen los datos?

¿Puedo configurar un monitoreo externo?

Sí, las URL de los puntos finales funcionan con herramientas de monitorización externas:

• Monitoreo de tiempo de actividad (Pingdom, UptimeRobot)
• Herramientas APM (Datadog, New Relic)
• Revisiones médicas personalizadas a través de /health punto final

¿Qué tan precisos son los valores de latencia?

Las métricas de latencia miden:

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

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

¿Por qué mis métricas están retrasadas?

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

• Pipeline de agregación de métricas
• Ventanas de agregación
• Caché del panel de control

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

¿Puedo monitorear múltiples endpoints simultáneamente?

Sí, la página de implementaciones muestra todos los puntos finales con tarjetas de resumen agregadas. Utilice la vista de tabla para comparar el rendimiento entre las diferentes implementaciones.

📅 Creado hace 1 mes ✏️ Actualizado hace 5 días

Comentarios