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)
라이선스
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
spakky_tracing-6.10.0.tar.gz
(4.9 kB
view details)
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.10.0.tar.gz.
File metadata
- Download URL: spakky_tracing-6.10.0.tar.gz
- Upload date:
- Size: 4.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
25f39be01bd9fb3df68be1ef9e500083b95df59f6c7e226360be32f16b466261
|
|
| MD5 |
608d3fe0ffbea6d43a5d9790f2f21f30
|
|
| BLAKE2b-256 |
7124675ca5f28a06594cdc772c4dbf58498e7dc11cef88c0edba1fded1dcc5c8
|
Provenance
The following attestation bundles were made for spakky_tracing-6.10.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.10.0.tar.gz -
Subject digest:
25f39be01bd9fb3df68be1ef9e500083b95df59f6c7e226360be32f16b466261 - Sigstore transparency entry: 1955642182
- Sigstore integration time:
-
Permalink:
E5presso/spakky-framework@11ace5de03ddf270b90f2c7cbcb1b81aae7e91cb -
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@11ace5de03ddf270b90f2c7cbcb1b81aae7e91cb -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file spakky_tracing-6.10.0-py3-none-any.whl.
File metadata
- Download URL: spakky_tracing-6.10.0-py3-none-any.whl
- Upload date:
- Size: 7.3 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 |
8f469bd76941f57cfe1bd7abefb4e78490b49c8920d01b259e782d0009e93efd
|
|
| MD5 |
310cf3d1f06f81430ece433f64ecc332
|
|
| BLAKE2b-256 |
e173d120dea1ef6ee4b268f345743ae5b2bbf1d82299e0d016f23ddf93b925d0
|
Provenance
The following attestation bundles were made for spakky_tracing-6.10.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.10.0-py3-none-any.whl -
Subject digest:
8f469bd76941f57cfe1bd7abefb4e78490b49c8920d01b259e782d0009e93efd - Sigstore transparency entry: 1955642252
- Sigstore integration time:
-
Permalink:
E5presso/spakky-framework@11ace5de03ddf270b90f2c7cbcb1b81aae7e91cb -
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@11ace5de03ddf270b90f2c7cbcb1b81aae7e91cb -
Trigger Event:
workflow_dispatch
-
Statement type:
