Skip to main content
Telemetri, bir uygulamanın kendi davranışı hakkında gönderdiği yapılandırılmış kanıttır. Loglar bildirilen olayları kaydeder. İzler işlemleri birbirine bağlar. Metrikler değerleri ölçer. Sorunlar hataları gruplar. Aksiyonlar ürün etkinliğini kaydeder. Proje, hizmet, ortam, sürüm ve zaman alanları her sonucun kapsamını verir. SDK’nızın yakaladığı sinyaller için SDK entegrasyonu rehberini okuyun.

Bir sinyal seçin

Bir hata incelemesine sorunlarla veya loglarla başlayın. Tek bir yürütmeyi incelemek için mevcut bir izi kullanın. Daha geniş dönemi incelemek için bir metrik eğilimi kullanın. Etkinlik ve elde tutma için Ürün analizleri sayfasını okuyun. Yalnızca bir incelemenin ihtiyaç duyduğu alanları yakalayın. Kararlı hizmet, işlem ve metrik adları kullanın. Kimlik bilgilerini, ödeme verilerini veya ham istek gövdelerini göndermeyin. Gerekli kontrolleri Yakalanan verileri denetleyin rehberi verir.

Loglar

Log, uygulamanın belirli bir andaki kaydıdır. Yararlı bir log şunları içerir:
  • Olayın kaynaktaki zamanı.
  • Standart bir önem düzeyi.
  • Proje ve hizmet kapsamı.
  • Ortam ve sürüm.
  • Logun etkin iz bağlamı varsa iz ve span kimlikleri.
  • Olayın bağlamını taşıyan küçük, adlandırılmış öznitelikler.
Log yanıtı bu değerleri occurred_at, severity, project_id, service_name, environment, release, trace_id, span_id ve attributes alanlarında verir. Bağlamı mesaj metnine değil, adlandırılmış özniteliklere koyun. Tek bir görünümdeki farklı hizmetlerden gelen loglar arasında iz ilişkisi yoktur. Bu ilişkiyi yalnızca iz bağlamı kurar.

İzler

Bir iz, tek bir isteğin veya işlemin span’lerini içerir. Kök span’in üst span’i yoktur. Alt span kendi üst span’ini belirtir. Bir izdeki tüm span’lerin iz kimliği aynı, span kimlikleri farklıdır. Bkz. Dağıtık izleme. Etkin iz bağlamı olmadan gönderilen bir log, sorun, aksiyon veya metrik bir yakalama izi alır. Bu iz yalnızca yakalama span’leri içerir. Bir istek yolunu göstermez. Bkz. Yakalama span’leri.

Metrikler

Metrik, zaman içinde ölçülen bir değeri kaydeder. Her metriği adı, birimi, boyutları, projesi, zaman aralığı ve aralık genişliğiyle birlikte okuyun. LogBrew her noktanın value değerini metriğin kind ve temporality alanlarına göre seçer: Örneğin, bir aralıkta değerleri 2, 3 ve 5 olan üç delta sayaç örneği, 10 değerinde bir nokta value ve 3 değerinde bir sample_count verir. Aynı değerlere sahip üç gauge örneği bu sırayla geldiğinde nokta value değeri 5 olur. p95 değeri bir ortalama değildir. Kaydedilen gözlemlerin yaklaşık %95’i bu değerde veya altındadır. status: "ready" için türetilmiş toplama kullanılabilir. status: "limited" için aggregation.limitation alanını okuyun ve yalnızca ham değerleri kullanın. Bir gauge’u veya kümülatif bir akışı toplamayın. Noktası olmayan bir aralık, ölçülmüş bir sıfır değildir. Sorgu alanları için Sorgu filtreleri sayfasını okuyun. GET /api/telemetry/metrics/series bu noktaları döndürür. project_id, name ve since gerektirir. Her serinin kind, unit ve temporality içeren tek bir identity değeri vardır. Kimlikleri farklı seriler ayrı kalır. Her nokta şunları da içerebilir: series_limit daha düşük hacimli serileri dışarıda bıraktığında coverage.truncated değeri true olur. Bir metrik penceresini aynı uzunluktaki önceki pencereyle karşılaştırmak için şunu çalıştırın:

Sorunlar

Sorun, tekrar eden hataları kararlı bir parmak iziyle gruplar. Önem düzeyi, durumu, oluşum sayısı, ilk görülme zamanı ve son görülme zamanı vardır. Sorun ayrıntıları istisna zincirleri, yığın çerçeveleri, önceki adımlar (breadcrumbs), ilişkili loglar ve bir iz ilişkisi ekleyebilir. last_seen_at, gruptaki en yeni oluşumdur. Seçtiğiniz oluşum daha eski olabilir. İki zamanı da okuyun. Sorunun status değeri unresolved, resolved veya archived olur. API yanıt sürümü 1, archived değerini ignored olarak gösterir. Yanıt sürümleri 2 ve 3, priority (high, medium veya low) ve priority_source alanlarını ekler. Sürüm 3 ayrıca assignee alanını ekler. Bkz. Durum değerleri ve Öncelik.

Aksiyonlar

Aksiyon, ürün etkinliğini kaydeder. Desteklenen sınıflandırma onu sayfa görüntüleme, ekran görüntüleme veya etkileşim olarak işaretler. Olay adı tek başına sınıflandırmayı belirlemez. Bu bağlamı eklemek için Ürün olaylarını yakalama rehberini kullanın. Oturumlar kullanıcı değildir. Anonim özneler tanımlı kullanıcı değildir.

Ortak alanlar

Önem düzeyi değerleri

LogBrew eş adları büyük veya küçük harfle yazılmış olsa da giriş olarak kabul eder. API, CLI ve canlı olaylar standart değerleri kullanır. Bilinmeyen önem düzeyi değerleri reddedilir. Önem düzeyi, kaydedilen aciliyettir. İş etkisini veya kök nedeni göstermez. Bir kullanıcı, bir sorunun veya logun gösterilen önem düzeyini değiştirebilir. Bu durumda yanıt effective_severity içeren bir triage nesnesi taşır. severity alanı yakalanan değeri korur.

Canlı ve anlık görüntü okumaları

logbrew read, seçilen proje, zaman aralığı ve filtreler için bir anlık görüntü döndürür. Yeni olayları okumak için komutu yeniden çalıştırın. logbrew watch, bağlantı açık kaldığı sürece yeni logları, sorunları ve aksiyonları akış olarak verir. İzleri veya metrikleri akış olarak vermez. Bağlantı hatası, projenin boş olduğunu göstermez.

Kanıt durumları

Yanıtlar şu durumları ayrı tutar: yakalandı, eksik, gizlendi, kısaltıldı ve kullanılamıyor. İz kanıtının dört durumu vardır: available, not_linked, not_found ve unavailable. Anlamları için giriş sayfasına, kapsama oranı alanları için Kanıt sınırları bölümüne bakın. Daha yeni bir SDK, daha önce gönderdiği olaylara alan eklemez.

Tek bir projeyi inceleyin

1

Çözülmemiş sorunları bulun

2

Bir sorunu okuyun

Bu komut saklanan sorun geçmişini okur. Listedeki --since filtresi burada geçerli değildir.
3

Mevcut bir izi açın

İz kimliğini yalnızca seçilen oluşum bir iz kimliği döndürdüğünde kullanın.
4

İlişkili kanıtı okuyun

Logları, aksiyonları ve metrikleri aynı proje, hizmet, ortam ve sürümle filtreleyin. Sinyalleri yalnızca zamana bakarak ilişkilendirmeyin.
Yanıt alanları için Telemetri API’si ve Yanıt biçimleri sayfalarını okuyun.