Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sile/jaeger_passage
Jaeger client library for Erlang
https://github.com/sile/jaeger_passage
erlang jaeger opentracing
Last synced: about 2 months ago
JSON representation
Jaeger client library for Erlang
- Host: GitHub
- URL: https://github.com/sile/jaeger_passage
- Owner: sile
- License: mit
- Created: 2017-10-18T16:49:47.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2020-01-23T13:32:32.000Z (almost 5 years ago)
- Last Synced: 2024-10-30T16:56:08.358Z (about 2 months ago)
- Topics: erlang, jaeger, opentracing
- Language: Erlang
- Size: 62.5 KB
- Stars: 6
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
jaeger_passage
==============
[](https://hex.pm/packages/jaeger_passage)
[](https://travis-ci.org/sile/jaeger_passage)
[](https://codecov.io/gh/sile/jaeger_passage/branch/master)
[](LICENSE)
[Jaeger](https://uber.github.io/jaeger/) client library for Erlang.
This is an extension library of [passage](https://github.com/sile/passage).
[Documentation](https://hexdocs.pm/jaeger_passage/)
A Running Example
-----------------
Starts Jaeger in the background:
```console
$ docker run -d -p6831:6831/udp -p6832:6832/udp -p16686:16686 jaegertracing/all-in-one:latest
```
Starts Erlang Shell:
```erlang
$ rebar3 shell
% Starts `example_tracer`
> Sampler = passage_sampler_all:new().
> ok = jaeger_passage:start_tracer(example_tracer, Sampler).
% Starts a root span.
> RootSpan = passage:start_span(example_root, [{tracer, example_tracer}]).
% Starts a child span.
> ChildSpan = passage:start_span(example_child, [{child_of, RootSpan}]).
% Finishes the spans
> passage:finish_span(ChildSpan).
> passage:finish_span(RootSpan).
```
Browses the tracing result:
```console
$ firefox http://localhost:16686/
```
Selecting reporter
------------------
By default 'compact' jaeger.thrift over UDP reporter is used. However it is
possible to select different reporter. Bellow is a configuration matrics for
available options:
| protocol | thrift_protocol | jaeger port | description |
|----------|-----------------|-------------|----------------------------------|
| udp | compact | 6831 | accept jaeger.thrift over compact thrift protocol (default) |
| udp | binary | 6832 | accept jaeger.thrift over binary thrift protocol |
| http | N/A | 14268 | accept jaeger.thrift directly from clients |
The HTTP version is beneficial if you don't have jaeger agents deployed or your
spans are greater than max udp packet size (65Kb).
Otherwise it is better to use default.
References
-----------
- [OpenTracing](http://opentracing.io/)
- [Jaeger](https://uber.github.io/jaeger/)
- [jaeger-client-go/README.md](https://github.com/jaegertracing/jaeger-client-go/blob/v2.9.0/README.md)
- [Jaeger Client Library](https://github.com/jaegertracing/jaeger/blob/master/docs/client_libraries.md)
- [Jaeger default ports](https://www.jaegertracing.io/docs/1.8/getting-started/)