Monitoring

Ultralytics bietet Überwachung für bereitgestellte Endpunkte. Verfolgen Sie Anforderungsmetriken, zeigen Sie Protokolle an und überprüfen Sie den Gesundheitsstatus mit automatischer Abfrage.

Bereitstellungs-Dashboard

Die Deploy Die Seite in der Seitenleiste dient als Überwachungs-Dashboard für alle Ihre Bereitstellungen. Sie vereint die Weltkarte, Übersichtsmetriken und das Bereitstellungsmanagement in einer Ansicht. Siehe Dedizierte Endpunkte zum Erstellen und Verwalten von Bereitstellungen.

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

Übersichtskarten

Vier Zusammenfassungskarten oben auf der Seite zeigen:

Weltkarte

Die interaktive Weltkarte zeigt:

• Regionspins für alle 43 verfügbaren Regionen
• Grüne Stecker für eingesetzte Regionen
• Animierte blaue Stecker für Regionen mit aktiven Bereitstellungen
• Die Pin-Größe variiert je nach Bereitstellungsstatus und Latenz.

Bereitstellungsliste

Unterhalb der Übersichtskarten zeigt die Bereitstellungsliste alle Endpunkte in Ihren Projekten an. Verwenden Sie die Umschaltfunktion für den Anzeigemodus, um zwischen folgenden Ansichten zu wechseln:

Metriken pro Bereitstellung

Jede Bereitstellungskarte (in der Kartenansicht) zeigt Echtzeit-Metriken an:

Metrik-Zeile

Die Metriken werden vom Sparkline-API-Endpunkt abgerufen und alle 60 Sekunden aktualisiert.

Zustandsprüfung

Laufende Bereitstellungen zeigen einen Integritätsprüfungsindikator an:

Gesundheitsprüfungen werden alle 20 Sekunden automatisch wiederholt, wenn sie nicht in Ordnung sind. Klicken Sie auf das Symbol „Aktualisieren“, um eine Gesundheitsprüfung manuell auszulösen. Die Gesundheitsprüfung verwendet eine Zeitüberschreitung von 55 Sekunden, um Kaltstarts auf Scale-to-Zero-Endpunkten zu berücksichtigen.

Logs

Jede Einsatzkarte enthält eine Logs Registerkarte zum Anzeigen der letzten Protokolleinträge:

Log-Einträge

Jeder Protokolleintrag zeigt:

Die Benutzeroberfläche zeigt die 20 neuesten Einträge an. Die API zeigt standardmäßig 50 Einträge pro Anfrage an (maximal 200).

Codebeispiele

Jede Einsatzkarte enthält eine Code Registerkarte mit gebrauchsfertigem API-Code mit Ihrer tatsächlichen Endpunkt-URL und Ihrem API-Schlüssel:

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"

Bereitstellungsprognose

Die Predict Die Registerkarte auf jeder Bereitstellungskarte enthält ein Inline-Vorhersagefeld – dieselbe Oberfläche wie das Modell. Predict Registerkarte, aber die Inferenz wird über den Bereitstellungsendpunkt statt über den gemeinsam genutzten Dienst ausgeführt. Dies ist nützlich, um einen bereitgestellten Endpunkt direkt über den Browser zu testen. Siehe Inferenz für Parameterdetails und Antwortformate.

API-Endpunkte

Überwachung – Überblick

GET /api/monitoring

Gibt aggregierte Metriken für alle Bereitstellungen zurück, die dem authentifizierten Benutzer gehören. Arbeitsbereichsbezogen über optional owner Abfrageparameter.

Bereitstellungsmetriken

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

Gibt Sparkline-Daten und zusammenfassende Metriken für eine bestimmte Bereitstellung zurück. Aktualisierungsintervall: 60 Sekunden.

Bereitstellungsprotokolle

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

Gibt die letzten Protokolleinträge mit optionalem Schweregradfilter und Paginierung zurück.

Bereitstellungszustand

GET /api/deployments/{deploymentId}/health

Gibt den Status der Zustandsprüfung mit der Antwortlatenz zurück.

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

Leistungsoptimierung

Nutzen Sie Überwachungsdaten, um Ihre Bereitstellungen zu optimieren:

FAQ

Wie lange werden Daten aufbewahrt?

Kann ich externes Monitoring einrichten?

Ja, Endpunkt-URLs funktionieren mit externen Überwachungstools:

• Uptime-Monitoring (Pingdom, UptimeRobot)
• APM-Tools (Datadog, New Relic)
• Benutzerdefinierte Gesundheitschecks über die /health Endpunkt

Wie genau sind die Latenzwerte?

Latenzmetriken messen:

• P50: Mediane Antwortzeit
• P95: 95. Perzentil
• P99: 99. Perzentil

Diese Werte repräsentieren die serverseitige Verarbeitungszeit, exklusive der Netzwerklatenz zu Ihren Benutzern.

Warum sind meine Metriken verzögert?

Metriken weisen eine Verzögerung von ca. 2 Minuten auf aufgrund von:

• Metrik-Aggregationspipeline
• Aggregationsfenster
• Dashboard-Caching

Für Echtzeit-Debugging prüfen Sie die Protokolle, die nahezu sofort verfügbar sind.

Kann ich mehrere Endpunkte gleichzeitig überwachen?

Ja, auf der Seite „Bereitstellungen“ werden alle Endpunkte mit aggregierten Übersichtskarten angezeigt. Verwenden Sie die Tabellenansicht, um die Leistung verschiedener Bereitstellungen zu vergleichen.

📅 Erstellt vor 1 Monat ✏️ Aktualisiert vor 4 Tagen

Kommentare