opentelemetry-lwt

Lwt-compatible instrumentation for https://opentelemetry.io
README

This project provides an API for instrumenting server software
using opentelemetry, as well as
connectors to talk to opentelemetry software such as jaeger.

  • library opentelemetry should be used to instrument your code
    and possibly libraries. It doesn't communicate with anything except
    a backend (default: dummy backend)

  • library opentelemetry-client-ocurl is a backend that communicates
    via http+protobuf with some collector (otelcol, datadog-agent, etc.)

Features

  • [x] basic traces

  • [x] basic metrics

  • [x] basic logs

  • [ ] nice API

  • [x] interface with lwt

  • [x] sync collector relying on ocurl

    • [x] batching, perf, etc.

  • [ ] async collector relying on ocurl-multi

  • [ ] interface with logs (carry context around)

Use

For now, instrument manually:

module Otel = Opentelemetry
let (let@) f x = f x

let foo () =
  let@ scope = Otel.Trace.with_  "foo"
      ~attrs:["hello", `String "world"] in
  do_work();
  Otel.Metrics.(
    emit [
      gauge ~name:"foo.x" [int 42];
    ]);
  do_more_work();
  ()

let main () =
  Otel.Globals.service_name := "my_service";
  Otel.GC_metrics.basic_setup();

  Opentelemetry_client_ocurl.with_setup () @@ fun () ->
  (* … *)
  foo ();
  (* … *)

Configuration

The library is configurable via Opentelemetry.Config, via the standard
opentelemetry env variables, or with some custom environment variables.

  • OTEL_EXPORTER_OTLP_ENDPOINT sets the http endpoint to send signals to

  • OTEL_OCAML_DEBUG=1 to print some debug messages from the opentelemetry library ide

  • OTEL_RESOURCE_ATTRIBUTES sets a comma separated list of custom resource attributes

Collector opentelemetry-client-ocurl

This is a synchronous collector that uses the http+protobuf format
to send signals (metrics, traces) to some other collector (eg. otelcol
or the datadog agent).

License

MIT

Semantic Conventions

Not supported yet.

Install
Published
10 Jun 2022
Sources
v0.2.tar.gz
md5=1b086b20ba4dfb2a2371ecdb6661e136
sha512=7a4e3a8c2f33a65faf472e9ba058e4925e019e7c9f5ae694902e525f762fa5ca98f02149e294a381c303e2f5213d79159d0bd9bd524684d460624b257dd90f4e
Dependencies
lwt
>= "5.3"
odoc
with-doc
opentelemetry
= version
ocaml
>= "4.08"
dune
>= "2.7"
Reverse Dependencies