Loglar
Bir olayı açıklayan log satırını bulduğunuz ekran. Histogram, arama çubuğu, desen kümelemesi, detay paneli — her birinin ne işe yaradığı.
Loglar ekranı dört parça etrafında kurulmuştur: arama çubuğu, histogram, sonuç tablosu ve tıklayınca açılan detay paneli. Bu sayfayı bir kez okuyun, her parçanın ne için olduğunu öğrenirsiniz.
① Arama çubuğu
Üstte tek satırlık serbest giriş. Yazın; süzer. Enter ile çalıştırın. Söz dizimi HyperDX / Kibana tarzıdır — tam liste için Arama söz dizimi. Kısaca:
error—errorkelimesini içeren her kayıt.level:ERROR— yalnız ERROR önemi.service:checkout-api AND level:ERROR— boolean AND/OR/NOT destekli."Connection refused"— alıntı tam eşleşme.duration:>500— sayısal her öznitelikte çalışır.user_id:42— dize her öznitelikte çalışır.
Siz yazarken otomatik tamamlama menüsü mevcut pencerede var olan alan adlarını (: solu) ve değerlerini (sağı) önerir. Tab ile kabul edin.
/ kısayolu, sayfanın herhangi bir yerinden arama çubuğunu odaklar.
② Histogram
Arama çubuğunun hemen altında, zaman seçici aralığı boyunca 28 çubuklu bir grafik. Her çubuğun yüksekliği o kovada eşleşen log sayısıdır.
- Çubuk rengiNormal hacimde camgöbeği. Hata sayısı en fazla 3 kova için gül — gözünüz "sıçramaları" hemen bulur.
- Sürükle-seçÇubuklar üstünde tıkla-sürükle ile zaman seçiciyi o aralığa yakınlaştır. Histogram, tablo ve sayfadaki diğer her panel anında yeniden sorgulanır.
- Toplam sayımHistogramın üstünde, "X eşleşen olay" — görünen tüm kovaların toplamı.
- Üzerine gelmeÇubuğa gelince kovanın kesin başlangıç/bitişi ve sayısı görünür.
Histogram, Orbtrace'in en hızlı "garip bir şey oldu mu?" kontrolüdür. Düz şekil = sessiz dönem. Yükselen eğim = devam eden olay. İzole uzun çubuk = araştırmaya değer geçici sıçrama.
③ Sonuç tablosu
Histogramın altında, yeniden eskiye, satır başına bir log.
Varsayılan sütunlar
- Zaman damgasıYerel TZ + kısaltma. Üzerine gelince tam UTC ve nano cinsinden kaynak zaman damgası.
- ÖnemRenkli kapsül: TRACE · DEBUG · INFO · WARN · ERROR · FATAL.
- ServisTıklamak bu servisi arama kutusuna ekler.
- MesajTek satır kısaltma.
- Öznitelik önizlemeBirkaç önemli öznitelik çip olarak (
user_id=42,route=/checkout).
Sütunları özelleştirin
Tablonun sağ üstündeki sütun ikonuyla istediğiniz özniteliği sütun ekleyin. Orbtrace seçiminizi kayıtlı sorgu başına hatırlar.
Sıralama, gruplama, sonsuz kaydırma
- Varsayılan sıralama "yeniden eskiye". Başlığa tıklayınca tersine döner.
- "Şablona göre grupla" anahtarı tabloyu şablon başına tek satıra indirir.
- Aşağı kaydırma istek üzerine daha fazla satır yükler — sayfa düğmesi yok.
④ Desen kümelemesi — buradaki başrol
Tablonun üstündeki anahtar: Şablona göre grupla. Açın.
Orbtrace her log satırı üstünde Drain3 tarzı şablon çıkarımı yapar: değişken kısımlar (sayılar, ID'ler, yollar) <*> ile değiştirilir; oluşan "şablon" küme anahtarıdır. 50.000 satıra bakmak yerine ~120 şablon görürsünüz.
Gruplandığında her satırda ne var?
- ŞablonNormalize gövde. Değişken kısımlar
<*>olarak. - SayımBu şablonun mevcut penceredeki satır sayısı.
- SparklineKova başına hacim — mini histogram. Bu şablonun hacminin artıp artmadığını görürsünüz.
- EtiketlerBir dizi kapsül:
NEW(pencerede ilk kez),SPIKE(hacim önceki eş pencereye göre 5×+),DROP(5×− düşüş). - GenişletSatıra tıklayınca yerinde genişler; altta gerçek satırları görürsünüz.
NEW en kullanışlısıdır: deploy'dan hemen sonraki NEW şablon neredeyse her zaman işlenmemiş kod yoludur. SPIKE retry döngülerini yakalar.
⑤ Detay paneli
Bir satıra tıklayın → sağdan panel kayar.
Panelde, yukarıdan aşağı
- BaşlıkZaman damgası, önem kapsülü, servis, "Linki kopyala" (bu log'a kalıcı link), "JSON" / "Form" anahtarı.
- GövdeTam mesaj — uzun gövdeler burada rahat okunur.
- ÖzniteliklerHer öznitelik için iki sütunlu tablo. Her satırda "için süz" ve "dışla" kalem ikonu — arama kutusuna ekler ve yeniden çalıştırır.
- Trace bağlamı
trace_idvarsa "Trace'i aç" butonu — trace detayı o trace yüklü açılır. - Bağlam satırları"Context" sekmesi bu satırın aynı servisten 10 önceki ve 10 sonraki satırını gösterir — bir hatanın etrafında neler olduğunu yeniden inşa etmek için altın değerinde.
- JSON sekmesiHam OTLP kaydı. Yalnız şema sorunundan şüphelendiğinizde; günlük kullanım için değil.
Sorgu kaydetme ve paylaşma
Arama çubuğunun sağındaki Sorguyu kaydet. Kayıtlı sorgular ⌘K paletinde ve arama çubuğunun altındaki hızlı erişim açılır listesinde görünür. Her birinin paylaşılabilir URL'si vardır — sohbete yapıştırın, arkadaşınıza tam baktığınız şeyi gönderin.
Karşılığını veren ipuçları
- Önce tabloya değil, histograma bakın. Şekli tarayın; sonra ilginç kovayı sürükleyip seçin; sonra satırları okuyun.
- Kaydırmadan önce şablona göre gruplayın. Aradığınız satır %99 olasılıkla
NEWetiketli olandır. - Detay paneliyle pivot yapın. Tıkla-süz aksiyonlarının çoğu paneldedir; yeniden yazmaya nadiren ihtiyacınız olur.
- Önce
service:<ad>, sonra daral. Servisle erken süzme, serbest metin aramasına göre 100× hızlandırır.
Bu ekranın yapmadıkları
- Gerçek zamanlı akış — Canlı izleme ekranı için. Loglar ekranı arama gerektirir ve zaman seçiciye uyar.
- Pano paneli kurma — arama çubuğunun "Panel olarak kaydet" menüsünden mevcut sorguyu bir panoya panel olarak iter.
Sırada: Canlı izleme.