Wombat Discovery Plugin

What is Wombat?

Wombat is a monitoring tool for Erlang and Elixir based applications and products like RabbitMQ, Riak, Cowboy, MongooseIM. Read more on its website at https://www.erlang-solutions.com/products/wombatoam.html. It provides you with an on-premises monitoring solution which collects many metrics from the BEAM VM and even custom metrics from the application.

Wombat Discovery Plugin

As Wombat is installed near the application it is hard to orchestrate the discovery of containers or other dynamic applications. This plugin provides a way to automatically add the new node to Wombat.

Installation

This package only works on Elixir nodes. To use it just specify the dependency wombat_discovery in your mix file.

def deps do
  [
    {:wombat_discovery, "~> 1.0.1"}
  ]
end

Usage

The plugin can be configured multiple ways, the easiest way is to define two environment variables: WOMBAT_NODENAME should be the Erlang nodename of Wombat, for example wombat@static.host. WOMBAT_COOKIE should be the cookie of Wombat, by default it’s wombat.

The other way is to configure the wombat_discovery application in the config.exs file, for example:


config :wombat_discovery,
  wombat_nodename: :"wombat@static.host",
  wombat_cookie: :wombat,
  retry_count: 20,
  retry_wait: 30000