https://github.com/soundtrackyourbrand/prometheus-collector-telemetry-converter

https://github.com/soundtrackyourbrand/prometheus-collector-telemetry-converter

prometheus telemetry

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/soundtrackyourbrand/prometheus-collector-telemetry-converter
• Owner: soundtrackyourbrand
• License: mit
• Created: 2019-12-13T14:01:52.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2019-12-13T14:24:41.000Z (about 5 years ago)
• Last Synced: 2024-10-13T11:08:59.017Z (3 months ago)
• Topics: prometheus, telemetry
• Language: Elixir
• Size: 7.81 KB
• Stars: 3
• Watchers: 8
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# PrometheusCollectorTelemetryConverter

Converts the output of a [prometheus.erl](https://github.com/deadtrickster/prometheus.erl) collector to `:telemetry` events so they can be used with [`telemetry_poller`](https://github.com/beam-telemetry/telemetry_poller)

## Installation

```elixir

def deps do

  [

    {:prometheus_collector_telemetry_converter, "~> 0.1.0"}

  ]

end

```

## Usage

Add the `:telemetry_poller` to your applications supervisor tree

```elixir

defmodule MyApp.Application do

  use Application

  def start(_type, _args) do

    children = [

      {:telemetry_poller,

       measurements: [

         {PrometheusCollectorTelemetryConverter, :collect,

          [:prometheus_vm_system_info_collector]},

         {PrometheusCollectorTelemetryConverter, :collect, [:prometheus_vm_statistics_collector]},

         {PrometheusCollectorTelemetryConverter, :collect, [:prometheus_vm_memory_collector]}

       ]}

    ]

    opts = [strategy: :one_for_one, name: MyApp.Supervisor]

    Supervisor.start_link(children, opts)

  end

end

```

## Telemetry.Metrics

There are some ready made `Telemetry.Metrics` measurements that triest to mimic `prometheus.erl` as closely as possible.

So far the metrics from `:prometheus_vm_system_info_collector`, `:prometheus_vm_statistics_collector` and `:prometheus_vm_memory_collector` have been added, but adding more should be pretty simple. 

TelemetryMetricsPrometheus doesn't support exposing `last_value` as counters (only as gauges), so this module will cache the last value of counter values reported by the prometheus.erl collector, and emit the diff between the current value and the last value. That way we can use `sum` instead, and they will be exposed as counters.