No commit activity in last 3 years
No release in over 3 years
New Relic plugin for monitoring piVPN, based on newrelic_openvpn_agent developed by KangaCoders Ltd.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

New Relic piVPN (OpenVPN) monitoring Plugin

The New Relic piVPN Plugin enables monitoring piVPN, and it reports the following data:

  • Amount of active Users
  • Amount of bytes sent
  • Amount of bytes received
  • Average of bytes sent
  • Average of bytes received

Note

This plugin is based on KangaCoders' newrelic_openvpn_agent - https://rubygems.org/gems/newrelic_openvpn_agent, v.0.0.1

Requirements

The piVPN monitoring Plugin for New Relic requires the following:

  • A New Relic account. Signup for a free account at http://newrelic.com
  • You need to install this plugin on a piVPN server. That host also needs Ruby (tested with 1.8.7, 1.9.3), and support for rubygems.

Instructions for running the piVPN agent

  1. Install this gem from RubyGems:

    sudo gem install newrelic_pivpn_agent

  2. Install config, execute

    sudo newrelic_pivpn_agent install - it will create /etc/newrelic/newrelic_pivpn_agent.yml file for you.

  3. Edit the /etc/newrelic/newrelic_pivpn_agent.yml file generated in step 2.

    3.1. replace YOUR_LICENSE_KEY_HERE with your New Relic license key. Your license key can be found under Account Settings at https://rpm.newrelic.com, see https://newrelic.com/docs/subscriptions/license-key for more help.

    3.2. replace the agent name 'openvpn' to any unique instance name of choice

    3.3. replace the path of the piVPN status binary if needed

  4. Execute

    newrelic_pivpn_agent run

  5. Go back to the Plugins list and after a brief period you will see the piVPN Plugin listed in your New Relic account

Keep this process running

You can use services like these to manage this process and run it as a daemon.

Support

Please use Github issues for support.