https://github.com/opencensus-beam/opencensus_service

Library for reporting spans and metrics to OpenCensus Service over grpc
https://github.com/opencensus-beam/opencensus_service

Last synced: 3 months ago
JSON representation

Library for reporting spans and metrics to OpenCensus Service over grpc

• Host: GitHub
• URL: https://github.com/opencensus-beam/opencensus_service
• Owner: opencensus-beam
• License: apache-2.0
• Created: 2019-01-28T22:21:15.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-09-03T20:33:37.000Z (almost 4 years ago)
• Last Synced: 2024-02-18T04:20:51.326Z (4 months ago)
• Language: Erlang
• Size: 94.7 KB
• Stars: 5
• Watchers: 4
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-opencensus - OpenCensus Agent Reporter

README

        
# OpenCensus Agent Reporter

This reporter exports spans to the [OpenCensus Agent](https://github.com/census-instrumentation/opencensus-service) in the standard [protobuf format](https://github.com/census-instrumentation/opencensus-proto) over [grpc](https://grpc.io/).

## Installation and Configuration

### Erlang

Take a dependency on `opencensus_service`, e.g. with `rebar3` by adding it

to your applications list in `.app.src`.

Configure `:opencensus`' `:reporters` to use `:oc_reporter_service`:

``` erlang

{opencensus, [

    {reporters, [{oc_reporter_service, #{}}]}

...]}

```

### Elixir

Take a dependency on `opencensus_service` by adding to your `deps` in

`mix.exs`:

```elixir

{:opencensus, "~> 0.9.0", override: true},

{:opencensus_service, "~> 0.1"}

```

(You'll need the `override` because the `opencensus_service` package expects

version 0.7 of `opencensus`. It seems to work fine with 0.9, however.)

Configure `:opencensus`' `:reporters` in `config/config.exs` to use

`:oc_reporter_service`:

```elixir

config :opencensus, :reporters, [{:oc_reporter_service, %{}}]

```

The map (`%{}`) at the end gives `oc_reporter_service` its options. Its

defaults are:

```elixir

%{

  channel_name: :channel_service,

  endpoints: [{:http, 'localhost', 55678, []}],

  options: %{},

  sup_flags: %{intensity: 1, period: 5, strategy: :one_for_one}

}

```

*WARNING:* the hostname in `endpoints` is a charlist, _not_ a binary. If

you're pulling the endpoint out of an environment variable, pipe the result

from `System.get_env/1` through `String.to_charlist/1`.