opentelemetry-erlang-contrib/utilities/opentelemetry_telemetry
renovate[bot] 45b66d5f50
chore(deps): update dependency ex_doc to v0.31.1 (#233)
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2024-01-17 11:27:19 -07:00
..
lib Publish otel telemetry 1.0.0 (#78) 2022-04-13 19:22:28 -06:00
src Remove telemetry registry, fix broken log, update tests (#207) 2023-09-16 09:51:50 -06:00
test Remove telemetry registry, fix broken log, update tests (#207) 2023-09-16 09:51:50 -06: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 Update README.md (#209) 2023-09-28 12:57:30 -06:00
mix.exs chore(deps): update dependency ex_doc to v0.31.1 (#233) 2024-01-17 11:27:19 -07:00
mix.lock chore(deps): update dependency ex_doc to v0.31.1 (#233) 2024-01-17 11:27:19 -07:00
rebar.config Remove telemetry registry, fix broken log, update tests (#207) 2023-09-16 09:51:50 -06:00
rebar.lock Remove telemetry registry, fix broken log, update tests (#207) 2023-09-16 09:51:50 -06:00

README.md

OpentelemetryTelemetry

A utility library for creating OpenTelemetry 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.