package opentelemetry-cohttp-lwt

  1. Overview
  2. Docs
Opentelemetry tracing for Cohttp HTTP servers

Install

Dune Dependency

Authors

Maintainers

Sources

v0.2.tar.gz
md5=1b086b20ba4dfb2a2371ecdb6661e136
sha512=7a4e3a8c2f33a65faf472e9ba058e4925e019e7c9f5ae694902e525f762fa5ca98f02149e294a381c303e2f5213d79159d0bd9bd524684d460624b257dd90f4e

Description

Published: 10 Jun 2022

README

Opentelemetry

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.

Dependencies (5)

  1. cohttp-lwt >= "4.0.0" & < "6.0.0~"
  2. opentelemetry-lwt = version
  3. opentelemetry = version
  4. ocaml >= "4.08"
  5. dune >= "2.7"

Dev Dependencies (1)

  1. odoc with-doc

Used by

None

Conflicts

None

OCaml

Innovation. Community. Security.