---
title: "Trace ID ve span ID farkı, gerçek bir traceparent başlığıyla"
description: "Trace ID, 1 isteği ulaştığı her hizmette adlandırır ve hiç değişmez. Span ID ise 1 adımı adlandırır, bu yüzden her hizmet yeni bir tane üretir."
canonical: "https://logbrew.co/tr/guides/trace-id"
last_updated: "2026-11-21"
---

# Trace ID ve span ID farkı, gerçek bir traceparent başlığıyla

Trace ID, 1 isteği ulaştığı her hizmette adlandırır ve hiç değişmez. Span ID ise 1 adımı adlandırır, bu yüzden her hizmet yeni bir tane üretir.

21 Kasım 2026 tarihinde Node.js 22.18.0, @logbrew/node 0.1.30, Python 3.13.9, FastAPI 0.165.0, uvicorn 0.54.0, logbrew-fastapi 0.1.14, curl 8.7.1 ve logbrew CLI 0.1.96 ile test edildi

[Furkan Erday](https://github.com/furkanerday) tarafından. Furkan Erday, LogBrew'un kurucusu. LogBrew'u her gün Claude Code ve Codex ile geliştiriyor.

Canonical: https://logbrew.co/tr/guides/trace-id

## Her traceparent başlığı trace'e ne yaptı

| curl'ün gönderdiği başlık | Trace ID korundu | İki log da aynı trace ID'yi taşıyor |
| --- | --- | --- |
| Geçerli, bayraklar `01` | Evet | Evet |
| Geçerli, bayraklar `00` | Evet | Evet |
| Büyük harfli trace ID | Evet, küçük harfle | Evet |
| Tamamı sıfır trace ID | Yeni trace | Evet |
| Sürüm `ff` | Yeni trace | Evet |
| Başlık yok | Yeni trace | Evet |

Bir FastAPI hizmetini çağıran Node.js hizmetine 6 istek, @logbrew/node 0.1.30 ve logbrew-fastapi 0.1.14 ile.

## traceparent başlığını çöz

### Başlığı tirelerden ayır

`traceparent`, `-` ile ayrılmış 4 küçük harfli hex alan taşır. Bunlar sürüm, trace ID, parent ID ve trace bayraklarıdır. curl'ün `checkout` hizmetimize gönderdiği başlık buydu.

Çıktı

```text
checkout got traceparent: 00-9095c7b7bf222836f82c2c415bc2bd65-fe8e70882fecdf07-01
```

### Sürümü oku

W3C Trace Context önerisindeki tek sürüm `00`, `ff` ise geçersiz. `ff` gönderdiğimizde iki SDK da başlığı yok saydı ve yeni bir trace başlattı.

### Trace ID'yi oku

Sonraki 32 karakter, hex olarak 16 baytlık trace ID'dir, yani `9095c7b7bf222836f82c2c415bc2bd65`. İsteğin tamamını adlandırır ve her hizmet onu değiştirmeden aktarır. Tamamı sıfır olan bir trace ID geçersiz.

### Parent ID'yi oku

Sonraki 16 karakter, hex olarak 8 baytlık parent ID'dir, yani `fe8e70882fecdf07`. Çağıranın span ID'sidir, bu yüzden her adımda değişir. Tamamı sıfır olan bir parent ID geçersiz.

### Trace bayraklarını oku

Son 2 karakter bayraklardır ve yalnızca 0. bitin anlamı var. `01`, çağıranın trace'i kaydetmiş olabileceğini söyler, `00` ise kaydetmediğini. `00` ile de iki SDK span'lerini gönderdi ve LogBrew trace'i gösterdi.

## Trace'i Node.js'ten Python'a aktar

### 2 SDK'yı kur

`checkout` hizmetimiz `@logbrew/node` ile Node.js'te çalışıyor. `logbrew-fastapi` kullanan bir FastAPI uygulaması olan `payments`'ı çağırıyor. İkisinde de LogBrew projenin bir sunucu anahtarını kullan.

```bash
npm install @logbrew/sdk @logbrew/node
python3 -m pip install logbrew-sdk logbrew-fastapi
```

### Node.js sunucusunu ve çağrısını sar

`withLogBrewHttpHandler()`, her istekten `traceparent`'ı okur ve bir span başlatır. `fetchWithLogBrewSpan()`, çağrı için bir alt span başlatır ve o span'in ID'siyle yeni bir `traceparent` yazar. Sarmalayıcı anahtarı `LOGBREW_SERVER_API_KEY` değişkeninden okur.

```bash
import { createServer } from "node:http";
import { fetchWithLogBrewSpan, withLogBrewHttpHandler } from "@logbrew/node";

const server = createServer(withLogBrewHttpHandler(async (req, res, logbrew) => {
  logbrew.client.log(`evt_checkout_${Date.now()}`, new Date().toISOString(), {
    message: "checkout started for order 1042",
    level: "info",
    logger: "checkout"
  });
  const reply = await fetchWithLogBrewSpan("http://127.0.0.1:28702/payments/1042", {
    method: "POST"
  }, {
    client: logbrew.client,
    trace: logbrew.trace,
    routeTemplate: "/payments/:orderId"
  });
  res.writeHead(reply.status, { "content-type": "application/json" });
  res.end(await reply.text());
}));

server.listen(28701, "127.0.0.1");
```

### LogBrew'u FastAPI uygulamasına ekle

`init_logbrew()`, her istekten `traceparent`'ı okur ve bir alt span başlatır. `logbrew.logging_handler`, her log kaydına isteğin trace ID'sini ve span ID'sini ekler.

```bash
import logging
import os

from fastapi import FastAPI
from logbrew_fastapi import init_logbrew

app = FastAPI()
logbrew = init_logbrew(
    app, api_key=os.environ["LOGBREW_SERVER_API_KEY"], service_name="payments"
)
logger = logging.getLogger("payments")
logger.setLevel(logging.INFO)
logger.addHandler(logbrew.logging_handler)


@app.post("/payments/{order_id}")
def authorize(order_id: str):
    logger.warning("card declined for order %s", order_id)
    return {"orderId": order_id, "status": "declined"}
```

## Bir log satırının trace'ini bul

### İki hizmetten de geçen 1 istek gönder

curl bir `traceparent` gönderdi, tıpkı `checkout`'un önündeki bir tarayıcı ya da gateway'in yapabileceği gibi. Başlık yoksa `checkout` yeni bir trace başlatır.

```bash
curl -X POST http://127.0.0.1:28701/checkout \
  -H 'traceparent: 00-9095c7b7bf222836f82c2c415bc2bd65-fe8e70882fecdf07-01'
```

Çıktı

```text
{"orderId":"1042","status":"declined"}
```

### Her adımdaki başlığı karşılaştır

Başlığı her hizmette yazdırdık. `checkout` trace ID'yi korudu ve parent ID'ye çağrı span'inin ID'sini, `1a95bcb4e3fcb3ce`'yi yazdı. `payments` bu başlığı okudu ve altında `bc7e3f490d4a4d00` span'ini başlattı.

Çıktı

```text
checkout got traceparent: 00-9095c7b7bf222836f82c2c415bc2bd65-fe8e70882fecdf07-01
checkout sent traceparent: 00-9095c7b7bf222836f82c2c415bc2bd65-1a95bcb4e3fcb3ce-01
payments got traceparent: 00-9095c7b7bf222836f82c2c415bc2bd65-1a95bcb4e3fcb3ce-01
```

### Trace'in tüm loglarını bul

Herhangi bir log satırından trace ID'yi kopyala ve `--trace`'e ver. CLI her hizmetin logunu döndürdü. Panelde trace ID'yi Loglar'daki arama kutusuna yapıştır.

```bash
logbrew read logs --project "<project_id>" --trace 9095c7b7bf222836f82c2c415bc2bd65
```

Çıktı

```text
Logs (2)
- warning card declined for order 1042 service=payments trace=9095c7b7bf222836f82c2c415bc2bd65 [unversioned / production]
- info checkout started for order 1042 service=checkout trace=9095c7b7bf222836f82c2c415bc2bd65 [unversioned / production]
```

### Trace'i aç

Trace'te 3 span var, 2'si `checkout`'tan, 1'i `payments`'tan. Panelde trace ID'yi Keşfet'teki arama kutusuna yapıştır, sonra trace'i aç.

```bash
logbrew read trace 9095c7b7bf222836f82c2c415bc2bd65 --project "<project_id>"
```

Çıktı

```text
Trace 9095c7b7bf222836f82c2c415bc2bd65 spans=3 [unversioned / production]
- POST /payments/{order_id}
- POST /payments/:orderId
- POST /checkout
```

## Test ederken ne gördük

`checkout`'u Node.js 22.18 ve @logbrew/node 0.1.30 ile, `payments`'ı Python 3.13.9, FastAPI 0.165.0, uvicorn 0.54.0 ve logbrew-fastapi 0.1.14 ile çalıştırdık. İkisi de yerel bir LogBrew sunucusuna gönderdi. curl `checkout`'a 6 istek gönderdi. 5'i farklı birer `traceparent` taşıdı, 1'i başlıksızdı.

Her istekte iki hizmetin logları da aynı trace ID'yi taşıdı. Başlık geçerliyse bu, curl'ün gönderdiği trace ID'ydi. Başlık geçersizse ya da yoksa `checkout` yeni bir trace başlattı ve onu aktardı.

|  | `span_id` | `parent_span_id` |
| --- | --- | --- |
| `checkout` isteği | `5569d78d6d163d95` | `fe8e70882fecdf07` |
| `checkout`'tan `payments`'a çağrı | `1a95bcb4e3fcb3ce` | `5569d78d6d163d95` |
| `payments` isteği | `bc7e3f490d4a4d00` | `1a95bcb4e3fcb3ce` |

- `checkout`
  - `level`: `info`
  - Mesaj: `checkout started for order 1042`
  - `trace_id`: `9095c7b7bf222836f82c2c415bc2bd65`
  - `span_id`: `5569d78d6d163d95`
- `payments`
  - `level`: `warning`
  - Mesaj: `card declined for order 1042`
  - `trace_id`: `9095c7b7bf222836f82c2c415bc2bd65`
  - `span_id`: `bc7e3f490d4a4d00`

## Trace ID ve span ID farkı

Trace ID 16 bayttır ve 32 hex karakterle yazılır. Span ID 8 bayttır ve 16 karakterle yazılır. OpenTelemetry trace API spesifikasyonu, bir ID'yi yalnızca en az 1 baytı sıfır değilse geçerli sayar ve ikisini de küçük harfli hex ile yazar.

OpenTelemetry'de bir span bağlamı trace ID'yi, span ID'yi, trace bayraklarını ve trace durumunu tutar. `traceparent` ilk 3'ünü taşır. Trace durumunu, en fazla 32 sağlayıcı girdisinden oluşan bir listeyi, `tracestate` başlığı taşır. İki LogBrew SDK'sı da `tracestate` yazmaz.

|  | Trace ID | Span ID |
| --- | --- | --- |
| Hex karakter | `32` | `16` |
| Her adımda aynı | Evet | Hayır |
| Tamamı sıfırsa geçerli | Hayır | Hayır |

## Başlık hatalıysa

Öneri yalnızca küçük harfli hex'e izin verir, `ff` sürümünü ve tamamı sıfır olan ID'leri yasaklar. Böyle bir başlık alan hizmet onu yok saymalı ve yeni bir trace başlatmalı. İki SDK da bunu `ff` için ve tamamı sıfır olan trace ID ile parent ID için yaptı.

İki SDK da büyük harfli bir trace ID'yi kabul etti ve küçük harfle aktardı. Küçük harf gönder, çünkü katı bir hizmet bunun yerine yeni bir trace başlatır.

Başlık yokken `checkout` `01` bayraklı, `payments` ise `00` bayraklı bir trace başlattı. LogBrew iki trace'i de sakladı.

| Trace ID korundu | `@logbrew/node` | `logbrew-fastapi` |
| --- | --- | --- |
| Büyük harfli trace ID | Evet | Evet |
| Sürüm `ff` | Hayır | Hayır |
| Tamamı sıfır trace ID | Hayır | Hayır |
| Tamamı sıfır parent ID | Hayır | Hayır |

## Sık sorulan sorular

### Trace ID nedir?

Trace ID, 32 küçük harfli hex karakterle yazılan 16 baytlık bir ID'dir. 1 isteği, isteğin ulaştığı her hizmette adlandırır. Her hizmet onu `traceparent` başlığıyla aktarır.

### Trace ID ile span ID arasındaki fark nedir?

Trace ID, 1 isteğin geçtiği her hizmette aynıdır. Span ID, 1 hizmetteki 1 adımı adlandırır. İsteğimiz 1 trace ID ve 3 span ID aldı.

### traceparent başlığı nedir?

`traceparent`, W3C Trace Context önerisinin HTTP başlığıdır. Sürümü, trace ID'yi, çağıranın span ID'sini ve trace bayraklarını taşır, örneğin `00-9095c7b7bf222836f82c2c415bc2bd65-1a95bcb4e3fcb3ce-01`.

### traceparent'ın sonundaki 01 ne demek?

`01`, sampled bayrağını açar, yani çağıran trace'i kaydetmiş olabilir. `00` kaydetmediğini söyler. İki LogBrew SDK'sı da iki değeri de aktardı ve LogBrew trace'i sakladı.

### Aynı trace ID'ye sahip tüm logları nasıl bulurum?

`logbrew read logs --project "<project_id>" --trace <trace_id>` komutunu çalıştır ya da trace ID'yi LogBrew panelinde Loglar'daki arama kutusuna yapıştır. SDK'ların bir istek sırasında yazdığı her log o isteğin trace ID'sini taşır.

### traceparent başlığı büyük-küçük harfe duyarlı mı?

Evet. Öneri yalnızca küçük harfli hex'e izin verir. İki LogBrew SDK'sı da büyük harfli bir trace ID'yi kabul edip küçük harfe çevirdi, ama katı bir hizmet başlığı yok sayar.

## Bir trace'in tüm loglarını 1 aramayla bul

Node.js ve FastAPI için LogBrew SDK'ları `traceparent`'ı okur ve gönderir, her log da isteğinin trace ID'sini saklar. Cömert ücretsiz planla başla, kart gerekmez.

[Ücretsiz başla](https://logbrew.co/tr)

## Kaynaklar

- [W3C Recommendation, Trace Context, 3.2 Traceparent Header](https://www.w3.org/TR/trace-context/#traceparent-header)
- [W3C Recommendation, Trace Context, 4.3 A traceparent is received](https://www.w3.org/TR/trace-context/#a-traceparent-is-received)
- [@logbrew/node on npm](https://www.npmjs.com/package/@logbrew/node)
- [LogBrewCo/sdk, logbrew-fastapi README](https://github.com/LogBrewCo/sdk/blob/main/python/logbrew_fastapi/README.md)

## Ajanlar, Python, Node.js ve React için diğer rehberler

- [Claude Code ve Codex'e MCP sunucusu ekle](https://logbrew.co/tr/guides/mcp-server-claude-code-codex)
- [Claude Code ve Codex'te AGENTS.md kullan](https://logbrew.co/tr/guides/agents-md)
- [Claude overloaded 529 ve rate limit 429 hatalarını çöz](https://logbrew.co/tr/guides/claude-overloaded-rate-limit-error)
- [Python logging'i doğru log seviyeleri ve istisna yakalamayla kur](https://logbrew.co/tr/guides/python-logging)
- [Structured logging ile alana göre arayabileceğin log formatı ve log seviyeleri](https://logbrew.co/tr/guides/structured-logging)
- [Node.js loglamayı Pino ya da Winston ile kur ve hiçbir hatayı kaçırma](https://logbrew.co/tr/guides/node-logging)
- [Django loglamayı kur ve her 500 hatasının stack trace'ini sakla](https://logbrew.co/tr/guides/django-logging)
- [FastAPI loglamayı kur ve hataları yönet stack trace'i kaybetmeden](https://logbrew.co/tr/guides/fastapi-logging)
- [React'te bir error boundary ekle ve onun kaçırdığı hataları logla](https://logbrew.co/tr/guides/react-error-boundary)
- [Hata, log, trace, metrik ve sürüm rehberleri](https://logbrew.co/tr/guides)
