İzleme#

Ultralytics Platform, dağıtılmış uç noktalar için izleme sağlar. Otomatik yoklama ile istek metriklerini takip et, günlükleri görüntüle ve sağlık durumunu kontrol et.

Dağıtımlar Panosu#

Kenar çubuğundaki Deploy sayfası, tüm dağıtımların için izleme paneli görevi görür. Dünya haritasını, genel bakış metriklerini ve dağıtım yönetimini tek bir görünümde birleştirir. Dağıtımlar oluşturmak ve yönetmek için Dedicated Endpoints bölümüne göz at.

graph TB
    subgraph Dashboard
        Map[World Map]:::proc --- Cards[Overview Cards]:::proc
        Cards --- List[Deployments List]:::decide
    end
    subgraph "Per Ready 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

Genel Bakış Kartları#

Sayfanın üst kısmındaki dört özet kartı şunları gösterir:

Sağlık kontrolleri birkaç milisaniyede yanıt döndürdüğü ve aksi takdirde gerçek çıkarım gecikmesi tablosuna hakim olacağı için ortanca yerine P95 raporlanır.

Dünya Haritası#

Etkileşimli dünya haritası şunları gösterir:

• Mevcut 42 bölgenin tamamı için bölge iğneleri
• Hazır bir dağıtıma sahip bölgeler için Yeşil raptiyeler
• Aktif dağıtımı devam eden bölgeler için Hareketli mavi iğneler
• İğne boyutu, dağıtım durumuna ve gecikmeye göre değişir

New Deployment iletişim kutusunu açmak için herhangi bir bölgeye tıkla. Harita küçük ekranlarda gizlenir.

Dağıtımlar Listesi#

Genel bakış kartlarının altında, dağıtımlar listesi projelerindeki tüm uç noktaları gösterir. Görünüm modu düğmesini kullanarak şunlar arasında geçiş yapabilirsin:

Dağıtım Başına Metrikler#

Her dağıtım kartı (kart görünümünde) gerçek zamanlı metrikleri gösterir. Metrik satırı, sistem sağlığı kontrolü ve aşağıda açıklanan Logs, Code ve Predict sekmeleri yalnızca dağıtım Ready durumundayken görünür:

Metrikler Satırı#

Metrikler otomatik olarak yenilenir. İstek sunmamış olan uç noktalar "No traffic yet" gösterir ve metrikler yalnızca Ready durumundaki dağıtımlar için toplanır. Dağıtımlar kontrol panelinde, en son 20 dağıtım için metrikler getirilir.

Sağlık Kontrolü#

Çalışan dağıtımlar bir sağlık kontrolü göstergesi sunar:

Sağlık kontrolleri, sağlıksız durumdayken otomatik olarak yeniden deneme yapar ve uç nokta yanıt verdiğinde durur. Trafik göndermeden önce sıfıra ölçeklenmiş bir uç noktayı ısıtmanın bir yolu olarak da işlev gören bir sağlık kontrolünü manuel olarak tetiklemek için yenile simgesine tıkla.

Günlükler#

Her dağıtım kartı, son günlük girdilerini görüntülemek için bir Logs sekmesi içerir:

Günlük Girdileri#

Her günlük girdisi şunları gösterir:

Kullanıcı arayüzü en son 20 girdiyi gösterir ve boş olanları gizler. API varsayılan olarak istek başına 50 girdi (en fazla 200) sunar ve daha geriye sayfalamak için bir nextPageToken döndürür.

Kod Örnekleri#

Her dağıtım kartı, uç nokta URL'si doldurulmuş kullanıma hazır API kodunu gösteren bir Code sekmesi içerir. Çalışma alanı sahipleri için dağıtımın bağlı API anahtarı eklenir, kopyalanmaya ve çalıştırılmaya hazırdır. Sahip olmayanlar bir YOUR_API_KEY yer tutucusu görür:

import requests

# Deployment endpoint
url = "https://YOUR_DEPLOYMENT_URL.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())

Dağıtım Tahmini#

Her dağıtım kartındaki Predict sekmesi, modelin Predict sekmesiyle aynı arayüze sahip ancak paylaşılan hizmet yerine dağıtım uç noktası üzerinden çıkarım çalıştıran satır içi bir tahmin paneli sağlar. Bu, dağıtılmış bir uç noktayı doğrudan tarayıcıdan test etmek için yararlıdır. Parametre detayları ve yanıt formatları için Inference sayfasına bak.

API Uç Noktaları#

Her dağıtım sahibi ve dağıtım adı ile adreslenir ve her rota bir API anahtarı gerektirir. Kimlik doğrulama ayrıntıları için API reference sayfasına göz at.

Dağıtım Metrikleri#

GET /api/deployments/{owner}/{deployment}/metrics?range=24h

Python SDK: client.deployments.metrics(owner, deployment, range="24h")

Bir dağıtım için tam metrik yükünü döndürür: toplam istek, hata sayısı ve oranı ile ortalama, P50, P95 ve P99 gecikmesini içeren bir summary bloğunun yanı sıra istekler, hatalar, P50 ve P95 gecikmesi, CPU ve bellek kullanımı ve örnek sayısı için timeSeries dizileri.

sparkline=true ile yanıt, dağıtım kartlarının kullandığı kompakt biçimdir — 24 saatlik istek sayısı artı toplam istekler, hata oranı ve ortalama gecikme. Bu, her 60 saniyede bir yenilenen çağrıdır.

Dağıtım Günlükleri#

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

Python SDK: client.deployments.logs(owner, deployment, limit=50, severity="ERROR,WARNING")

İsteğe bağlı önem derecesi filtresi ve sayfalama ile son günlük girişlerini döndürür.

Dağıtım Sağlığı#

GET /api/deployments/{owner}/{deployment}/health

Python SDK: client.deployments.health(owner, deployment)

Dağıtımı ping'ler ve ölçülen gidiş-dönüş gecikmesiyle birlikte sağlık durumunu döndürür:

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

Sağlıksız bir yanıt, uç noktaya hiç ulaşılamadığında status öğesini çıkarır ve bir error mesajı ekler.

Performans Optimizasyonu#

Dağıtımlarını optimize etmek için izleme verilerini kullan:

SSS#