Top 4.8% dependent repos on proxy.golang.org
proxy.golang.org : github.com/peterbourgon/trc
Package trc provides in-process request tracing, an efficient alternative to logging. The package is inspired by https://golang.org/x/net/trace, much gratitude to those authors. The basic idea is that applications should log not by sending events to a destination like stdout or a file on disk, but instead by adding events to a value retrieved from the context, known as a Trace. Traces are created for each operation processed by your application, e.g. every incoming HTTP request. Each trace is given a semantically meaningful category, and injected into the downstream context so applications can add events over the course of the operation. The trace is marked as finished when the operation completes. Collector collects traces into per-category ring buffers. Collected traces can be queried over HTTP via [trcweb.NewServer]. That interface is fairly rich, allowing traces to be selected by category, minimum duration, successful vs. errored, and so on. There are a few caveats. This approach is only suitable for applications that do their work in the context of a trace-related operation, and which reliably have access to a context value. Only the most recent traces are maintained, so long term historical data is not available. And, becase traces are maintained in memory, if a process crashes or restarts, all previous data is by default lost. Even with these caveats, in-process request tracing often provides a better user experience than traditional logging. The value of application telemetry tends to be highly correlated to age. A rich interface over just the most recent data can be surprisingly powerful. Most applications should not import this package directly, and should instead use github.com/peterbourgon/trc/eztrc, which provides an API specifically designed for common use cases.
Registry
-
Source
- Documentation
- JSON
purl: pkg:golang/github.com/peterbourgon/trc
License: Apache-2.0
Latest release: over 1 year ago
First release: almost 2 years ago
Namespace: github.com/peterbourgon
Dependent repositories: 1
Stars: 65 on GitHub
Forks: 1 on GitHub
See more repository details: repos.ecosyste.ms
Funding links: https://github.com/sponsors/peterbourgon
Last synced: 29 days ago