Orbtrace

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:

  • errorerror kelimesini 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.

On screen
  • Ç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

On screen
  • 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?

On screen
  • Ş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ğı

On screen
  • 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_id varsa "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 NEW etiketli 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.