---
title: "Trace ID vs span ID, diurai dari header traceparent sungguhan"
description: "Trace ID menamai 1 permintaan di setiap layanan yang dilaluinya, dan nilainya tetap. Span ID menamai 1 langkah, jadi setiap layanan membuat yang baru."
canonical: "https://logbrew.co/id/guides/trace-id"
last_updated: "2026-11-21"
---

# Trace ID vs span ID, diurai dari header traceparent sungguhan

Trace ID menamai 1 permintaan di setiap layanan yang dilaluinya, dan nilainya tetap. Span ID menamai 1 langkah, jadi setiap layanan membuat yang baru.

Diuji pada 21 November 2026 dengan 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, dan logbrew CLI 0.1.96

Oleh [Furkan Erday](https://github.com/furkanerday). Furkan Erday adalah pendiri LogBrew. Setiap hari ia membangun LogBrew dengan Claude Code dan Codex.

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

## Apa yang dilakukan tiap header traceparent pada trace

| Header yang dikirim curl | Trace ID tetap | Kedua log berbagi 1 trace ID |
| --- | --- | --- |
| Valid, flag `01` | Ya | Ya |
| Valid, flag `00` | Ya | Ya |
| Trace ID huruf besar | Ya, jadi huruf kecil | Ya |
| Trace ID serba nol | Trace baru | Ya |
| Versi `ff` | Trace baru | Ya |
| Tanpa header | Trace baru | Ya |

6 permintaan ke layanan Node.js yang memanggil layanan FastAPI, dengan @logbrew/node 0.1.30 dan logbrew-fastapi 0.1.14.

## Urai header traceparent

### Pisahkan header di tanda hubung

`traceparent` berisi 4 field hex huruf kecil, dipisah `-`. Isinya versi, trace ID, parent ID, dan flag trace. Ini header yang dikirim curl ke layanan `checkout` kami.

Output

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

### Baca versinya

`00` adalah satu-satunya versi di Rekomendasi W3C Trace Context, dan `ff` tidak valid. Saat kami mengirim `ff`, kedua SDK mengabaikan header dan memulai trace baru.

### Baca trace ID

32 karakter berikutnya adalah trace ID `9095c7b7bf222836f82c2c415bc2bd65`, 16 byte dalam hex. Nilai ini menamai seluruh permintaan, dan setiap layanan meneruskannya tanpa diubah. Trace ID serba nol tidak valid.

### Baca parent ID

16 karakter berikutnya adalah parent ID `fe8e70882fecdf07`, 8 byte dalam hex. Ini span ID dari span pemanggil, jadi nilainya berubah di setiap hop. Parent ID serba nol tidak valid.

### Baca flag trace

2 karakter terakhir adalah flag, dan hanya bit 0 yang punya arti. `01` berarti pemanggil mungkin sudah merekam trace, dan `00` berarti tidak. Dengan `00`, kedua SDK tetap mengirim span-nya, dan LogBrew tetap menampilkan trace.

## Teruskan trace dari Node.js ke Python

### Instal 2 SDK

Layanan `checkout` kami berjalan di Node.js dengan `@logbrew/node`. Layanan ini memanggil `payments`, aplikasi FastAPI dengan `logbrew-fastapi`. Pakai server key dari proyek LogBrew kamu di masing-masing layanan.

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

### Bungkus server Node.js dan panggilannya

`withLogBrewHttpHandler()` membaca `traceparent` dari setiap permintaan dan memulai span. `fetchWithLogBrewSpan()` memulai child span untuk panggilan itu dan menulis `traceparent` baru dengan ID span tersebut. Wrapper membaca key dari `LOGBREW_SERVER_API_KEY`.

```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");
```

### Tambahkan LogBrew ke aplikasi FastAPI

`init_logbrew()` membaca `traceparent` dari setiap permintaan dan memulai child span. `logbrew.logging_handler` menambahkan trace ID dan span ID permintaan ke setiap record log.

```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"}
```

## Temukan trace dari satu baris log

### Kirim 1 permintaan melewati kedua layanan

curl mengirim `traceparent`, seperti yang bisa dilakukan browser atau gateway di depan `checkout`. Tanpa header itu, `checkout` memulai trace baru.

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

Output

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

### Bandingkan header di setiap hop

Kami mencetak header di setiap layanan. `checkout` mempertahankan trace ID dan mengisi parent ID dengan ID span panggilannya, `1a95bcb4e3fcb3ce`. `payments` membaca header itu dan memulai span `bc7e3f490d4a4d00` di bawahnya.

Output

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

### Temukan semua log dari trace

Salin trace ID dari baris log mana pun dan berikan ke `--trace`. CLI mengembalikan log dari setiap layanan. Di dasbor, tempel trace ID ke kotak pencarian Log.

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

Output

```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]
```

### Buka trace

Trace ini berisi 3 span, 2 dari `checkout` dan 1 dari `payments`. Di dasbor, tempel trace ID ke kotak pencarian Jelajahi, lalu buka trace-nya.

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

Output

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

## Apa yang kami lihat saat menguji

Kami menjalankan `checkout` di Node.js 22.18 dengan @logbrew/node 0.1.30, dan `payments` di Python 3.13.9 dengan FastAPI 0.165.0, uvicorn 0.54.0, dan logbrew-fastapi 0.1.14. Keduanya mengirim ke server LogBrew lokal. curl mengirim 6 permintaan ke `checkout`, 5 dengan `traceparent` yang berbeda-beda dan 1 tanpa header.

Di setiap permintaan, log kedua layanan berbagi 1 trace ID. Saat header valid, itu trace ID yang dikirim curl. Saat header tidak valid atau tidak ada, `checkout` memulai trace baru dan meneruskannya.

|  | `span_id` | `parent_span_id` |
| --- | --- | --- |
| Permintaan ke `checkout` | `5569d78d6d163d95` | `fe8e70882fecdf07` |
| Panggilan `checkout` ke `payments` | `1a95bcb4e3fcb3ce` | `5569d78d6d163d95` |
| Permintaan ke `payments` | `bc7e3f490d4a4d00` | `1a95bcb4e3fcb3ce` |

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

## Trace ID vs span ID

Trace ID berukuran 16 byte, ditulis sebagai 32 karakter hex. Span ID berukuran 8 byte, ditulis sebagai 16 karakter. Spesifikasi trace API OpenTelemetry hanya menganggap ID valid jika minimal 1 byte bukan nol, dan menulis keduanya dalam hex huruf kecil.

Di OpenTelemetry, span context berisi trace ID, span ID, flag trace, dan trace state. `traceparent` membawa 3 yang pertama. Header `tracestate` membawa trace state, yaitu daftar berisi hingga 32 entri vendor. Kedua SDK LogBrew tidak menulis `tracestate`.

|  | Trace ID | Span ID |
| --- | --- | --- |
| Karakter hex | `32` | `16` |
| Sama di setiap hop | Ya | Tidak |
| Valid jika serba nol | Tidak | Tidak |

## Saat header salah

Rekomendasi itu hanya mengizinkan hex huruf kecil, dan melarang versi `ff` serta ID serba nol. Layanan yang menerima header seperti itu harus mengabaikannya dan memulai trace baru. Kedua SDK melakukan itu untuk `ff` dan untuk trace ID atau parent ID serba nol.

Kedua SDK menerima trace ID huruf besar dan meneruskannya dalam huruf kecil. Kirim huruf kecil, karena layanan yang ketat akan memulai trace baru.

Tanpa header, `checkout` memulai trace dengan flag `01`, dan `payments` memulai trace dengan `00`. LogBrew menyimpan kedua trace.

| Trace ID tetap | `@logbrew/node` | `logbrew-fastapi` |
| --- | --- | --- |
| Trace ID huruf besar | Ya | Ya |
| Versi `ff` | Tidak | Tidak |
| Trace ID serba nol | Tidak | Tidak |
| Parent ID serba nol | Tidak | Tidak |

## Pertanyaan yang sering diajukan

### Apa itu trace ID?

Trace ID adalah ID 16 byte, ditulis sebagai 32 karakter hex huruf kecil. ID ini menamai 1 permintaan di setiap layanan yang dilalui permintaan itu. Setiap layanan meneruskannya di header `traceparent`.

### Apa beda trace ID dan span ID?

Trace ID sama di setiap layanan dari 1 permintaan. Span ID menamai 1 langkah di 1 layanan. Permintaan kami punya 1 trace ID dan 3 span ID.

### Apa itu header traceparent?

`traceparent` adalah header HTTP dari Rekomendasi W3C Trace Context. Isinya versi, trace ID, span ID pemanggil, dan flag trace, seperti `00-9095c7b7bf222836f82c2c415bc2bd65-1a95bcb4e3fcb3ce-01`.

### Apa arti 01 di akhir traceparent?

`01` menyalakan flag sampled, jadi pemanggil mungkin sudah merekam trace. `00` berarti tidak. Kedua SDK LogBrew meneruskan kedua nilai itu, dan LogBrew menyimpan trace-nya.

### Bagaimana cara menemukan semua log dengan trace ID yang sama?

Jalankan `logbrew read logs --project "<project_id>" --trace <trace_id>`, atau tempel trace ID ke kotak pencarian Log di dasbor LogBrew. Setiap log yang ditulis SDK selama permintaan membawa trace ID permintaan itu.

### Apakah header traceparent peka huruf besar-kecil?

Ya. Rekomendasi itu hanya mengizinkan hex huruf kecil. Kedua SDK LogBrew menerima trace ID huruf besar dan mengubahnya ke huruf kecil, tetapi layanan yang ketat mengabaikan header itu.

## Temukan semua log dari satu trace dengan 1 pencarian

SDK LogBrew untuk Node.js dan FastAPI membaca dan mengirim `traceparent`, dan setiap log menyimpan trace ID dari permintaannya. Mulai dengan paket gratis yang lega, tanpa perlu kartu.

[Mulai gratis](https://logbrew.co/id)

## Sumber

- [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)

## Panduan lain untuk agen, Python, Node.js, dan React

- [Tambahkan server MCP ke Claude Code dan Codex](https://logbrew.co/id/guides/mcp-server-claude-code-codex)
- [Pakai AGENTS.md di Claude Code dan Codex](https://logbrew.co/id/guides/agents-md)
- [Atasi error Claude overloaded 529 dan rate limit 429](https://logbrew.co/id/guides/claude-overloaded-rate-limit-error)
- [Siapkan Python logging dengan level log yang tepat dan penangkapan exception](https://logbrew.co/id/guides/python-logging)
- [Logging terstruktur dengan format log dan level log yang bisa dicari per field](https://logbrew.co/id/guides/structured-logging)
- [Siapkan logging Node.js dengan Pino atau Winston tanpa kehilangan satu error pun](https://logbrew.co/id/guides/node-logging)
- [Setup logging Django dan simpan traceback tiap error 500](https://logbrew.co/id/guides/django-logging)
- [Setup logging FastAPI dan tangani error tanpa kehilangan traceback](https://logbrew.co/id/guides/fastapi-logging)
- [Tambahkan error boundary React dan catat error yang lolos darinya](https://logbrew.co/id/guides/react-error-boundary)
- [Panduan error, log, trace, metrik, dan rilis](https://logbrew.co/id/guides)
