opentelemetry-erlang-contrib/instrumentation/opentelemetry_cowboy/README.md

41 lines
1.2 KiB
Markdown
Raw Normal View History

# opentelemetry_cowboy
[![EEF Observability WG project](https://img.shields.io/badge/EEF-Observability-black)](https://github.com/erlef/eef-observability-wg)
2021-10-15 20:01:11 +00:00
[![Hex.pm](https://img.shields.io/hexpm/v/opentelemetry_cowboy)](https://hex.pm/packages/opentelemetry_cowboy)
![Build Status](https://github.com/open-telemetry/opentelemetry-erlang-contrib/workflows/Erlang/badge.svg)
2021-10-15 20:01:11 +00:00
Telemetry handler that creates Opentelemetry spans from cowboy events.
After installing, setup the handler in your application behaviour before your
top-level supervisor starts.
```erlang
opentelemetry_cowboy:setup()
```
See [cowboy_telemetry](https://github.com/beam-telemetry/cowboy_telemetry) for prerequisite setup.
There is no additional prerequisite setup for [plug_cowboy](https://hex.pm/packages/plug_cowboy) users.
## Installation
```erlang
{deps, [
2021-10-14 03:11:26 +00:00
{opentelemetry_cowboy, "~> 0.1.0"}
]}
```
```elixir
def deps do
[
2021-10-14 03:11:26 +00:00
{:opentelemetry_cowboy, "~> 0.1.0"}
]
end
```
2021-10-14 03:11:26 +00:00
## Compatibility Matrix
| opentelemetry_cowboy Version | Otel Version | Notes |
| :--------------------------- | :------------ | :---- |
| | | |
| v0.1.0 | v.1.0.0-rc.3 | |