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

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:#fffGenel Bakış Kartları
Sayfanın üst kısmındaki dört özet kartı şunları gösterir:

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

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üm | Açıklama |
|---|---|
| Kartlar | Metrikler, 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) |
| Tablo | Sıralanabilir sütunlara sahip DataTable: Ad, Bölge, Durum, İstekler, P95, Hatalar |
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ı
| Metrik | Açıklama |
|---|---|
| İstekler | Simge ile istek sayısı (24s) |
| P95 Gecikme | yü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ö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 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.

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:

Günlük Girişleri
Her günlük girişi şunları gösterir:
| Alan | Açıklama |
|---|---|
| Önem Derecesi | Renk kodlu çubuk (aşağıya bak) |
| Zaman Damgası | İstek zamanı (yerel format) |
| Mesaj | Günlük içeriği |
| HTTP bilgisi | Durum kodu ve gecikme (varsa) |
Filtre düğmelerini kullanarak günlükleri önem derecesine göre filtrele:
| Seviye | Renk | Açıklama |
|---|---|---|
| DEBUG | Gri | Hata ayıklama mesajları |
| INFO | Mavi | Normal istekler |
| WARNING | Sarı | Kritik olmayan sorunlar |
| ERROR | Kırmızı | Başarısız istekler |
| CRITICAL | Koyu 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.
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())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/monitoringKimliğ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=24hBelirli bir dağıtım için sparkline verilerini ve özet metrikleri döndürür. Yenileme aralığı: 60 saniye.
| Parametre | Tür | Açıklama |
|---|---|---|
sparkline | bool | Sparkline verilerini dahil et |
range | dize | 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 girişlerini 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 | dize | Virgülle ayrılmış önem derecesi filtresi |
pageToken | dize | Önceki yanıttan gelen sayfalama belirteci |
Dağıtım Sağlığı
GET /api/deployments/{deploymentId}/healthYanı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:
- Örnek sayısını kontrol et (daha fazlasına ihtiyaç olabilir)
- Model boyutunun uygun olduğunu doğrula
- Daha yakın bir bölge kullanmayı düşün
- Gönderilen görüntü boyutlarını kontrol et
Ç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 Tipi | Saklama |
|---|---|
| Metrikler | 30 gün |
| Günlükler | 7 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)
/healthuç 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.