> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adım Adım İzleme Sekmesi

> API Proxy'nin mesaj trafiğini izleyerek hata tespiti yapmak için kullanılır. Trace modunu aktifleştirerek mesaj akışını adım adım takip edebilirsiniz, politika işletim sonuçlarını görüntüleyebilirsiniz ve sorunların kaynağını tespit edebilirsiniz.

## Adım adım izleme modunu başlatma

### Önkoşul: ortamda yükleme

Bir API Proxy'nin izleme moduna geçirilebilmesi için öncelikle bu API Proxy'nin **en az bir ortama** yüklenmiş olması gerekir.

### Ortam seçimi, filtre ve başlatma

İzleme modunun açılacağı **ortam** seçilir ve **Başlat (Start)** tuşuna tıklanır. Ortam seçiminin yanındaki filtre alanından **Custom Query** ile yalnızca istenen veriler üzerinden özel olarak trace edilebilir.

<img src="https://mintcdn.com/apinizer/b92tyAv6JpTHUWXg/images/develop/izleme-analiz/trace-start.png?fit=max&auto=format&n=b92tyAv6JpTHUWXg&q=85&s=8ab6ec35ceda3632054c245da8d63ba3" alt="Adım Adım İzleme Modunu Aktifleştirme" width="600" data-path="images/develop/izleme-analiz/trace-start.png" />

### Mod süresi ve log içeriği

Adım Adım İzleme modu etkinleştirildiğinde, API Proxy için saklanan log kayıtlarının içeriği detaylı incelemeye uygun şekilde **genişletilir**; mod durdurulana veya **5 dakika** sonra platform tarafından otomatik kapatılana kadar bu biçimde saklanmaya devam eder.

### Logları yenileme

Görüntülenen log kayıtları, bulunan kayıtların kaybolmaması için **otomatik yenilenmez**. Güncel listeyi almak için **Logları Yenile (Refresh Logs)** tuşunu kullanın.

***

## Log tablosu

**Örnek log kayıtlarını içeren görsel:**

<img src="https://mintcdn.com/apinizer/b92tyAv6JpTHUWXg/images/develop/izleme-analiz/trace-logs.png?fit=max&auto=format&n=b92tyAv6JpTHUWXg&q=85&s=252ccd3a7d20a04c014c5cfe14891b57" alt="Log Kayıtları" width="1000" style={{ maxWidth: '1000px', width: '100%', height: 'auto' }} data-path="images/develop/izleme-analiz/trace-logs.png" />

Tabloda görünen her kayıt, istemciden bu API Proxy'e gelen bir **istek** ve o isteğe verilen **yanıt** ile ilişkilidir. Bu mesaj üzerinde aşağıdaki satır işlemleri kullanılabilir.

<Info>
  API Çağrı Politikasının log kaydı ayrı olarak tutulduğu için aynı isteğe ait **çift log** gözükmektedir.
</Info>

***

## Satır üzerindeki işlemler

Liste görünümünde her satırda menü veya kısayol tuşlarıyla aşağıdaki eylemler yapılır.

### Detaylı görüntüleme (Detailed View)

İncelenmek istenen istek satırının sonundaki menüde **birinci** öğe, o mesaja ait log kayıtlarını gösteren pencereyi açar.

<img src="https://mintcdn.com/apinizer/b92tyAv6JpTHUWXg/images/develop/izleme-analiz/trace-detailed-view-button.png?fit=max&auto=format&n=b92tyAv6JpTHUWXg&q=85&s=f8dc9e4e996323e3b9a09a7fe39b4966" alt="Detaylı Görüntüleme" width="800" data-path="images/develop/izleme-analiz/trace-detailed-view-button.png" />

Açılan pencerede loglar mesaj akışına göre bölümlere ayrılır. İncelenecek bölümün (örneğin **İstemciden API Proxy'e Gelen İstek (Request From Client)**) adına tıklandığında ilgili loglar listelenir. Varsayılan olarak **Genel Bakış (Overview)** açıktır.

<img src="https://mintcdn.com/apinizer/b92tyAv6JpTHUWXg/images/develop/izleme-analiz/trace-detailed-view-dialog.png?fit=max&auto=format&n=b92tyAv6JpTHUWXg&q=85&s=bd29ee4995f9ba3c88ffb691dbdefc24" alt="Detaylı Görüntüleme Dialog" width="800" data-path="images/develop/izleme-analiz/trace-detailed-view-dialog.png" />

### JSON formatında görüntüleme (JSON View)

Detaylı Görüntüleme tuşunun yanındaki tuş, log kayıtlarını **JSON** formatında gösterir.

<img src="https://mintcdn.com/apinizer/b92tyAv6JpTHUWXg/images/develop/izleme-analiz/trace-json-view.png?fit=max&auto=format&n=b92tyAv6JpTHUWXg&q=85&s=6ea784144f00631a299689251a4c2b87" alt="JSON Görüntüleme" width="800" data-path="images/develop/izleme-analiz/trace-json-view.png" />

**JSON Görüntüleme** ile açılan diyalog örneği:

<img src="https://mintcdn.com/apinizer/b92tyAv6JpTHUWXg/images/develop/izleme-analiz/trace-json-dialog.png?fit=max&auto=format&n=b92tyAv6JpTHUWXg&q=85&s=a55debb0eb5d9ab130710c606e67d7ce" alt="JSON Dialog" width="800" data-path="images/develop/izleme-analiz/trace-json-dialog.png" />

### İndirme (Download)

Log kayıtlarını toplu olarak indirip daha ayrıntılı inceleyebilirsiniz. Adım adım izleme açıkken Apinizer, API Proxy için işletilen **tüm politikalar** için ayrıntılı log üretir; indirme, istek bazında oluşan kayıtları **tek seferde** almanızı sağlar.

<img src="https://mintcdn.com/apinizer/b92tyAv6JpTHUWXg/images/develop/izleme-analiz/trace-download.png?fit=max&auto=format&n=b92tyAv6JpTHUWXg&q=85&s=8df0c44bd69f1d878b039f4d8480109d" alt="İndirme" width="800" data-path="images/develop/izleme-analiz/trace-download.png" />

### Hızlı test (Quick Test)

Satırdaki **Hızlı Test (Quick Test)** tuşu, gönderilen isteği yeniden göndererek test etmek üzere [Test Konsolu](/tr/develop/test-debug-araclari/test-console) ekranına geçiş yapar.

<img src="https://mintcdn.com/apinizer/b92tyAv6JpTHUWXg/images/develop/izleme-analiz/trace-quick-test.png?fit=max&auto=format&n=b92tyAv6JpTHUWXg&q=85&s=74493b4688fa8ab2a5f85a1dcdb7fdd4" alt="Hızlı Test" width="800" data-path="images/develop/izleme-analiz/trace-quick-test.png" />

***

## Trace detayı: Seç

Apinizer adım adım izleme modundayken, API Proxy için işletilen politikalara ait ayrıntılı logları görmek için **Seç (Select)** tuşuna tıklanır.

<img src="https://mintcdn.com/apinizer/b92tyAv6JpTHUWXg/images/develop/izleme-analiz/trace-select.png?fit=max&auto=format&n=b92tyAv6JpTHUWXg&q=85&s=f39acde1d2d8152e5255562a0d537fe3" alt="Seçme" width="800" data-path="images/develop/izleme-analiz/trace-select.png" />

Tabloda bir satıra tıkladığınızda veya satır menüsünden **Seç** ile aynı kaydı seçtiğinizde, ekranın **sağından trace detay çekmecesi** açılır (geniş çekmece; dar ekranlarda yatay kaydırma kullanılabilir). Başlıkta **HTTP metodu** (renkli rozet), **yol**, **HTTP durum kodu** ve **sonuç türü** (ör. SUCCESS) görünür; çekmeyi kapatmak için **X** kullanılır.

## Zaman ve Akış

#### Zaman dağılımı (timing breakdown)

Toplam süre (ms) ve bileşenlere göre renkli çubuk gösterilir. Çubukta yalnızca süresi sıfırdan büyük olan segmentler listelenir; örnek etiketler: **Request Parse**, **Request Policies**, **Routing**, **Response Policies**, **Response Serialize**. Segment üzerinde fareyle süre bilgisini görebilirsiniz.

#### İşlem haritası (Client → Gateway → API)

* **‹ Back** / **Next ›** ile adımlar arasında sırayla gezersiniz; sıra: **Client** → ağ geçidi giriş düğümü → **istek politikaları** (soldan sağa) → ağ geçidi çıkış düğümü → **API (hedef)** → hedeften dönüş düğümü → **yanıt politikaları** → istemciye çıkış düğümü.
* Haritadaki bir **düğüme tıklayarak** doğrudan o adımın detaylarına gidebilirsiniz.
* Başarılı adımlarda yeşil onay, hata veya blokta **!** göstergesi kullanılır.
* **Atlanan (skipped)** politikalar soluk görünür; üzerinde **S** rozeti ve ipucunda atlanma nedeni yer alır.

***

### Alt panel: seçili adıma göre içerik

Seçtiğiniz düğüme göre panel tek veya iki sütun olur; bölümler **akordeon** ile açılıp kapanır (tablolarda **Name** / **Value** sütunları). Gövde JSON ise salt okunur düzenleyicide gösterilir.

### Client (istemci)

Solda istemciden gelen istek (**HTTP Info**, **Request Headers**, **Request Parameters**, **Request Body**), sağda istemciye giden yanıt (**Response Headers**, **Response Body**).

<img src="https://mintcdn.com/apinizer/WZR0m-u7Czbvjywf/images/develop/izleme-analiz/trace-drawer-step-client.png?fit=max&auto=format&n=WZR0m-u7Czbvjywf&q=85&s=bd9a0add8f1cf7454dc31b956c341063" alt="Trace çekmecesi: Client adımı, istek ve yanıt sütunları" width="1000" style={{ maxWidth: '1000px', width: '100%', height: 'auto' }} data-path="images/develop/izleme-analiz/trace-drawer-step-client.png" />

<div style={{ marginTop: '2.5rem' }} aria-hidden="true" />

### Gateway'e giriş (istek ağ geçidine alındı)

Özet satırında istek satırı, API adı, endpoint, istemci IP, sunucu adı/port, protokol ve **Correlation ID** bulunur; altında istek başlıkları ve parametreler.

<img src="https://mintcdn.com/apinizer/WZR0m-u7Czbvjywf/images/develop/izleme-analiz/trace-drawer-step-gateway-ingress.png?fit=max&auto=format&n=WZR0m-u7Czbvjywf&q=85&s=13307739657a5a9de9181a30596706cf" alt="Trace çekmecesi: ağ geçidi giriş adımı ve özet bilgiler" width="1000" style={{ maxWidth: '1000px', width: '100%', height: 'auto' }} data-path="images/develop/izleme-analiz/trace-drawer-step-gateway-ingress.png" />

### İstek politikası

Üstte yürütme bilgisi — **Policy**, **Result**, **Duration**, **Order**, **Level**, **Mode**; atlandıysa **Skip reason**. Çalıştıysa solda **Before - Headers / Parameters / Body**, sağda **After - Headers / Parameters / Body** ile politika öncesi ve sonrası karşılaştırılır.

<img src="https://mintcdn.com/apinizer/WZR0m-u7Czbvjywf/images/develop/izleme-analiz/trace-drawer-step-policy-api-call.png?fit=max&auto=format&n=WZR0m-u7Czbvjywf&q=85&s=d59becfa03a9d836edc8a8638e4f8636" alt="Trace çekmecesi: politika adımı, Before ve After panelleri" width="1000" style={{ maxWidth: '1000px', width: '100%', height: 'auto' }} data-path="images/develop/izleme-analiz/trace-drawer-step-policy-api-call.png" />

<img src="https://mintcdn.com/apinizer/WZR0m-u7Czbvjywf/images/develop/izleme-analiz/trace-drawer-step-policy-request-pipeline.png?fit=max&auto=format&n=WZR0m-u7Czbvjywf&q=85&s=90c6a3e99477b7065c3f4be6860c4916" alt="Trace çekmecesi: istek hattında başka bir politika adımı" width="1000" style={{ maxWidth: '1000px', width: '100%', height: 'auto' }} data-path="images/develop/izleme-analiz/trace-drawer-step-policy-request-pipeline.png" />

### Hedefe giden istek (routing öncesi çıkış)

Backend'e yönlendirme yapılmadıysa bilgilendirme mesajı gösterilir. Yönlendirme varsa **Target URL**, **Connection Type**, **HTTP Method** özeti görünür. Bu adımda **Routing** akordeonunda yönlendirme tablosu listelenir; satırı genişleterek istek/yanıt üst bilgileri ve gövdelerini inceleyebilirsiniz; satırdaki **kod** ikonu ilgili yönlendirme kaydını JSON olarak açar. Yönlendirme seçenekleri için bkz. [HTTP yönlendirme](/tr/develop/yonlendirme/http-yonlendirme).

<img src="https://mintcdn.com/apinizer/WZR0m-u7Czbvjywf/images/develop/izleme-analiz/trace-drawer-step-routing-table.png?fit=max&auto=format&n=WZR0m-u7Czbvjywf&q=85&s=da93eacb09fbc76314a9f6d41aa46e22" alt="Trace çekmecesi: Routing tablosu ve genişletilmiş satır" width="1000" style={{ maxWidth: '1000px', width: '100%', height: 'auto' }} data-path="images/develop/izleme-analiz/trace-drawer-step-routing-table.png" />

### Backend hedef (API)

Hedefe istek gidemediyse açıklayıcı mesaj; gittiyse **Target Info** tablosunda URL, durum kodu, sonuç, süre, bağlantı durumu gibi alanlar.

<img src="https://mintcdn.com/apinizer/WZR0m-u7Czbvjywf/images/develop/izleme-analiz/trace-drawer-step-target-backend.png?fit=max&auto=format&n=WZR0m-u7Czbvjywf&q=85&s=7372e9b75889a54474e09a95ebe487f8" alt="Trace çekmecesi: Backend hedef özeti" width="1000" style={{ maxWidth: '1000px', width: '100%', height: 'auto' }} data-path="images/develop/izleme-analiz/trace-drawer-step-target-backend.png" />

### Hedeften gelen yanıt

Durum özeti ve **Response Headers** / **Response Body**.

<img src="https://mintcdn.com/apinizer/WZR0m-u7Czbvjywf/images/develop/izleme-analiz/trace-drawer-step-response-from-target.png?fit=max&auto=format&n=WZR0m-u7Czbvjywf&q=85&s=b072ae28ba4ccefc746f90c56d10f2bb" alt="Trace çekmecesi: hedeften gelen yanıt" width="1000" style={{ maxWidth: '1000px', width: '100%', height: 'auto' }} data-path="images/develop/izleme-analiz/trace-drawer-step-response-from-target.png" />

### İstemciye gönderilen yanıt

Durum kodu, sonuç, toplam süre ve istek işleme / yönlendirme / yanıt serileştirme süreleri; **Response Headers** ve **Response Body**.

<img src="https://mintcdn.com/apinizer/WZR0m-u7Czbvjywf/images/develop/izleme-analiz/trace-drawer-step-response-to-client.png?fit=max&auto=format&n=WZR0m-u7Czbvjywf&q=85&s=b1669b3139289314589184bdb2cbb4c3" alt="Trace çekmecesi: istemciye giden yanıt ve süre özeti" width="1000" style={{ maxWidth: '1000px', width: '100%', height: 'auto' }} data-path="images/develop/izleme-analiz/trace-drawer-step-response-to-client.png" />

## Trace loglarını silme

Tablo başlığındaki **çöp kutusu** ile o API Proxy için tutulan trace loglarını toplu silebilirsiniz; onay diyalogunda işlemi doğrulamanız istenir.

## Ortam uyarısı

Seçili API Proxy hiçbir ortamda yüklü değilse tam ekran uyarı gösterilir; trace başlatmadan önce **en az bir ortama** yükleme yapmanız gerekir.
