Skip to content

Latest commit

 

History

History
67 lines (42 loc) · 2.17 KB

README.md

File metadata and controls

67 lines (42 loc) · 2.17 KB

VerneMQ CloudWatch Metrics plugin

This is a VerneMQ plugin that will send broker metrics to Amazon CloudWatch.

Prerequisites

  • A recent version of Erlang/OTP(Not tested on versions previous to 19).
  • VerneMQ version 1.7.0 or superior.

How to compile this plugin

This project uses Rebar3 as a build tool and can be compiled running:

rebar3 compile

How to enable the plugin on VerneMQ

Manually enable

vmq-admin plugin enable --name=vmq_cloudwatch_metrics --path=<PathToYourPlugin>/_build/default/lib/vmq_cloudwatch_metrics

Permanently enable (On VerneMQ start)

Add the following to the vernemq.conf file.

plugins.vmq_cloudwatch_metrics = on
plugins.vmq_cloudwatch_metrics.path = <PathToYourPlugin>/_build/default/lib/vmq_cloudwatch_metrics

Configuration

The following settings are available for this plugin:

Parameters can be defined in the vernemq.conf file.

vmq_cloudwatch_metrics.cloudwatch_enabled = on
vmq_cloudwatch_metrics.interval = 60000
vmq_cloudwatch_metrics.namespace = "VerneMQ"
vmq_cloudwatch_metrics.aws_access_key_id = "MYACCESSKEY"
vmq_cloudwatch_metrics.aws_secret_access_key = "MYSECRETACCESSKEY"
vmq_cloudwatch_metrics.aws_region = "eu-west-1"

Tip: Configuration parameters can also be changed at runtime using the vmq-admin script.

TODO

  • Add tests.
  • Add CI using Travis.