---
title: "ID śladu a ID spanu, rozłożone na prawdziwym nagłówku traceparent"
description: "ID śladu oznacza 1 żądanie w każdej usłudze, do której dociera, i się nie zmienia. ID spanu oznacza 1 krok, więc każda usługa tworzy nowe."
canonical: "https://logbrew.co/pl/guides/trace-id"
last_updated: "2026-11-21"
---

# ID śladu a ID spanu, rozłożone na prawdziwym nagłówku traceparent

ID śladu oznacza 1 żądanie w każdej usłudze, do której dociera, i się nie zmienia. ID spanu oznacza 1 krok, więc każda usługa tworzy nowe.

Przetestowane 21 listopada 2026 z użyciem 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 i logbrew CLI 0.1.96

Autor [Furkan Erday](https://github.com/furkanerday). Furkan Erday jest założycielem LogBrew. Codziennie rozwija LogBrew z pomocą Claude Code i Codex.

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

## Co każdy nagłówek traceparent zrobił ze śladem

| Nagłówek wysłany przez curl | ID śladu zostało | Oba logi mają 1 ID śladu |
| --- | --- | --- |
| Poprawny, flagi `01` | Tak | Tak |
| Poprawny, flagi `00` | Tak | Tak |
| ID śladu wielkimi literami | Tak, małymi literami | Tak |
| ID śladu z samych zer | Nowy ślad | Tak |
| Wersja `ff` | Nowy ślad | Tak |
| Brak nagłówka | Nowy ślad | Tak |

6 żądań do usługi Node.js, która wywołuje usługę FastAPI, z @logbrew/node 0.1.30 i logbrew-fastapi 0.1.14.

## Rozłóż nagłówek traceparent

### Podziel nagłówek na myślnikach

`traceparent` ma 4 pola w hex małymi literami, oddzielone `-`. To wersja, ID śladu, ID rodzica i flagi śladu. To nagłówek, który curl wysłał do naszej usługi `checkout`.

Wynik

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

### Odczytaj wersję

`00` to jedyna wersja w Rekomendacji W3C o kontekście śladu, a `ff` jest niepoprawna. Gdy wysłaliśmy `ff`, oba SDK zignorowały nagłówek i zaczęły nowy ślad.

### Odczytaj ID śladu

Kolejne 32 znaki to ID śladu `9095c7b7bf222836f82c2c415bc2bd65`, 16 bajtów w hex. Oznacza całe żądanie, a każda usługa przekazuje je bez zmian. ID śladu z samych zer jest niepoprawne.

### Odczytaj ID rodzica

Kolejne 16 znaków to ID rodzica `fe8e70882fecdf07`, 8 bajtów w hex. To ID spanu wywołującego, więc zmienia się na każdym przeskoku. ID rodzica z samych zer jest niepoprawne.

### Odczytaj flagi śladu

Ostatnie 2 znaki to flagi i tylko bit 0 ma znaczenie. `01` mówi, że wywołujący mógł zapisać ślad, a `00`, że tego nie zrobił. Przy `00` oba SDK i tak wysłały swoje spany, a LogBrew pokazał ślad.

## Przekaż ślad z Node.js do Pythona

### Zainstaluj 2 SDK

Nasza usługa `checkout` działa na Node.js z `@logbrew/node`. Wywołuje `payments`, aplikację FastAPI z `logbrew-fastapi`. W każdej użyj klucza serwera ze swojego projektu LogBrew.

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

### Opakuj serwer Node.js i jego wywołanie

`withLogBrewHttpHandler()` odczytuje `traceparent` z każdego żądania i zaczyna span. `fetchWithLogBrewSpan()` zaczyna span podrzędny dla wywołania i zapisuje nowy `traceparent` z ID tego spanu. Wrapper odczytuje klucz z `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");
```

### Dodaj LogBrew do aplikacji FastAPI

`init_logbrew()` odczytuje `traceparent` z każdego żądania i zaczyna span podrzędny. `logbrew.logging_handler` dodaje do każdego rekordu logu ID śladu i ID spanu żądania.

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

## Znajdź ślad linii logu

### Wyślij 1 żądanie przez obie usługi

curl wysłał `traceparent`, tak jak może to zrobić przeglądarka albo gateway przed `checkout`. Bez nagłówka `checkout` zaczyna nowy ślad.

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

Wynik

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

### Porównaj nagłówek na każdym przeskoku

Wypisaliśmy nagłówek w każdej usłudze. `checkout` zachował ID śladu i wpisał w ID rodzica ID swojego spanu wywołania, `1a95bcb4e3fcb3ce`. `payments` odczytał ten nagłówek i zaczął pod nim span `bc7e3f490d4a4d00`.

Wynik

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

### Znajdź wszystkie logi śladu

Skopiuj ID śladu z dowolnej linii logu i przekaż je do `--trace`. CLI zwróciło log każdej usługi. W panelu wklej ID śladu w pole wyszukiwania w Logach.

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

Wynik

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

### Otwórz ślad

Ślad ma 3 spany, 2 z `checkout` i 1 z `payments`. W panelu wklej ID śladu w pole wyszukiwania w Eksploruj, a potem otwórz ślad.

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

Wynik

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

## Co zobaczyliśmy w teście

Uruchomiliśmy `checkout` na Node.js 22.18 z @logbrew/node 0.1.30, a `payments` na Pythonie 3.13.9 z FastAPI 0.165.0, uvicorn 0.54.0 i logbrew-fastapi 0.1.14. Obie usługi wysyłały dane do lokalnego serwera LogBrew. curl wysłał 6 żądań do `checkout`, 5 z różnymi `traceparent` i 1 bez nagłówka.

W każdym żądaniu logi obu usług miały 1 wspólne ID śladu. Gdy nagłówek był poprawny, było to ID śladu wysłane przez curl. Gdy nagłówek był niepoprawny albo go brakowało, `checkout` zaczął nowy ślad i przekazał go dalej.

|  | `span_id` | `parent_span_id` |
| --- | --- | --- |
| Żądanie do `checkout` | `5569d78d6d163d95` | `fe8e70882fecdf07` |
| Wywołanie z `checkout` do `payments` | `1a95bcb4e3fcb3ce` | `5569d78d6d163d95` |
| Żądanie do `payments` | `bc7e3f490d4a4d00` | `1a95bcb4e3fcb3ce` |

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

## ID śladu a ID spanu

ID śladu ma 16 bajtów, zapisanych jako 32 znaki hex. ID spanu ma 8 bajtów, zapisanych jako 16 znaków. Specyfikacja API śladów OpenTelemetry uznaje ID za poprawne tylko wtedy, gdy co najmniej 1 bajt nie jest zerem, i zapisuje oba ID w hex małymi literami.

W OpenTelemetry kontekst spanu zawiera ID śladu, ID spanu, flagi śladu i stan śladu. `traceparent` niesie pierwsze 3. Nagłówek `tracestate` niesie stan śladu, czyli listę do 32 wpisów dostawców. Żadne z 2 SDK LogBrew nie zapisuje `tracestate`.

|  | ID śladu | ID spanu |
| --- | --- | --- |
| Znaki hex | `32` | `16` |
| Takie samo na każdym przeskoku | Tak | Nie |
| Poprawne, gdy same zera | Nie | Nie |

## Gdy nagłówek jest błędny

Rekomendacja dopuszcza tylko hex małymi literami i zabrania wersji `ff` oraz ID z samych zer. Usługa, która dostanie taki nagłówek, musi go zignorować i zacząć nowy ślad. Oba SDK zrobiły tak dla `ff` oraz dla ID śladu albo ID rodzica z samych zer.

Oba SDK przyjęły ID śladu wielkimi literami i przekazały je małymi. Wysyłaj małe litery, bo ścisła usługa zacznie zamiast tego nowy ślad.

Bez nagłówka `checkout` zaczął ślad z flagami `01`, a `payments` ślad z `00`. LogBrew zachował oba ślady.

| ID śladu zostało | `@logbrew/node` | `logbrew-fastapi` |
| --- | --- | --- |
| ID śladu wielkimi literami | Tak | Tak |
| Wersja `ff` | Nie | Nie |
| ID śladu z samych zer | Nie | Nie |
| ID rodzica z samych zer | Nie | Nie |

## Najczęściej zadawane pytania

### Co to jest ID śladu?

ID śladu to 16-bajtowe ID zapisane jako 32 znaki hex małymi literami. Oznacza 1 żądanie w każdej usłudze, do której to żądanie dociera. Każda usługa przekazuje je w nagłówku `traceparent`.

### Czym różni się ID śladu od ID spanu?

ID śladu jest takie samo w każdej usłudze 1 żądania. ID spanu oznacza 1 krok w 1 usłudze. Nasze żądanie dostało 1 ID śladu i 3 ID spanów.

### Co to jest nagłówek traceparent?

`traceparent` to nagłówek HTTP z Rekomendacji W3C o kontekście śladu. Zawiera wersję, ID śladu, ID spanu wywołującego i flagi śladu, na przykład `00-9095c7b7bf222836f82c2c415bc2bd65-1a95bcb4e3fcb3ce-01`.

### Co oznacza 01 na końcu traceparent?

`01` ustawia flagę sampled, więc wywołujący mógł zapisać ślad. `00` mówi, że tego nie zrobił. Oba SDK LogBrew przekazały obie wartości, a LogBrew zachował ślad.

### Jak znaleźć wszystkie logi z tym samym ID śladu?

Uruchom `logbrew read logs --project "<project_id>" --trace <trace_id>` albo wklej ID śladu w pole wyszukiwania w Logach w panelu LogBrew. Każdy log, który SDK zapisują podczas żądania, ma ID śladu tego żądania.

### Czy nagłówek traceparent rozróżnia wielkość liter?

Tak. Rekomendacja dopuszcza tylko hex małymi literami. Oba SDK LogBrew przyjęły ID śladu wielkimi literami i zamieniły je na małe, ale ścisła usługa ignoruje taki nagłówek.

## Znajdź wszystkie logi śladu 1 wyszukiwaniem

SDK LogBrew dla Node.js i FastAPI odczytują i wysyłają `traceparent`, a każdy log zachowuje ID śladu swojego żądania. Zacznij od hojnego darmowego planu, bez karty.

[Zacznij za darmo](https://logbrew.co/pl)

## Źródła

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

## Więcej przewodników po agentach, Pythonie, Node.js i React

- [Dodaj serwer MCP do Claude Code i Codex](https://logbrew.co/pl/guides/mcp-server-claude-code-codex)
- [Jak używać AGENTS.md w Claude Code i Codex](https://logbrew.co/pl/guides/agents-md)
- [Napraw błąd Claude 529 overloaded i błąd 429 rate limit](https://logbrew.co/pl/guides/claude-overloaded-rate-limit-error)
- [Skonfiguruj moduł Python logging z właściwymi poziomami i przechwytywaniem wyjątków](https://logbrew.co/pl/guides/python-logging)
- [Logowanie strukturalne z formatem logów i poziomami, które przeszukasz po polu](https://logbrew.co/pl/guides/structured-logging)
- [Skonfiguruj logowanie w Node.js z Pino lub Winston i nie zgub żadnego błędu](https://logbrew.co/pl/guides/node-logging)
- [Skonfiguruj logowanie w Django i zachowaj ślad stosu każdego błędu 500](https://logbrew.co/pl/guides/django-logging)
- [Skonfiguruj logowanie w FastAPI i obsłuż błędy bez utraty śladu stosu](https://logbrew.co/pl/guides/fastapi-logging)
- [Dodaj error boundary w React i loguj błędy, których nie łapie](https://logbrew.co/pl/guides/react-error-boundary)
- [Przewodniki po błędach, logach, śladach, metrykach i wydaniach](https://logbrew.co/pl/guides)
