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
- Aralığı (ör. Son 6 saat) ve gerekirse ortamı seçin.
- Sekme seçin: Top web istekleri, Top SQL, Top hatalar, Metot hot spot'ları.
- Metin kutusuna yazın ya da filtre çubuğundan filtre ekleyin.
- 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.
- 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).
- Koşul:
=/≠(değer) ya da≥/≤(eşik). - Değer: kutu aralıkta en çok görülen değerleri önerir. HTTP status için
5xxya da404yazın; hata oranı yüzde olarak girilir (5= %5). - 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 |
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.
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:
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.jarContainer'da aynı ayar ortam değişkeniyle:
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
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
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övdesiNode.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.