Surveillance#

Ultralytics Platform fournit une surveillance pour les points de terminaison déployés. Suis les métriques de tes requêtes, consulte tes logs et vérifie l'état de santé grâce au polling automatique.

Tableau de bord des déploiements#

La page Deploy dans la barre latérale sert de tableau de bord de surveillance pour tous tes déploiements. Elle combine la carte du monde, les métriques globales et la gestion des déploiements en une seule vue. Consulte Dedicated Endpoints pour créer et gérer tes déploiements.

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

Cartes de synthèse#

Quatre cartes de synthèse en haut de la page affichent :

Carte du monde#

La carte du monde interactive montre :

• Épingles de région pour les 42 régions disponibles
• Épingles vertes pour les régions déployées
• Épingles bleues animées pour les régions avec des déploiements actifs en cours
• La taille des épingles varie en fonction de l'état du déploiement et de la latence

Liste des déploiements#

Sous les cartes de synthèse, la liste des déploiements montre tous les endpoints de tes projets. Utilise le sélecteur de mode de vue pour basculer entre :

Métriques par déploiement#

Chaque carte de déploiement (en vue cartes) affiche des métriques en temps réel :

Ligne de métriques#

Les métriques sont récupérées depuis l'API sparkline et se rafraîchissent toutes les 60 secondes.

Vérification de santé#

Les déploiements en cours d'exécution affichent un indicateur de santé :

Les vérifications de santé réessaient automatiquement toutes les 20 secondes si l'état est non sain. Clique sur l'icône de rafraîchissement pour déclencher manuellement une vérification. La vérification utilise un délai d'attente de 55 secondes pour accommoder les démarrages à froid sur les endpoints à échelle zéro.

Journaux#

Chaque carte de déploiement comprend un onglet Logs pour visualiser les entrées récentes :

Entrées de journal#

Chaque entrée de journal montre :

L'interface affiche les 20 entrées les plus récentes. L'API utilise par défaut 50 entrées par requête (max 200).

Exemples de code#

Chaque carte de déploiement comprend un onglet Code montrant du code API prêt à l'emploi avec ton URL d'endpoint réelle et ta clé 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())

Inférence de déploiement#

L'onglet Predict sur chaque carte de déploiement fournit un panneau de prédiction intégré — la même interface que l'onglet Predict du modèle, mais qui exécute l'inférence via le point de terminaison de déploiement au lieu du service partagé. C'est utile pour tester un point de terminaison déployé directement depuis le navigateur. Consulte Inference pour les détails des paramètres et les formats de réponse.

Points de terminaison API#

Aperçu de la surveillance#

GET /api/monitoring

Renvoie des métriques agrégées pour tous les déploiements possédés par l'utilisateur authentifié. Sensible à l'espace de travail via le paramètre de requête optionnel owner.

Métriques de déploiement#

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

Renvoie les données de sparkline et les métriques de résumé pour un déploiement spécifique. Intervalle de rafraîchissement : 60 secondes.

Journaux de déploiement#

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

Renvoie les entrées de journal récentes avec un filtre de sévérité optionnel et une pagination.

Santé du déploiement#

GET /api/deployments/{deploymentId}/health

Renvoie l'état de santé avec la latence de réponse.

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

Optimisation des performances#

Utilise les données de surveillance pour optimiser tes déploiements :

FAQ#

Combien de temps les données sont-elles conservées ?#

L'API des métriques prend en charge des fenêtres sélectionnables allant de 1 heure à 30 jours. La carte de déploiement affiche les 20 entrées de journal les plus récentes ; l'API des journaux peut renvoyer jusqu'à 200 entrées par requête et prend en charge la pagination.

Puis-je surveiller plusieurs points de terminaison ensemble ?#

Oui, la page de déploiements affiche tous les points de terminaison avec des cartes d'aperçu agrégées. Utilise la vue tableau pour comparer les performances entre les déploiements.