opentelemetry-erlang-contrib/utilities/opentelemetry_telemetry
Bryan Naegele 6591b28166
Publish updates for Phoenix, Ecto, and Cowboy (#79)
* Publish 1.0 for Phoenix, Ecto, and Cowboy

* Missed version in changelog
2022-06-03 10:54:37 -06:00
..
_checkouts Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
lib Publish otel telemetry 1.0.0 (#78) 2022-04-13 19:22:28 -06:00
src Publish otel telemetry 1.0.0 (#78) 2022-04-13 19:22:28 -06:00
test Otel 1.0.0-rc.4 updates (#54) 2021-12-28 16:39:06 -07:00
.formatter.exs Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
.gitignore Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
CHANGELOG.md Do not attempt to end a span if ctx wasn't found (#59) 2022-01-05 10:23:10 -07:00
LICENSE Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
README.md Publish updates for Phoenix, Ecto, and Cowboy (#79) 2022-06-03 10:54:37 -06:00
mix.exs Publish otel telemetry 1.0.0 (#78) 2022-04-13 19:22:28 -06:00
mix.lock Publish updates for Phoenix, Ecto, and Cowboy (#79) 2022-06-03 10:54:37 -06:00
rebar.config Otel 1.0 support (#57) 2022-01-04 18:58:06 -07:00
rebar.lock Publish otel telemetry 1.0.0 (#78) 2022-04-13 19:22:28 -06:00

README.md

OpentelemetryTelemetry

A utility library for creating OpenTelemery spans from telemetry events.

Purpose

Most libraries in the BEAM ecosystem leverage telemetry events for exposing event hook points for monitoring that library. While OpenTelemetry is a great project, it is still one specification for monitoring software and it isn't reasonable to ask library authors to support multiple conventions.

OpentelemetryTelemetry provides mechanisms for otel instrumentation libraries to leverage telemetry events for creating and managing spans. The instrumentation library is then able to leverage the telemetry measurements and metadata for deriving spans, adding attributes, set span names, etc.

What Opentelemetry is Not

This library is only intended to provide utilities for working with telemetry events to instrumentation libraries. As such, it should not be used directly within your application code where the OpenTelemery API library should be leveraged.

Installation

If available in Hex, the package can be installed by adding opentelemetry_telemetry to your list of dependencies:

{deps, [
  {opentelemetry_telemetry, "~> 1.0"}
]}.
def deps do
  [
    {:opentelemetry_telemetry, "~> 1.0"}
  ]
end

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/opentelemetry_telemetry.