Skip to content

GooeeIOT/hd-vmq-cloudwatch-metrics

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Releases

No releases published

Packages

No packages published

Languages

  • Erlang 100.0%