| CARVIEW |
hs-opentelemetry-api: OpenTelemetry API for use by libraries for direct instrumentation or wrapper packages.
Please see the README on GitHub at https://github.com/iand675/hs-opentelemetry/tree/main/api#readme
[Skip to Readme]
Modules
[Index] [Quick Jump]
- OpenTelemetry
- OpenTelemetry.Attributes
- OpenTelemetry.Baggage
- OpenTelemetry.Common
- OpenTelemetry.Context
- Contrib
- OpenTelemetry.Environment
- OpenTelemetry.Exporter
- Internal
- OpenTelemetry.LogAttributes
- Logs
- OpenTelemetry.Processor
- OpenTelemetry.Propagator
- OpenTelemetry.Resource
- OpenTelemetry.Resource.Cloud
- OpenTelemetry.Resource.Container
- OpenTelemetry.Resource.DeploymentEnvironment
- OpenTelemetry.Resource.Device
- OpenTelemetry.Resource.FaaS
- OpenTelemetry.Resource.Host
- OpenTelemetry.Resource.Kubernetes
- OpenTelemetry.Resource.OperatingSystem
- OpenTelemetry.Resource.Process
- OpenTelemetry.Resource.Service
- OpenTelemetry.Resource.Telemetry
- OpenTelemetry.Resource.Webengine
- OpenTelemetry.SemanticsConfig
- Trace
- OpenTelemetry.Util
Downloads
- hs-opentelemetry-api-0.3.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
| Versions [RSS] | 0.0.1.0, 0.0.2.0, 0.0.3.0, 0.0.3.1, 0.0.3.2, 0.0.3.3, 0.0.3.4, 0.0.3.5, 0.0.3.6, 0.0.3.7, 0.0.3.8, 0.1.0.0, 0.2.0.0, 0.3.0.0 |
|---|---|
| Change log | ChangeLog.md |
| Dependencies | async, attoparsec, base (>=4.7 && <5), binary, bytestring, charset, clock, hashable, http-types, memory, mtl, regex-tdfa, safe-exceptions, template-haskell, text, thread-utils-context (>=0.3 && <0.4), transformers, unliftio-core, unordered-containers, vault, vector, vector-builder [details] |
| License | BSD-3-Clause |
| Copyright | 2024 Ian Duncan, Mercury Technologies |
| Author | Ian Duncan, Jade Lovelace |
| Maintainer | ian@iankduncan.com |
| Uploaded | by IanDuncan at 2025-10-07T20:40:41Z |
| Category | OpenTelemetry, Telemetry, Monitoring, Observability, Metrics |
| Home page | https://github.com/iand675/hs-opentelemetry#readme |
| Bug tracker | https://github.com/iand675/hs-opentelemetry/issues |
| Source repo | head: git clone https://github.com/iand675/hs-opentelemetry |
| Distributions | NixOS:0.3.0.0, Stackage:0.3.0.0 |
| Reverse Dependencies | 28 direct, 4 indirect [details] |
| Downloads | 1814 total (40 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating |
|
| Status | Docs available [build log] Last success reported on 2025-10-07 [all 1 reports] |
Readme for hs-opentelemetry-api-0.3.0.0
[back to package description]OpenTelemetry API for Haskell
This package provides an interface for instrumentors to use when instrumenting a library directly or implementing a wrapper API around an existing project.
The methods in this package can be safely called by libraries or end-user applications regardless of whether the application has registered an OpenTelemetry SDK configuration or not. When the OpenTelemetry SDK has not registered a tracer provider with any span processors, there API incurs minimal performance overhead, as most of the core interface performs no-ops.
In order to generate and export telemetry data, you will also need to use the OpenTelemetry Haskell SDK.
The inspiration of the OpenTelemetry project is to make every library and application observable out of the box by having them call the OpenTelemetry API directly. Until that happens, there is a need for a separate library which can inject this information. A library that enables observability for another library is called an instrumentation library. In the case of Haskell, instrumentation is currently entirely manual.
Visit the GitHub project for a list of provided instrumentation libraries.
Install Dependencies
Add hs-opentelemetry-api to your package.yaml or Cabal file.
Useful Links
- For more information on OpenTelemetry, visit: https://opentelemetry.io/
- For more about the Haskell OpenTelemetry project, visit: https://github.com/iand675/hs-opentelemetry