İ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.

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:

| Metrik | Açı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

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üm | Açıklama |
|---|---|
| Kartlar | Metrikler, günlükler, kod ve tahmin sekmeleri içeren tam detay kartları |
| Kompakt | Anahtar metriklerle daha küçük kartlardan oluşan ızgara (1-4 sütun) |
| Tablo | Sı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ı
| Metrik | Açıklama |
|---|---|
| İstekler | İstek sayısı (24s) simgeyle |
| P95 Gecikmesi | 95. 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österge | Anlamı |
|---|---|
| Yeşil kalp | Sağlıklı — yanıt gecikmesini gösterir |
| Kırmızı kalp | Sağlıksız — hata mesajını gösterir |
| Dönen simge | Sağ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.

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:

Günlük Kayıtları
Her günlük girişi şunları gösterir:
| Alan | Açıklama |
|---|---|
| Önem derecesi | Renk kodlu çubuk (aşağıya bakınız) |
| Zaman damgası | İstek zamanı (yerel biçim) |
| Mesaj | Günlük içeriği |
| HTTP bilgisi | Durum kodu ve gecikme (uygulanabilirse) |
Filtre düğmelerini kullanarak günlükleri önem derecesine göre filtreleyin:
| Seviye | Renk | Açıklama |
|---|---|---|
| DEBUG | Gri | Hata ayıklama mesajları |
| INFO | Mavi | Normal istekler |
| WARNING | Sarı | Kritik olmayan sorunlar |
| HATA | Kırmızı | Başarısız istekler |
| CRITICAL | Koyu Kırmızı | Kritik hatalar |
| Kontrol | Açıklama |
|---|---|
| Hatalar | HATA ve UYARI girdilerine göre filtrele |
| Tüm | Tüm günlük girdilerini göster |
| Kopyala | Görünür tüm günlükleri panoya kopyala |
| Yenile | Gü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.
| Parametre | Tür | Açıklama |
|---|---|---|
sparkline | bool | Sparkline verilerini dahil et |
range | string | Zaman 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.
| Parametre | Tür | Açıklama |
|---|---|---|
limit | int | Döndürülecek maksimum giriş sayısı (varsayılan: 50, maksimum: 200) |
severity | string | Virgülle ayrılmış önem derecesi filtresi |
pageToken | string | Ö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:
- Örnek sayısını kontrol edin (daha fazlasına ihtiyaç duyulabilir)
- Model boyutunun uygun olduğunu doğrulayın
- Daha yakın bir bölge düşünün
- 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:
- hata günlüklerini gözden geçirin
Logssekmesi - İstek formatını kontrol edin (multipart form gerekli)
- API anahtarının geçerli olduğunu doğrulayın
- Oran sınırlarını kontrol edin
Kapasiteye ulaşılırsa:
- Birden fazla bölgeyi değerlendirin
- İstek gruplamayı optimize edin
- CPU ve bellek kaynaklarını artırın
SSS
Veriler ne kadar süreyle saklanır?
| Veri Türü | Saklama |
|---|---|
| Metrikler | 30 gün |
| Günlükler | 7 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
/healthuç 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.