İzleme#

Ultralytics Platform, dağıtılmış uç noktalar için izleme özelliği sağlar. Uç nokta isteklerini, gecikmeyi, hataları ve günlükleri takip et. Ücretli ayrılmış uç noktalar ayrıca canlı tahmin istatistikleri ve inceleyip veri kümelerine kaydedebileceğin geçici örnekler sunar.

Dağıtımlar Panosu#

Kenar çubuğundaki Deploy sayfası, tüm dağıtımların için izleme panosu olarak kullanılır. Dünya haritasını, genel bakış ölçümlerini ve dağıtım yönetimini tek görünümde birleştirir. Dağıtım oluşturma ve yönetme hakkında bilgi için Özel Uç Noktalar sayfasına bak.

graph TB
    subgraph Dashboard
        Map[World Map]:::proc --- Cards[Overview Cards]:::proc
        Cards --- List[Deployments List]:::decide
    end
    subgraph "Per Ready Deployment"
        Monitoring[Monitoring Tab: Paid Endpoints]:::out
        Metrics[Metrics Row]:::out
        Health[Health Check]:::out
        Logs[Logs Tab]:::out
        Code[Code Tab]:::out
        Predict[Predict Tab]:::out
    end
    List --> Monitoring
    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:

Gerçek çıkarım gecikmesi görünümünü başka türlü domine edeceğinden, sağlık kontrolleri birkaç milisaniyede tamamlandığı için medyan gecikme yerine P95 gecikme 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 iğneler
• Devam eden etkin dağıtımlara sahip 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 şu görünümler arasında geçiş yap:

Dağıtım Başına Ölçümler#

Her dağıtım kartı (kartlar görünümünde) gerçek zamanlı ölçümleri gösterir. Aşağıda açıklanan ölçüm satırı, sağlık kontrolü ve Logs, Code ile Predict sekmeleri yalnızca dağıtım Hazır durumundayken görünür:

Ölçüm Satırı#

Ölçümler otomatik olarak yenilenir. Henüz istek sunmamış uç noktalar "Henüz trafik yok" ifadesini gösterir ve ölçümler yalnızca Hazır durumundaki dağıtımlar için toplanır. Dağıtımlar panosunda ölçümler en son 20 dağıtım için alınır.

Sağlık Kontrolü#

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

Sağlık kontrolleri sağlıksız durumdayken otomatik olarak yeniden denenir ve uç nokta yanıt verdiğinde durur. Sağlık kontrolünü manuel olarak başlatmak için yenileme simgesine tıkla; bu işlem, trafik göndermeden önce sıfıra ölçeklenmiş bir uç noktayı ısıtmanın da bir yoludur.

İzleme Sekmesi#

Deploy öğesini aç, Cards görünümüne geç ve Ready durumundaki ücretli, ayrılmış bir uç noktada Monitoring seçeneğini seç. Geçici Örnekler ile Tahmin İstatistikleri öğelerini doldurmak için Predict sekmesi veya uç nokta API'si üzerinden bir görsel gönder. İşlenen ilk görselden önce sekme İşlenen görsel yok mesajını gösterir.

Geçici Örnekler#

Galeri, tahmin kaplamalarına sahip işlenen görsellerin dönen bir örneğini içerir. Tam ekran görüntüleyicide tahminleri incelemek için bir görsel aç ve kaplamaları ayarlamak için görünürlük kontrollerini kullan. Galeri başlangıçta en fazla 12 örnek gösterir; Tümünü göster bu galeriyi genişletir.

• Örnekleme: Başlangıçta en fazla iki örnek, ardından dakikada en fazla bir ek görsel. Yakalama en iyi çaba esasına dayanır; çıkarım, örnek kodlamasını beklemez.
• Kapasite: Sıkıştırılmış görseller, tahmin meta verileri ve ilgili varlıklar için paylaşılan 100 MiB bellek bütçesi içinde en fazla 100 görsel. Arayüz bu bütçeyi 100 MB olarak etiketler.
• Değiştirme: Sınırların herhangi birine ulaşıldığında eski örnekler değiştirilir. Sen görüntülerken bir örnek kullanılamaz hale gelebilir.
• Depolama: Geçici örnekler uç nokta belleğinde kalır. Bunları bir veri kümesine kaydetmek, normal çalışma alanı depolama ve işleme sınırlarını kullanır.

Örnekleri Bir Veri Kümesine Kaydet#

İçerik düzenleme iznine sahip çalışma alanı üyeleri, örnekleri uç noktanın çalışma alanındaki bir veri kümesine kaydedebilir:

1. Onay kutularını kullanarak ayrı örnekleri seç veya Tümünü seç seçeneğine tıkla.
2. Veri kümesine kaydet seçeneğine tıkla.
3. Dağıtılan modelle aynı göreve sahip mevcut bir veri kümesini seç. Bağlı kaynak veri kümeleri hariç tutulmuştur; uygun veri kümesi yoksa önce uyumlu bir veri kümesi oluştur.
4. Seçilen görsel sayısını gösteren Kaydet düğmesine tıkla, ardından işlemeyi takip etmek için veri kümesini aç.

Seçilen görseller ve tahminler, standart veri kümesi yükleme ve veri alma iş akışı aracılığıyla kopyalanır. Normal kota, sınıf eşleme ve yinelenen işleme kuralları geçerlidir. Kaydetme işlemi, geçici örnekleri galeride bırakır; başarıyla içe aktarılan veri kümesi görselleri uç nokta yeniden başlatmalarından ve silinmelerinden sağ kurtulur. Eğitim için kullanmadan önce tahmin edilen etiketleri incele.

Geçici örnekleri kaldırmak için bir görselin üzerine gelindiğinde çıkan çöp kutusu kontrolünü kullan veya örnekleri seçip toplu çöp kutusu düğmesine tıkladıktan sonra Delete öğesini onayla. Örnekleri silmek, toplu tahmin istatistiklerini ve veri kümelerine çoktan kaydedilmiş görselleri değiştirilmemiş olarak bırakır.

Tahmin İstatistikleri#

İstatistikler, galeri örneklemesinden bağımsız olarak işlenen görselleri toplar. Bir örneği silmek veya değiştirmek, o örneğin katkısını azaltmaz. Özet, seçilen dönem için görselleri, tahminleri ve tahmini olmayan görselleri gösterir; derinlik modelleri görsel sayılarını gösterir.

Tarih seçici varsayılan olarak son 30 days değerini kullanır ve 365 days değerine kadar olan aralıkları kabul eder. Seçilen tarihler UTC sınırlarını kullanır; grafik zaman damgaları yerel saat diliminde görüntülenir. Tam aralık son 72 saat içinde kalırsa en fazla üç günlük son aralıklar saatlik geçmişi kullanır; diğer aralıklar günlük geçmişi kullanır. Tarih aralığı istatistikleri filtrelerken, galeri mevcut geçici örnekleri göstermeye devam eder.

Geçmiş, 72 hourly buckets ve 365 daily buckets ile sınırlandırılmıştır ve yalnızca mevcut örnek başladığından beri kullanılabilir. İşlenen görseli olmayan seçilen bir dönem No images processed in this period mesajını gösterir.

Kullanılabilir grafikler göreve ve toplanan tahminlere bağlıdır:

İzleme paneli açık ve görünür durumdayken yaklaşık her 2 seconds saniyede bir yenilenir. Panel ekran dışındayken veya tarayıcı sekmesi gizliyken yoklama duraklatılır. Dağıtımın Predict sekmesi üzerinden başarılı çıkarım aynı zamanda bir istatistik yenilenmesini tetikler.

Günlükler#

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

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, istek başına varsayılan olarak 50 girdi (en fazla 200) döndürür ve daha eski girdilere geçiş için bir nextPageToken döndürür.

Kod Örnekleri#

Her dağıtım kartında, uç nokta URL'si doldurulmuş, kullanıma hazır API kodunu gösteren bir Code sekmesi bulunur. Çalışma alanı sahipleri için dağıtıma bağlı API anahtarı eklenir; böylece anahtarı kopyalayıp çalıştırabilirsin. Sahip olmayan kullanıcılar 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 Predict'i#

Her dağıtım kartındaki Predict sekmesi, satır içi bir tahmin paneli sağlar — modelin Predict sekmesindeki arayüzün aynısıdır, ancak çıkarımı paylaşılan hizmet yerine dağıtım uç noktası üzerinden çalıştırır. Bu, dağıtılan bir uç noktayı doğrudan tarayıcıdan test etmek için kullanışlıdır. Parametre ayrıntıları ve yanıt biçimleri için Çıkarım sayfasına bak.

API Uç Noktaları#

Her dağıtım, sahibi ve dağıtım adıyla adreslenir ve her rota bir API anahtarı gerektirir. Kimlik doğrulama ayrıntıları için API referansına bak.

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 tüm metrik yükünü döndürür: toplam istek sayısını, hata sayısını ve oranını, 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ığı kısa biçimdedir — 24 saatlik istek sayısının yanı sıra toplam istek sayısı, hata oranı ve ortalama gecikme. Bu çağrı her 60 saniyede bir yenilenir.

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 en son günlük girişlerini döndürür.

Dağıtım Durumu#

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

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

Dağıma ping gönderir ve ölçülen gidiş-dönüş gecikmesiyle birlikte durumunu döndürür:

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

Uç noktaya hiç ulaşılamadığında sağlıksız yanıt status alanını içermez ve bir error mesajı ekler.

Performans Optimizasyonu#

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

SSS#