Spakky Tracing
Spakky Framework를 위한 분산 트레이싱 추상화입니다.
TraceContext와ITracePropagator로 HTTP, messaging, task boundary 사이의 trace metadata를 전달합니다.
설치
pip install spakky-tracing
주요 기능
TraceContext:contextvars를 지원하는 W3C Trace Context Level 2 호환 trace contextITracePropagator: service boundary를 넘는 trace context propagation용 abstract interfaceW3CTracePropagator: 내장 W3Ctraceparentheader propagator- Async-safe:
asynciotask별로 격리되는contextvars기반 context propagation - 외부 의존성 없음: 순수 Python 구현이며
spakkycore에만 의존
빠른 시작
TraceContext 생성과 전파
from spakky.tracing.context import TraceContext
# 새 root trace 시작
ctx = TraceContext.new_root()
TraceContext.set(ctx)
# 현재 trace 접근
current = TraceContext.get()
print(current.to_traceparent())
# 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01
# child span 생성
child = current.child()
TraceContext.set(child)
들어오는 trace header 파싱
from spakky.tracing.context import TraceContext
header = "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
ctx = TraceContext.from_traceparent(header)
W3CTracePropagator로 주입/추출
from spakky.tracing.w3c_propagator import W3CTracePropagator
propagator = W3CTracePropagator()
# 현재 trace를 outgoing header에 주입
carrier: dict[str, str] = {}
propagator.inject(carrier)
# carrier == {"traceparent": "00-...-...-01"}
# incoming header에서 trace 추출
ctx = propagator.extract(carrier)
개발 검증
패키지 단위 검증은 해당 패키지 디렉토리에서 실행합니다.
uv run ruff format .
uv run ruff check .
uv run pyrefly check
uv run pytest
pytest는 각 패키지 pyproject.toml의 coverage 설정을 사용합니다.
라이선스
MIT License
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file spakky_tracing-6.13.0.tar.gz.
File metadata
- Download URL: spakky_tracing-6.13.0.tar.gz
- Upload date:
- Size: 5.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2e693b2e974d5d7eace127f0507c8e9444d765c09d824c9cd2ba9e0621234d70
|
|
| MD5 |
c459c6e36ebc4aaeb400cb66f2ce9398
|
|
| BLAKE2b-256 |
64004b78336ca9c16983d34824e9af0c5f6df4e5a41a7abea9ea3ab521597cb4
|
Provenance
The following attestation bundles were made for spakky_tracing-6.13.0.tar.gz:
Publisher:
release.yml on E5presso/spakky-framework
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
spakky_tracing-6.13.0.tar.gz -
Subject digest:
2e693b2e974d5d7eace127f0507c8e9444d765c09d824c9cd2ba9e0621234d70 - Sigstore transparency entry: 1968032840
- Sigstore integration time:
-
Permalink:
E5presso/spakky-framework@a56e768557ee4c0b927ff45f029608fa573377e8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/E5presso
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@a56e768557ee4c0b927ff45f029608fa573377e8 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file spakky_tracing-6.13.0-py3-none-any.whl.
File metadata
- Download URL: spakky_tracing-6.13.0-py3-none-any.whl
- Upload date:
- Size: 7.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
82883968fd8475c5d8bacc7fe8868cfb7d86ee0933149eca14e9f49599e7f880
|
|
| MD5 |
8287ab55f055ab1e94b855c9e2b7c3b0
|
|
| BLAKE2b-256 |
2a99e372382b9f3cf703323978ee30142e53c1000507523846c29644fe3a794c
|
Provenance
The following attestation bundles were made for spakky_tracing-6.13.0-py3-none-any.whl:
Publisher:
release.yml on E5presso/spakky-framework
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
spakky_tracing-6.13.0-py3-none-any.whl -
Subject digest:
82883968fd8475c5d8bacc7fe8868cfb7d86ee0933149eca14e9f49599e7f880 - Sigstore transparency entry: 1968032981
- Sigstore integration time:
-
Permalink:
E5presso/spakky-framework@a56e768557ee4c0b927ff45f029608fa573377e8 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/E5presso
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@a56e768557ee4c0b927ff45f029608fa573377e8 -
Trigger Event:
workflow_dispatch
-
Statement type:
