İçeriğe geç

İzleme

Ultralytics Platform, dağıtılmış uç noktalar için izleme sağlar. İstek metriklerini track edin, günlükleri görüntüleyin ve otomatik yoklama ile sağlık durumunu kontrol edin.

Ultralytics Platformu Dağıtım Sayfası Genel Bakış Kartları ve Dünya Haritası

Dağıtım Paneli

Deploy yan çubukta yer alan sayfa, tüm dağıtımlarınız 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. Bkz. Özel Uç Noktalar dağıtımları oluşturmak ve yönetmek için.

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 Platformu Dağıtım Sayfası Dört Genel Bakış Kartı

MetrikAçıklama
Toplam İstekler (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)95. yüzdelik dilim yanıt süresi

Hata Oranı Uyarısı

Hata oranı kartı, oran %5'i aştığında kırmızı renkte vurgulanır. Hataları teşhis etmek için Logs bireysel dağıtımlardaki sekmeyi kontrol edin.

Dünya Haritası

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

  • Bölge işaretçileri tüm 43 mevcut bölge için
  • Yeşil işaretçiler dağıtılmış bölgeler için
  • Hareketli mavi işaretçiler devam eden aktif dağıtımlara sahip bölgeler için
  • İşaretçi boyutu dağıtım durumuna ve gecikmeye göre değişir

Ultralytics Platformu Dağıtım Sayfası Dağıtılmış Bölgelerle Dünya Haritası

Dağıtım Listesi

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

GörünümAçıklama
KartlarMetrikler, günlükler, kod ve tahmin sekmeleri içeren tam detay kartları
KompaktAnahtar metriklerle daha küçük kartlardan oluşan ızgara (1-4 sütun)
TabloSıralanabilir sütunlara sahip Veri Tablosu: Ad, Bölge, Durum, İstekler, P95, Hatalar

Gerçek Zamanlı Güncellemeler

Kontrol paneli, metrik güncellemeleri için her 30 saniyede bir yoklama yapar. Dağıtımlar geçiş durumundayken (oluşturuluyor, dağıtılıyor), yoklama sıklığı her 3 saniyeye çıkar. Anında güncellemeler için yenile düğmesine tıklayın.

Dağıtım Başına Metrikler

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

Metrikler Satırı

MetrikAçıklama
İsteklerİstek sayısı (24s) simgeyle
P95 Gecikmesi95. yüzdelik dilim yanıt süresi
Hata OranıBaşarısız isteklerin yüzdesi

Metrikler sparkline API uç noktasından alınır ve her 60 saniyede bir yenilenir.

Sağlık Kontrolü

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

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 olduğunda her 20 saniyede bir otomatik olarak yeniden dener. Sağlık kontrolünü manuel olarak tetiklemek için yenile simgesine tıklayın. Sağlık kontrolü, sıfıra ölçeklenebilen uç noktalardaki soğuk başlatmaları karşılamak için 55 saniyelik bir zaman aşımı kullanır.

Ultralytics Platformu Dağıtım Kartı Sağlık Kontrolü Gecikmeyle Sağlıklı

Soğuk Başlangıç Toleransı

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

Günlükler

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

Ultralytics Platformu Dağıtım Kartı Günlükler Sekmesi Ciddiyet Filtresiyle

Günlük Kayıtları

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

AlanAçıklama
Önem derecesiRenk kodlu çubuk (aşağıya bakınız)
Zaman damgasıİstek zamanı (yerel biçim)
MesajGünlük içeriği
HTTP bilgisiDurum kodu ve gecikme (uygulanabilirse)

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

SeviyeRenkAçıklama
DEBUGGriHata ayıklama mesajları
INFOMaviNormal istekler
WARNINGSarıKritik olmayan sorunlar
HATAKırmızıBaşarısız istekler
CRITICALKoyu KırmızıKritik hatalar
KontrolAçıklama
HatalarHATA ve UYARI girdilerine göre filtrele
TümTüm günlük girdilerini göster
KopyalaGörünür tüm günlükleri panoya kopyala
YenileGünlük girdilerini yeniden yükle

Kullanıcı arayüzü en son 20 girişi gösterir. API, istek başına varsayılan olarak 50 giriş (maksimum 200) döndürür.

Hata Ayıklama İş Akışı

Hataları incelerken: önce HATA ve UYARI girdilerine göre filtrelemek için Hatalar'a tıklayın, ardından zaman damgalarını ve HTTP durum kodlarını gözden geçirin. Ekibinizle paylaşmak için günlükleri panoya kopyalayın.

Kod Örnekleri

Her dağıtım kartı bir Code gerçek uç nokta URL'niz ve API anahtarınızla kullanıma hazır API kodunu gösteren sekme:

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"

Otomatik Doldurulan Kimlik Bilgileri

görüntülerken Code platformdaki sekmesinde, gerçek uç nokta URL'niz ve API anahtarınız otomatik olarak doldurulur. Kodu kopyalayın ve doğrudan çalıştırın. Bkz. API Anahtarları bir anahtar oluşturmak için.

Dağıtım Tahmini

Predict her dağıtım kartındaki sekme, modelin arayüzüyle aynı olan satır içi bir tahmin paneli sağlar. Predict sekmesinde, ancak çıkarımı paylaşılan hizmet yerine dağıtım uç noktası aracılığıyla çalıştırarak. Bu, dağıtılmış bir uç noktayı doğrudan tarayıcıdan test etmek için kullanışlıdır. Bkz. Çıkarım parametre detayları ve yanıt formatları için.

API Uç Noktaları

İzlemeye Genel Bakış

GET /api/monitoring

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

Dağıtım Metrikleri

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

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

ParametreTürAçıklama
sparklineboolSparkline verilerini dahil et
rangestringZaman 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 girdilerini döndürür.

ParametreTürAçıklama
limitintDöndürülecek maksimum giriş sayısı (varsayılan: 50, maksimum: 200)
severitystringVirgülle ayrılmış önem derecesi filtresi
pageTokenstringÖnceki yanıttan 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ızı optimize etmek için izleme verilerini kullanın:

Gecikme süresi çok yüksekse:

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

Gecikmeyi Azaltma

şuradan geçiş yapın imgsz=1280 için imgsz=640 çoğu kullanım durumu için minimum doğruluk kaybıyla yaklaşık 4 kat hızlanma için. Daha düşük ağ gecikmesi için kullanıcılarınıza daha yakın bir bölgeye dağıtım yapın.

Hatalar oluşuyorsa:

  1. hata günlüklerini gözden geçirin Logs sekmesi
  2. İstek formatını kontrol edin (multipart form gerekli)
  3. API anahtarının geçerli olduğunu doğrulayın
  4. Oran sınırlarını kontrol edin

Kapasiteye ulaşılırsa:

  1. Birden fazla bölgeyi değerlendirin
  2. İstek gruplamayı optimize edin
  3. CPU ve bellek kaynaklarını artırın

SSS

Veriler ne kadar süreyle saklanır?

Veri TürüSaklama
Metrikler30 gün
Günlükler7 gün

Harici izleme kurabilir miyim?

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

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

Gecikme süreleri ne kadar doğru?

Gecikme metrikleri şunları ölçer:

  • P50: Medyan yanıt süresi
  • P95: 95. persentil
  • P99: 99. persentil

Bunlar, kullanıcılarınıza olan ağ gecikmesini içermeyen sunucu tarafı işlem süresini temsil eder.

Metriklerim neden gecikiyor?

Metrikler, aşağıdaki nedenlerle yaklaşık 2 dakikalık bir gecikmeye sahiptir:

  • Metrik toplama hattı
  • Toplama pencereleri
  • Kontrol paneli önbellekleme

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

Birden fazla uç noktayı birlikte izleyebilir miyim?

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



📅 1 ay önce oluşturuldu ✏️ 5 gün önce güncellendi
glenn-jochersergiuwaxmann

Yorumlar