Panolar
Log, trace ve metrik sorgularından oluşan sürükle-bırak panolar. Hangi panel türleri var, değişkenler nasıl çalışır, paylaşım nasıl olur.
Panolar, Orbtrace'in kendin-oluştur görünümüdür — log, trace ve metrik panelleri bir ızgarada; war-room TV'si, ikinci monitör ya da sabah kontrolü için.
Pano nedir?
Bir ızgaraya yerleştirilmiş panel koleksiyonu. Her panel bir sorgu çalıştırır (loglar, trace'ler veya metrikler üstünde) ve bir grafik, tek bir sayı, tablo ya da ısı haritası çizer. Savaş odası TV'sine astığınız, dizüstünüzün ikinci monitöründe açtığınız, sabah rutininizdeki ekran budur.
Pano dizini
Kenar menüden Panolar'a tıklayınca dizine düşersiniz — her panonun kart ızgarası. Her kartta:
- Başlık.
- Klasörü (isteğe bağlı; takım gruplamak için).
- Etiketler.
- Son değiştirilme ve düzenleyen.
- Listeyi öne taşıyan "Yıldız".
- "İzinler" kapsülü — kim okuyabilir / düzenleyebilir.
Üstte: arama kutusu, klasör filtresi, "+ Yeni pano" butonu, "Şablonlara göz at" butonu (Kafka, Redis, JVM, Spring, vs. — kopyala ve düzenle).
Panoyu açmak
Bir karta tıklayın. Sayfada dört parça:
- ① Başlık çubuğuPano adı, klasörü, zaman seçici, yenileme aralığı, "Düzenle" anahtarı, paylaşım menüsü.
- ② Değişken satırıPanoyu parametrelendirmek için açılır listeler — örn.
$service,$environment. Değer seçince her panel yeniden çalıştırılır. - ③ Panel ızgarasıPanellerin kendisi. Düzenleme modunda köşeleri sürükleyerek boyutlandırın; panel başlığına panel menüsü için tıklayın.
- ④ AltbilgiSon yenileme zamanı, sorgu süresi, panel sayısı.
Panel türleri
- Zaman serisiEn yaygın. Çizgi / alan / çubuk. Bir veya daha fazla metrik sorgusunu zamanda çiz. Y ekseni etiketi, birim, legenda yeri ayarlanabilir.
- StatTek büyük sayı. "Anlık RPS", "anlık hata oranı" için. İsteğe bağlı arkaplan sparkline; eşik renklendirmesi.
- GaugeYarım daire kadran. "N üstünde" anlamlı değerler için — örn. aylık bütçenin % cinsinden kalanı.
- Bar gaugeYatay çubuklar, group-by değeri başına bir. "p99'a göre en iyi 10 endpoint" için.
- TabloSatır × sütun, öznitelik veya toplama başına sütun. Sıralanabilir. Eşikle hücre rengi.
- Isı haritasıX'te zaman, Y'de histogram kovası. Gecikme dağılımı için.
- Log paneliEşleşen log sorgusunun canlı izleme görünümü. Bir satıra tıklamak Loglar detay panelini açar.
- Top listeBasit sıralı liste — "p99'a göre top 10".
- MarkdownMetin paneli. Bölüm başlıkları, runbook bağlantıları, sahip irtibatı için.
Değişkenler — nasıl çalışır?
Dişli ikon → "Değişkenler". Ekle:
- Ad (örn.
service). - Tür —
query(metrik özniteliğinden açılır liste),interval(1m / 5m / 1h…),text(serbest metin),constant(sabit değer). - Varsayılan değer ve çoklu seçim izni.
Panel sorgusunda $service (ya da tüm değerler için $service:all) olarak başvurun. Kullanıcı üst açılır listeyi değiştirince her sorgu yeniden çalışır.
Değişkenler tek bir panoyu her takıma sundurur. $service'li tek "Servis özeti" panosuyla biri checkout-api'yi, diğeri inventory-service'i aynı şablondan görür.
Paneli düzenlemek
Panel başlığının "…" menüsü → Düzenle. Düzenleme görünümü ekranı böler:
- Sol: SorguMetrik kâşifi ile aynı seçici / filtre / group-by / toplama. Her panel birden çok sorgu tutabilir.
- Sağ: ÖnizlemePanel olarak görüneceği grafik.
- Sağ: StilEksen etiketleri, birimler, legenda konumu, eşikler (sayı → renk), null davranışı (boşluk / bağla / sıfır).
- Sağ: Alan üzerine yazmaSeri başına stili geçersiz kıl (örn. "p99 her zaman gül").
Uygula → kaydedip dön. Vazgeç → geri al.
Paylaşma
Paylaşım menüsü üç seçenek:
- URL kopyalaMevcut durumu (zaman seçici, değişkenler) gösteren kalıcı URL. Sohbet için.
- Anlık görüntüSalt okunur URL. Veri donar — post-mortem'lerde veri silindikten sonra bile durumu korur.
- JSON dışa aktarPano tanımını indir. Başka Orbtrace sürümüne içe aktarılabilir.
Sahiplik ve paylaşım
Her pano, onu oluşturan kullanıcıya aittir (kayıtta bir owner_user_id). Orbtrace'in yalnızca iki düz rolü vardır — USER ve ADMIN — ve pano başına erişim-kontrol listesi yoktur: pano başına ayrı read/edit/admin yetkisi verilmez. Bir panoyu JSON dışa aktar (ya da salt-okunur anlık görüntü URL'si) ile paylaşır ve başka yere içe aktarırsınız, bir kullanıcıya o pano üzerinde izin vererek değil. Instance'taki herkes kendi panolarını oluşturup kaydedebilir.
Şablonlar
Hazır panolar (Kafka, Postgres, Redis, JVM, gRPC, Spring Boot, .NET, Node, Go runtime, Kubernetes pod) Şablonlara göz at'ta. İçe aktarmak doğru değişkenlerle kopyalar; sonra serbestçe düzenlersiniz.
İpuçları
- Her servis için bir pano,
$serviceparametreli. Yeniden kullanım kopyalamayı yener. - Yararlı yenileme aralığı seçin. Statik analizde "Kapalı", canlı operasyonda 30 sn, yönetici özetinde 5 dk.
- Markdown panellerini kullanın. En üstte 3 satırlık "Bu pano ne için / kim sahipleniyor / runbook bağlantısı" paneli başka bir grafikten daha çok zaman kazandırır.
- Her şeyi tek panoya koymayın. Üç odaklanmış pano, tek mega panoyu yener.
Sırada: Alarmlar.