🧳 Distributed Tracing: Baggage
Warning Automatic propagation through task-locals only supported in Swift >= 5.5
Baggage is a minimal (zero-dependency) context propagation container, intended to "carry" baggage items
for purposes of cross-cutting tools to be built on top of it.
See https://github.com/apple/swift-distributed-tracing for actual instrument types and implementations which can be used to deploy various cross-cutting instruments all reusing the same baggage type. More information can be found in the SSWG meeting notes.
In order to depend on this library you can use the Swift Package Manager, and add the following dependency to your
dependencies: [ .package( url: "https://github.com/apple/swift-distributed-tracing-baggage.git", from: "0.2.0" ) ]
and depend on the module in your target:
targets: [ .target( name: "MyAwesomeApp", dependencies: [ .product( name: "InstrumentationBaggage", package: "swift-distributed-tracing-baggage" ), ] ), // ... ]
Please refer to in-depth discussion and documentation in the Swift Distributed Tracing repository.
Please make sure to run the
./scripts/soundness.sh script when contributing, it checks formatting and similar things.
You can ensure it always runs and passes before you push by installing a pre-push hook with git:
echo './scripts/soundness.sh' > .git/hooks/pre-push chmod +x .git/hooks/pre-push