İzleme

Ultralytics Platform, dağıtılan 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.

Ultralytics Platform Deploy Sayfası Genel Bakış Kartları ve Dünya Haritası

Dağıtımlar Panosu

Kenar çubuğundaki Deploy sayfası, tüm dağıtımların için izleme panosu 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 bak.

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

Genel Bakış Kartları

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

Ultralytics Platform Deploy Sayfası Dört Genel Bakış Kartı

MetrikAçıklama
Toplam İstek (24s)Tüm uç noktalardaki istekler
Aktif DağıtımlarŞu anda çalışan uç noktalar
Hata Oranı (24s)Başarısız isteklerin yüzdesi
P95 Gecikme (24s)yüzdelik dilim yanıt süresi
Hata Oranı Uyarısı

Hata oranı %5'i aştığında hata oranı kartı kırmızı renkle vurgulanır. Hataları teşhis etmek için bireysel dağıtımlardaki Logs sekmesini kontrol et.

Dünya Haritası

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

  • Mevcut 43 bölgenin tamamı için Bölge iğneleri
  • Dağıtılmış bölgeler için Yeşil iğneler
  • Devam eden aktif dağıtımlara sahip bölgeler için Animasyonlu mavi iğneler
  • İğne boyutu, dağıtım durumuna ve gecikmeye bağlı olarak değişir

Ultralytics Platform Deploy Sayfası Dağıtılmış Bölgeleri Gösteren Dünya Haritası

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 geçişini kullanarak şunlar arasında geçiş yapabilirsin:

GörünümAçıklama
KartlarMetrikler, günlükler, kod ve tahmin sekmeleri içeren tam detaylı kartlar
SıkıştırılmışTemel metrikleri içeren daha küçük kartlardan oluşan ızgara (1-4 sütun)
TabloSıralanabilir sütunlara sahip DataTable: Ad, Bölge, Durum, İstekler, P95, Hatalar
Gerçek Zamanlı Güncellemeler

Pano, dağıtım durumu güncellemeleri için her 15 saniyede bir yoklama yapar. Dağıtımlar geçiş durumundayken (creating, deploying veya stopping), yoklama her 3 saniyeye çıkar. Metrik grafikleri her 60 saniyede bir yenilenir. Anlık güncellemeler için yenileme düğmesine tıkla.

Dağıtım Bazlı Metrikler

Her dağıtım kartı (kart görünümünde) gerçek zamanlı metrikleri gösterir:

Metrik Satırı

MetrikAçıklama
İsteklerSimge ile istek sayısı (24s)
P95 Gecikmeyüzdelik dilim yanıt süresi
Hata OranıBaşarısız isteklerin yüzdesi

Metrikler, sparkline API uç noktasından getirilir ve her 60 saniyede bir yenilenir.

Sağlık Kontrolü

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

GöstergeAnlamı
Yeşil kalpSağlıklı — yanıt gecikmesini gösterir
Kırmızı kalpSağlıksız — hata mesajını gösterir
Dönen simgeSağlık kontrolü devam ediyor

Sağlık kontrolleri, sağlıksız durumlarda her 20 saniyede bir otomatik olarak yeniden denenir. Manuel olarak bir sağlık kontrolü tetiklemek için yenileme simgesine tıkla. Sağlık kontrolü, sıfıra ölçeklenen uç noktalardaki soğuk başlatmaları hesaba katmak için 55 saniyelik bir zaman aşımı kullanır.

Ultralytics Platform Dağıtım Kartı Sağlık Kontrolü Gecikme ile Sağlıklı

Soğuk Başlatma Toleransı

Sağlık kontrolü, sıfıra ölçeklenen uç noktalardaki soğuk başlatmaları (en kötü durumda yaklaşık 45 saniyeye kadar) hesaba katmak için 55 saniyelik bir zaman aşımı kullanır. Uç nokta ısındıktan sonra, sağlık kontrolleri milisaniyeler içinde tamamlanır.

Günlükler

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

Ultralytics Platform Dağıtım Kartı Önem Derecesi Filtreli Günlükler Sekmesi

Günlük Girişleri

Her günlük girişi şunları gösterir:

AlanAçıklama
Önem DerecesiRenk kodlu çubuk (aşağıya bak)
Zaman Damgasıİstek zamanı (yerel format)
MesajGünlük içeriği
HTTP bilgisiDurum kodu ve gecikme (varsa)

Filtre düğmelerini kullanarak günlükleri önem derecesine göre filtrele:

SeviyeRenkAçıklama
DEBUGGriHata ayıklama mesajları
INFOMaviNormal istekler
WARNINGSarıKritik olmayan sorunlar
ERRORKırmızıBaşarısız istekler
CRITICALKoyu KırmızıKritik hatalar

Arayüz en son 20 girişi gösterir. API varsayılan olarak istek başına 50 giriş (maksimum 200) sunar.

Hata Ayıklama İş Akışı

Hataları araştırırken: önce ERROR ve WARNING girişlerine filtrelemek için Errors düğmesine tıkla, ardından zaman damgalarını ve HTTP durum kodlarını incele. Ekibinle paylaşmak için günlükleri panoya kopyala.

Kod Örnekleri

Her dağıtım kartı, gerçek uç nokta URL'in ve API anahtarınla kullanıma hazır API kodunu gösteren bir Code sekmesi içerir:

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())
Otomatik Doldurulan Kimlik Bilgileri

Platform üzerinde Code sekmesini görüntülerken, gerçek uç nokta URL'n ve API anahtarın otomatik olarak doldurulur. Kodu kopyala ve doğrudan çalıştır. Bir anahtar oluşturmak için API Keys bölümüne bak.

Dağıtım Tahmini

Her dağıtım kartındaki Predict sekmesi, satır içi bir tahmin paneli sağlar; bu, modelin Predict sekmesiyle aynı arayüzdür ancak çıkarımı paylaşılan servis yerine dağıtım uç noktası üzerinden çalıştırır. Bu, dağıtılmış bir uç noktayı doğrudan tarayıcıdan test etmek için kullanışlıdır. Parametre detayları ve yanıt formatları için Inference bölümüne bak.

API Uç Noktaları

İzlemeye Genel Bakış

GET /api/monitoring

Kimliği doğrulanmış kullanıcıya ait tüm dağıtımlar için toplanmış metrikleri döndürür. İsteğe bağlı owner sorgu parametresi ile çalışma alanı farkındalığına sahiptir.

Dağıtım Metrikleri

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

Belirli bir dağıtım için sparkline verilerini ve özet metrikleri döndürür. Yenileme aralığı: 60 saniye.

ParametreTürAçıklama
sparklineboolSparkline verilerini dahil et
rangedizeZaman aralığı: 1h, 6h, 24h, 7d veya 30d

Dağıtım Günlükleri

GET /api/deployments/{deploymentId}/logs?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.

ParametreTürAçıklama
limitintDöndürülecek maksimum giriş sayısı (varsayılan: 50, maksimum: 200)
severitydizeVirgülle ayrılmış önem derecesi filtresi
pageTokendizeÖnceki yanıttan gelen sayfalama belirteci

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

GET /api/deployments/{deploymentId}/health

Yanıt gecikmesi ile sağlık kontrolü durumunu döndürür.

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

Performans Optimizasyonu

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

Gecikme çok yüksekse:

  1. Örnek sayısını kontrol et (daha fazlasına ihtiyaç olabilir)
  2. Model boyutunun uygun olduğunu doğrula
  3. Daha yakın bir bölge kullanmayı düşün
  4. Gönderilen görüntü boyutlarını kontrol et
Gecikmeyi Azaltma

Çoğu kullanım durumu için minimum doğruluk kaybıyla ~4 kat hız artışı sağlamak adına imgsz=1280 yerine imgsz=640 kullan. Daha düşük ağ gecikmesi için kullanıcılarına daha yakın bir bölgeye dağıtım yap.

SSS

Veriler ne kadar süre saklanır?

Veri TipiSaklama
Metrikler30 gün
Günlükler7 gün

Harici izleme ayarlayabilir miyim?

Evet, uç nokta URL'leri harici izleme araçlarıyla çalışır:

  • Çalışma süresi (uptime) izleme (Pingdom, UptimeRobot)
  • APM araçları (Datadog, New Relic)
  • /health uç noktası aracılığıyla özel sağlık kontrolleri

Gecikme değerleri ne kadar doğru?

Gecikme metrikleri şunları ölçer:

  • P50: Medyan yanıt süresi
  • P95: 95. yüzdelik dilim
  • P99: 99. yüzdelik dilim

Bunlar, kullanıcılarına olan ağ gecikmesi hariç, sunucu tarafındaki işleme süresini temsil eder.

Metriklerim neden gecikmeli?

Metrikler yaklaşık ~2 dakikalık bir gecikmeye sahiptir, bunun nedeni:

  • Metrik toplama hattı
  • Toplama pencereleri
  • Panel önbelleğe alma

Gerçek zamanlı hata ayıklama için, neredeyse anlık olan günlükleri kontrol et.

Birden fazla uç noktayı birlikte izleyebilir miyim?

Evet, dağıtımlar sayfası, toplanmış özet kartlarıyla tüm uç noktaları gösterir. Dağıtımlar arasındaki performansı karşılaştırmak için tablo görünümünü kullan.

Yorumlar