opentelemetry-erlang-contrib/instrumentation/opentelemetry_finch
renovate[bot] 8f6a466666
chore(deps): update dependency finch to ~> 0.17 (#252)
* chore(deps): update dependency finch to ~> 0.17

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Bryan Naegele <bryannaegele@users.noreply.github.com>
2024-01-17 11:40:59 -07:00
..
config finch-instrumentation (#115) 2022-11-09 12:27:40 -07:00
lib chore: add sc to finch (#141) 2022-12-15 04:36:52 -07:00
test Fix CI errors, update GHA deps, update versions (#125) 2022-11-15 16:22:28 -07:00
.formatter.exs finch-instrumentation (#115) 2022-11-09 12:27:40 -07:00
.gitignore finch-instrumentation (#115) 2022-11-09 12:27:40 -07:00
CHANGELOG.md finch-instrumentation (#115) 2022-11-09 12:27:40 -07:00
LICENSE finch-instrumentation (#115) 2022-11-09 12:27:40 -07:00
README.md finch-instrumentation (#115) 2022-11-09 12:27:40 -07:00
mix.exs chore(deps): update dependency finch to ~> 0.17 (#252) 2024-01-17 11:40:59 -07:00
mix.lock chore(deps): update dependency finch to ~> 0.17 (#252) 2024-01-17 11:40:59 -07:00

README.md

OpentelemetryFinch

OpentelemetryFinch uses telemetry handlers to create OpenTelemetry spans from Finch events.

Installation

The package can be installed by adding opentelemetry_finch to your list of dependencies in mix.exs:

  def deps do
    [
      {:opentelemetry_finch, "~> 0.1"}
    ]
  end

In your application start:

  def start(_type, _args) do
    OpentelemetryFinch.setup()

    # ...
  end

Since this instrumentation is based on telemetry, it is not possible to automatically propagate the context in the http headers. If you need to perform context propagation, you should opt for manual instrumentation. Something like this:

    require OpenTelemetry.Tracer, as: Tracer

    Tracer.with_span "HTTP #{url}" do
      headers = :otel_propagator_text_map.inject([])

      with request <- Finch.build(:get, url, headers),
           {:ok, response} <- Finch.request(request, HttpFinch) do

        Tracer.set_attributes([
          {"http.url", url},
          {"http.method", request.method},
          {"http.status_code", response.status}])
        {:ok, response}
      else
        {:error, %{__exception__: true} = error} ->
          Tracer.set_status(:error, Exception.message(error))
          {:error, error}
      end
    end

Compatibility Matrix

OpentelemetryFinch Version Otel Version Notes
v0.1.0 v1.0.0

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