e11y: 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 in order 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 of 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.Backend for creating a new EventBackend
to consume instrumentation.
See Observe.Event.Backend.Data for an EventBackend
that represents the stream of events as
ordinary Haskell data.
See e11y-otel for an OpenTelemetry-based backend.
This is a rewrite of eventuo11y, designed to be easier to use, less intrusive, and not nearly as annoying to write/say. The name is a shortening of "event-based observability" (event-based -> e, observability -> o11y), and can be pronounced "eh-lee" or "ee-eleven-why".
Modules
[Index] [Quick Jump]
Downloads
- e11y-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 |
---|---|
Change log | CHANGELOG.md |
Dependencies | base (>=4.16 && <4.20), containers (>=0.6 && <0.8), general-allocate (>=0.2.3 && <0.3), parametric-functor (>=0.1.1 && <0.2), primitive (>=0.9 && <0.10), transformers (>=0.5 && <0.7) [details] |
Tested with | ghc ==9.2.8 || ==9.4.8 || ==9.6.4 || ==9.8.1 |
License | Apache-2.0 |
Copyright | Copyright 2024 Shea Levy Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. |
Author | Shea Levy |
Maintainer | shea@shealevy.com |
Category | Observability |
Home page | https://github.com/shlevy/e11y |
Bug tracker | https://github.com/shlevy/e11y/issues |
Source repo | head: git clone https://github.com/shlevy/e11y |
Uploaded | by shlevy at 2024-01-16T22:58:24Z |
Distributions | |
Reverse Dependencies | 1 direct, 0 indirect [details] |
Downloads | 63 total (1 in the last 30 days) |
Rating | (no votes yet) [estimated by Bayesian average] |
Your Rating | |
Status | Docs available [build log] Last success reported on 2024-01-16 [all 1 reports] |