Monitoraggio#

Ultralytics Platform fornisce il monitoraggio per gli endpoint distribuiti. Tieni traccia delle metriche delle richieste, visualizza i log e controlla lo stato di salute con il polling automatico.

Dashboard delle distribuzioni#

La pagina Deploy nella barra laterale funge da dashboard di monitoraggio per tutte le tue distribuzioni. Combina la mappa del mondo, le metriche generali e la gestione delle distribuzioni in un'unica vista. Consulta Dedicated Endpoints per creare e gestire le distribuzioni.

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

Schede di panoramica#

Quattro schede di riepilogo nella parte superiore della pagina mostrano:

Mappa del mondo#

La mappa interattiva del mondo mostra:

• Pin della regione per tutte le 42 regioni disponibili
• Pin verdi per le regioni con distribuzioni attive
• Pin blu animati per le regioni con distribuzioni attive in corso
• La dimensione dei pin varia in base allo stato della distribuzione e alla latenza

Elenco delle distribuzioni#

Sotto le schede di panoramica, l'elenco delle distribuzioni mostra tutti gli endpoint nei tuoi progetti. Usa il selettore della modalità di visualizzazione per passare tra:

Metriche per singola distribuzione#

Ogni scheda di distribuzione (nella vista schede) mostra metriche in tempo reale:

Riga delle metriche#

Le metriche vengono recuperate dall'endpoint API sparkline e si aggiornano ogni 60 secondi.

Controllo Integrità#

Le distribuzioni in esecuzione mostrano un indicatore di controllo della salute:

I controlli di salute riprovano automaticamente ogni 20 secondi quando non sono sani. Clicca sull'icona di aggiornamento per attivare manualmente un controllo della salute. Il controllo della salute utilizza un timeout di 55 secondi per adattarsi agli avvii a freddo sugli endpoint scale-to-zero.

Log#

Ogni scheda di distribuzione include una scheda Logs per visualizzare le voci di log recenti:

Voci di log#

Ogni voce di log mostra:

L'interfaccia mostra le 20 voci più recenti. L'API imposta di default 50 voci per richiesta (massimo 200).

Esempi di codice#

Ogni scheda di distribuzione include una scheda Code che mostra codice API pronto all'uso con il tuo URL endpoint effettivo e la chiave 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())

Previsione su deployment#

La scheda Predict su ogni scheda di deployment fornisce un pannello di previsione integrato: la stessa interfaccia della scheda Predict del modello, ma che esegue l'inferenza tramite l'endpoint di deployment invece che tramite il servizio condiviso. Questo è utile per testare un endpoint distribuito direttamente dal browser. Consulta Inference per i dettagli sui parametri e i formati di risposta.

Endpoint API#

Panoramica del monitoraggio#

GET /api/monitoring

Restituisce metriche aggregate per tutti i deployment di proprietà dell'utente autenticato. Consapevole dell'area di lavoro tramite il parametro di query opzionale owner.

Metriche di deployment#

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

Restituisce dati sparkline e metriche di riepilogo per uno specifico deployment. Intervallo di aggiornamento: 60 secondi.

Log di deployment#

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

Restituisce voci di log recenti con filtro di gravità opzionale e impaginazione.

Stato di salute del deployment#

GET /api/deployments/{deploymentId}/health

Restituisce lo stato del controllo di integrità con la latenza di risposta.

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

Ottimizzazione delle prestazioni#

Usa i dati di monitoraggio per ottimizzare i tuoi deployment:

FAQ#

Per quanto tempo vengono conservati i dati?#

L'API delle metriche supporta finestre selezionabili da 1 ora a 30 giorni. La scheda del deployment mostra le 20 voci di log più recenti; l'API dei log può restituire fino a 200 voci per richiesta e supporta la paginazione.

Posso monitorare più endpoint insieme?#

Sì, la pagina dei deployment mostra tutti gli endpoint con schede di panoramica aggregate. Usa la visualizzazione a tabella per confrontare le prestazioni tra i vari deployment.