Surveillance

Ultralytics assure la surveillance des terminaux déployés. Suivez les métriques des requêtes, consultez les journaux et vérifiez l'état de santé grâce à un sondage automatique.

Tableau de bord des déploiements

L'argument Deploy La page dans la barre latérale sert de tableau de bord de surveillance pour tous vos déploiements. Elle combine la carte du monde, les mesures générales et la gestion des déploiements dans une seule vue. Voir Points de terminaison dédiés pour créer et gérer les déploiements.

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

Cartes d'aperçu

Quatre fiches récapitulatives en haut de la page indiquent :

Carte du monde

La carte interactive du monde montre :

• Épingles régionales pour les 43 régions disponibles
• Épingles vertes pour les régions déployées
• Épingles bleues animées pour les régions où des déploiements actifs sont en cours
• La taille des épingles varie en fonction de l'état de déploiement et de la latence.

Liste des déploiements

Sous les cartes de présentation, la liste des déploiements affiche tous les points de terminaison de vos projets. Utilisez le bouton de mode d'affichage pour basculer entre :

Indicateurs par déploiement

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

Ligne de mesures

Les métriques sont récupérées à partir du point de terminaison de l'API Sparkline et actualisées toutes les 60 secondes.

Vérification de l'état

Les déploiements en cours affichent un indicateur de vérification de l'état :

Les contrôles d'intégrité sont automatiquement réessayés toutes les 20 secondes lorsqu'ils ne sont pas satisfaisants. Cliquez sur l'icône d'actualisation pour déclencher manuellement un contrôle d'intégrité. Le contrôle d'intégrité utilise un délai d'expiration de 55 secondes pour tenir compte des démarrages à froid sur les points de terminaison à échelle zéro.

Journaux

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

Entrées de journal

Chaque entrée de journal affiche :

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

Exemples de code

Chaque carte de déploiement comprend un Code onglet affichant le code API prêt à l'emploi avec votre URL de point de terminaison et votre clé API réelles :

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"

Prévision du déploiement

L'argument Predict L'onglet de chaque carte de déploiement fournit un panneau de prédiction en ligne, identique à l'interface du modèle. Predict onglet, mais en exécutant l'inférence via le point de terminaison de déploiement plutôt que via le service partagé. Cela est utile pour tester un point de terminaison déployé directement à partir du navigateur. Voir Inférence pour plus de détails sur les paramètres et les formats de réponse.

Points de terminaison API

Aperçu de la surveillance

GET /api/monitoring

Renvoie les métriques agrégées pour tous les déploiements appartenant à l'utilisateur authentifié. Compatible avec l'espace de travail via l'option owner paramètre de requête.

Indicateurs de déploiement

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

Renvoie les données des graphiques sparkline et les mesures récapitulatives pour un déploiement spécifique. Intervalle d'actualisation : 60 secondes.

Journaux de déploiement

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

Renvoie les entrées récentes du journal avec un filtre de gravité et une pagination facultatifs.

Santé du déploiement

GET /api/deployments/{deploymentId}/health

Renvoie l'état du contrôle de santé avec la latence de réponse.

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

Optimisation des performances

Utilisez les données de surveillance pour optimiser vos déploiements :

FAQ

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

Puis-je configurer une surveillance externe ?

Oui, les URL des points de terminaison fonctionnent avec des outils de surveillance externes :

• Surveillance de la disponibilité (Pingdom, UptimeRobot)
• Outils APM (Datadog, New Relic)
• Contrôles de santé personnalisés via le /health point final

Quelle est la précision des chiffres de latence ?

Les métriques de latence mesurent :

• P50 : Temps de réponse médian
• P95 : 95e centile
• P99 : 99e centile

Celles-ci représentent le temps de traitement côté serveur, sans inclure la latence réseau vers vos utilisateurs.

Pourquoi mes métriques sont-elles retardées ?

Les métriques présentent un délai d'environ 2 minutes en raison de :

• Pipeline d'agrégation des métriques
• Fenêtres d'agrégation
• Mise en cache du tableau de bord

Pour le débogage en temps réel, consultez les journaux qui sont quasi instantanés.

Puis-je surveiller plusieurs points de terminaison simultanément ?

Oui, la page Déploiements affiche tous les points de terminaison avec des cartes récapitulatives agrégées. Utilisez la vue tableau pour comparer les performances entre les déploiements.

📅 Créé il y a 1 mois ✏️ Mis à jour il y a 4 jours

Commentaires