eventuo11y: An event-oriented observability library
Instrument your Haskell codebase with wide, semantically meaningful events. This library is designed with separating the following concerns in mind:
Writing instrumentation
- When instrumenting code, I want to think in terms of my application domain and report any information I might need to infer internal application-level state and understand the behavior of my program/library.
Consuming instrumentation
- When consuming instrumentation, I want to think in
terms of the API fo the specific backend I'm supporting (writing to
stderr
, serving aPrometheus
page, posting toOpenTelemetry
) and what is needed to render to that API. Initializing instrumentation in an application
- When I'm ready to tie it all together, I want to identify the specific backends I want to post to and provide the bridge code to render the domain-specific instrumentation as needed for those backends. I also want to handle concerns like sampling or client-side aggregation of domain-specific instrumentation to keep usage manageable.
See Observe.Event for detailed documentation on instrumenting your code.
See Observe.Event.Implementation for documentation on writing an
EventBackend
.
See Example.hs for an example.
See eventuo11y-batteries for miscellaneous framework-specific helpers.
Modules
[Index] [Quick Jump]
Downloads
- eventuo11y-0.1.0.0.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
- No Candidates
Versions [RSS] | 0.1.0.0, 0.1.0.1, 0.2.0.0, 0.2.0.1, 0.3.0.0, 0.3.1.0, 0.3.2.0, 0.4.0.0, 0.5.0.0, 0.6.0.0, 0.7.0.0, 0.7.1.0, 0.8.0.0, 0.9.0.0, 0.9.0.1 (info) |
---|---|
Change log | CHANGELOG.md |
Dependencies | aeson (>=2.0.3.0 && <2.1), base (>=4.14 && <4.17), bytestring (>=0.10.12.0 && <0.12), exceptions (>=0.10.4 && <0.11), resourcet (>=1.2.4.3 && <1.3), text (>=1.2.5.0 && <1.3), time (>=1.9.3 && <1.12), unliftio-core (>=0.2.0.1 && <0.3), uuid (>=1.3.15 && <1.4) [details] |
Tested with | ghc ==8.10.7 || ==9.0.2 || ==9.2.2 |
License | Apache-2.0 |
Copyright | Copyright 2022 Shea Levy. |
Author | Shea Levy |
Maintainer | shea@shealevy.com |
Category | Observability |
Bug tracker | https://github.com/shlevy/eventuo11y/issues |
Source repo | head: git clone https://github.com/shlevy/eventuo11y |
Uploaded | by shlevy at 2022-09-28T19:59:58Z |
Distributions | |
Reverse Dependencies | 4 direct, 0 indirect [details] |
Downloads | 900 total (17 in the last 30 days) |
Rating | (no votes yet) [estimated by Bayesian average] |
Your Rating | |
Status | Docs available [build log] Last success reported on 2022-09-28 [all 1 reports] |