SpitfireYük Testi ve APMYenilikler

APM top listeler ve metot hot spot'ları

Aralıktaki en çok web isteklerini, SQL ifadelerini, hataları ve metot hot spot'larını tek sayfada görürsünüz; bir satırı açınca kim çağırıyor sorusunun cevabı gelir. Menü: APM → Servisler → Top listeler. APM açık olmalı (APM); ek limit yok.

Top listeler

  1. Aralığı (ör. Son 6 saat) ve gerekirse ortamı seçin.
  2. Sekme seçin: Top web istekleri, Top SQL, Top hatalar, Metot hot spot'ları.
  3. Metin kutusuna yazın ya da filtre çubuğundan filtre ekleyin.
  4. Bir sütun başlığına tıklayın: sunucu o sütuna göre ilk 100'ü yeniden getirir, yalnız ekrandakini sıralamaz.

Sekme, filtreler ve sıralama adres çubuğunda durur; linki paylaşınca aynı görünüm açılır. Servis sayfasındaki Top listeler sekmesi aynı dört listenin o servise ait ilk 10'unu gösterir.

Sekme Satır Sütunlar
Top web istekleri servis + metot + route çağrı, rpm, hata %, p50/p95/p99, toplam süre payı
Top SQL normalize edilmiş ifade DB sistemi/adı, servisler, çağrı, ort./p95/maks., pay, satır, hata %
Top hatalar tip + mesaj fingerprint'i adet, pay, etkilenen servisler, ilk/son görülme, hata sayfası linki
Metot hot spot'ları metot (code.namespace + code.function) çağrı, toplam self süre, self payı, ort./p95 self, hata %

SQL ifadeleri ingest sırasında normalize edilir: değerler ? olur, IN listeleri tek parametreye iner. Aynı ifade farklı değerlerle tek satırdır.

Filtre çubuğu

Top listeler ve Trace'ler sayfası aynı filtre çubuğunu kullanır. Her filtre bir çip olur ve adrese yazılır.

  1. Filtre alanı: servis, host, ortam, versiyon, endpoint, k8s (cluster, namespace, workload, pod, node), container, HTTP status, exception ya da bir eşik (çağrı, hata oranı %, p95 ms gibi).
  2. Koşul: = / ≠ (değer) ya da ≥ / ≤ (eşik).
  3. Değer: kutu aralıkta en çok görülen değerleri önerir. HTTP status için 5xx ya da 404 yazın; hata oranı yüzde olarak girilir (5 = %5).
  4. Ekle'ye basın.

Kayıtlı filtre yoktur; filtreli görünümün linki odur. Linki kopyala ile alıp yer imine koyun ya da ekibe gönderin.

Adres parametresi Anlamı
f_<alan>=değer o değer (tekrarlanabilir; !değer dışarıda bırakır)
f_status=5xx / f_status=404 status sınıfı ya da kodu
f_error=yes / no yalnız hatalı / hatasız satırlar
f_exc_type=…, f_exc_message=… exception tipi (tam), mesajda geçen metin
min_<metrik>=…, max_<metrik>=… eşik; errorRate 0–1 arası, süreler ms
Not

Servis, host, ortam, endpoint, method, namespace, workload, cluster, node ve container filtreleri dakikalık özetlerden 31 güne kadar okunur. Pod, container imajı, exception ve max filtreleri saklanmış span'leri okur, bu yüzden en çok 24 saat aralıkla çalışır. Daha geniş aralıkta uyarı çıkar: aralığı daraltın ya da namespace, workload veya host ile filtreleyin.

Kim çağırıyor

Bir satıra tıklayınca altında Çağırana göre tablosu (çağıran servis, çağrı, pay %, p95, hata %) ve aralık boyunca çağrı/p95 serisi açılır. Alttaki link ilgili sayfaya gider: endpoint'in trace'leri, sorgu sayfası ya da hata sayfası.

İsteklerde çağıran, parent span'in servisidir. Parent'ı olmayan entry span harici sayılır (tarayıcı, job, tracing'i olmayan servis); saklanmamış bir parent bilinmiyor görünür. SQL, hata ve metotlarda çağıran span'in kendi servisidir.

Metot hot spot'ları

Metot satırındaki süre self süredir: metodun span süresinden doğrudan child span'lerinin (DB, HTTP, iç içe metotlar) kapladığı süre çıkarılır. Satırı açınca metodun geçtiği ilk 5 endpoint ve en yavaş çağrının trace'i de görünür.

Dikkat

Metot verisi için servisinizin kod seviyesinde span göndermesi gerekir. HTTP, DB ve kuyruk span'leri kendiliğinden gelir; iş metotlarınız (ör. OrderService.place) ancak aşağıdaki gibi işaretlerseniz görünür. Liste son 24 saatle sınırlıdır.

Satır anahtarı: code.namespace + code.function, yoksa code.function.name, yoksa code.file.path, o da yoksa INTERNAL span'in adı. Biz her metodu değil, şüphelendiğiniz 5-10 iş metodunu işaretlemenizi öneriyoruz; her metoda span koymak span hacmini katlar.

Java

Java agent'ı kod değiştirmeden seçtiğiniz metotlara span ekler. Servisi başlattığınız komuta ekleyin, sınıf ve metot adlarını kendinizinkiyle değiştirin:

bash
java -javaagent:/opt/otel/opentelemetry-javaagent.jar \
  -Dotel.instrumentation.methods.include='com.acme.orders.OrderService[place,cancel];com.acme.pricing.PriceCalculator[calculate]' \
  -jar /opt/app/app.jar

Container'da aynı ayar ortam değişkeniyle:

bash
OTEL_INSTRUMENTATION_METHODS_INCLUDE='com.acme.orders.OrderService[place,cancel]'

Kontrol: servisi yeniden başlatın, birkaç istek atın; birkaç dakika içinde Metot hot spot'ları sekmesinde com.acme.orders.OrderService.place görünür.

.NET

csharp
using System.Diagnostics;

public class OrderService
{
    private static readonly ActivitySource Source = new("Acme.Orders");

    public void Place(Order order)
    {
        using var activity = Source.StartActivity("OrderService.Place");
        activity?.SetTag("code.namespace", "Acme.Orders.OrderService");
        activity?.SetTag("code.function", "Place");
        // metodun gövdesi
    }
}

Kaynağı OTel kurulumunuza ekleyin: builder.Services.AddOpenTelemetry().WithTracing(t => t.AddSource("Acme.Orders"));

Python

python
from opentelemetry import trace

tracer = trace.get_tracer("acme.orders")

@tracer.start_as_current_span("OrderService.place", attributes={"code.namespace": "acme.orders.OrderService", "code.function": "place"})
def place(order):
    ...  # metodun gövdesi

Node.js

js
const { trace } = require('@opentelemetry/api');
const tracer = trace.getTracer('acme-orders');

async function place(order) {
  return tracer.startActiveSpan('OrderService.place', { attributes: { 'code.namespace': 'OrderService', 'code.function': 'place' } }, async (span) => {
    try {
      // metodun gövdesi
    } finally {
      span.end();
    }
  });
}

Sürekli profiling (flame graph) yok. İşaretlenmemiş kod, içinde çağrıldığı span'in self süresine yazılır.