İzleme#
Ultralytics Platform, dağıtılan uç noktalar için izleme olanağı sunar. İstek metriklerini takip et, günlükleri görüntüle ve otomatik yoklama ile 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]:::proc --- Cards[Overview Cards]:::proc
Cards --- List[Deployments List]:::decide
end
subgraph "Per Deployment"
Metrics[Metrics Row]:::out
Health[Health Check]:::out
Logs[Logs Tab]:::out
Code[Code Tab]:::out
Predict[Predict Tab]:::out
end
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:#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ı kartı, oran %5'i aştığında kırmızı renkte 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 42 bölgenin tamamı için bölge iğneleri
- Dağıtılmış bölgeler için Yeşil iğneler
- Aktif dağıtımı devam eden bölgeler için Hareketli mavi iğneler
- İğne boyutu, dağıtım durumuna ve gecikmeye göre 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 düğmesini 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 |
| Kompakt | Temel metrikleri içeren daha küçük kartlardan oluşan ızgara (1-4 sütunlu) |
| Tablo | Sıralanabilir sütunlara sahip DataTable: Ad, Bölge, Durum, İstekler, P95, Hatalar |
Kontrol paneli, 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 sıklığı her 3 saniyede bire çıkar. Dağıtım başına metrikler her 60 saniyede bir yenilenir. Anlık güncellemeler için yenileme düğmesine tıkla.
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) ve simge |
| P95 Gecikme | 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 60 saniyede bir yenilenir.
Sağlık Kontrolü#
Çalışan dağıtımlar bir sağlık kontrolü göstergesi sunar:
| 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 tekrar denenir. Sağlık kontrolünü manuel olarak 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ü isteği, sıfıra ölçekleme yapılan bir uç noktanın başlaması için zaman tanımak amacıyla 55 saniyeye kadar süre tanır.
Günlükler#
Her dağıtım kartı, son günlük girdilerini görüntülemek için bir Logs sekmesi içerir:

Günlük Girdileri#
Her günlük girdisi şunları gösterir:
| Alan | Açıklama |
|---|---|
| Önem Derecesi | Renkli kodlanmış ç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:
| Düzey | 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 girdiyi gösterir. API, istek başına varsayılan olarak 50 girdi sağlar (maksimum 200).
Hataları araştırırken: önce ERROR ve WARNING girdilerine filtrelemek için Hatalar'a 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())Platformdaki Code sekmesini görüntülerken, gerçek uç nokta URL'in 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, modelin Predict sekmesiyle aynı arayüze sahip ancak çıkarımı paylaşılan servis yerine dağıtım uç noktası üzerinden çalıştıran satır içi bir tahmin paneli sağlar. Bu, dağıtılmış bir uç noktayı doğrudan tarayıcıdan test etmek için yararlıdır. Parametre ayrıntıları 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 aracılığıyla ç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 | Tip | 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 | Tip | Açıklama |
|---|---|---|
limit | tamsayı | 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 sayfalama jetonu |
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,
"serverTiming": { "db": 8, "ping": 142, "total": 150 }
}Performans Optimizasyonu#
Dağıtımlarını optimize etmek için izleme verilerini kullan:
Eğer gecikme çok yüksekse:
- Model boyutunun uygun olduğunu doğrula
- Daha yakın bir bölge düşün
- Her istekle birlikte gönderilen görüntü boyutunu kontrol et
Daha küçük bir imgsz değeri dene ve modelin için elde edilen gecikme ve doğruluğu karşılaştır. Ağ gecikmesini azaltmak için arayanlara daha yakın bir bölgeye dağıt.
SSS#
Veriler ne kadar süre saklanır?#
Metrikler API'si, 1 saatten 30 güne kadar seçilebilir pencereleri destekler. Dağıtım kartı en son 20 günlük girdisini gösterir; günlükler API'si istek başına 200 girdiye kadar dönebilir ve sayfalamayı destekler.
Birden fazla uç noktayı birlikte izleyebilir miyim?#
Evet, dağıtımlar sayfası tüm uç noktaları özet kartları ile birleştirilmiş şekilde gösterir. Dağıtımlar arasındaki performansı karşılaştırmak için tablo görünümünü kullan.