eventuo11y: An event-oriented observability library

[ apache, library, observability ] [ Propose Tags ]

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 a Prometheus page, posting to OpenTelemetry) 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.Backend for documentation on writing an EventBackend.

See Example.hs for an example.

See eventuo11y-batteries for miscellaneous framework-specific helpers.

Downloads

Maintainer's Corner

Package maintainers

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.2.0 && <2.1), base (>=4.14 && <4.17), bytestring (>=0.10 && <0.12), exceptions (>=0.10 && <0.11), primitive (>=0.7 && <0.8), resourcet (>=1.2 && <1.3), text (>=1.2 && <2.1), time (>=1.9 && <1.12), unliftio-core (>=0.2 && <0.3), uuid (>=1.3 && <1.4) [details]
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-10-04T19:54:02Z
Distributions
Reverse Dependencies 4 direct, 0 indirect [details]
Downloads 595 total (35 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-10-04 [all 1 reports]