opentelemetry-erlang-contrib/utilities/opentelemetry_telemetry
Bryan Naegele d7eb7b8a24
Migrate otel_telemetry to contrib (#43)
2021-11-27 18:33:47 -07:00
..
_checkouts Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
lib Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
src Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
test Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -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 Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
LICENSE Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
README.md Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
VERSION Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
mix.exs Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
mix.lock Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
rebar.config Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07:00
rebar.lock Migrate otel_telemetry to contrib (#43) 2021-11-27 18:33:47 -07: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.0-beta.5"}
]}.
def deps do
  [
    {:opentelemetry_telemetry, "~> 1.0.0-beta.5"}
  ]
end

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