Skip to content
This repository

Rackspace Cloud Monitoring Agent

branch: master
Octocat-spinner-32 agents fixes to crash dump October 16, 2013
Octocat-spinner-32 base @ 1b148bb bump base April 22, 2014
Octocat-spinner-32 check fix(plugins): ruby 1.9.1p0 crashes when stdin is closed April 07, 2014
Octocat-spinner-32 client lua_cleanup: moving client from / to /base February 10, 2014
Octocat-spinner-32 examples Upload files to AEP for file-based config of checks and alarms April 17, 2014
Octocat-spinner-32 lua_modules Use a submodule for luvit-async with the forEachTable in it April 17, 2014
Octocat-spinner-32 protocol Upload files to AEP for file-based config of checks and alarms April 17, 2014
Octocat-spinner-32 schedule move util dir from virgo to virgo-base January 10, 2014
Octocat-spinner-32 static SQL Database Check and Tests July 01, 2013
Octocat-spinner-32 tests fix rhel5 April 22, 2014
Octocat-spinner-32 .agignore add agignore October 02, 2013
Octocat-spinner-32 .gitignore Test run once again May 03, 2013
Octocat-spinner-32 .gitmodules Use a submodule for luvit-async with the forEachTable in it April 17, 2014
Octocat-spinner-32 .travis.yml add irc notifications January 28, 2014
Octocat-spinner-32 Dockerfile tweak the dockerfile December 23, 2013
Octocat-spinner-32 LICENSE.txt Stub out the basics for virgo. July 11, 2011
Octocat-spinner-32 Makefile Test run once again May 03, 2013
Octocat-spinner-32 README.md fix(readme): add warning April 23, 2014
Octocat-spinner-32 agent.ico backported changes from kans/zirgo May 02, 2013
Octocat-spinner-32 agent.lua Upload files to AEP for file-based config of checks and alarms April 17, 2014
Octocat-spinner-32 bundle.list Upload files to AEP for file-based config of checks and alarms April 17, 2014
Octocat-spinner-32 certs.lua move files into the right location May 02, 2013
Octocat-spinner-32 check_runner.lua backported changes from kans/zirgo May 02, 2013
Octocat-spinner-32 code_cert.lua.prod move files into the right location May 02, 2013
Octocat-spinner-32 code_cert.lua.test move files into the right location May 02, 2013
Octocat-spinner-32 code_cert.prod.lua backported changes from kans/zirgo May 02, 2013
Octocat-spinner-32 confd.lua Use a submodule for luvit-async with the forEachTable in it April 17, 2014
Octocat-spinner-32 configure move util dir from virgo to virgo-base January 10, 2014
Octocat-spinner-32 constants.lua move util dir from virgo to virgo-base January 10, 2014
Octocat-spinner-32 crash.lua fixes to crash dump October 16, 2013
Octocat-spinner-32 crashreport.lua moving modules: /errors.lua and /protocol to /base/errors.lua and /ba… February 09, 2014
Octocat-spinner-32 endpoint.lua fix(global): Lint and fix global defines January 10, 2014
Octocat-spinner-32 host_info.lua fix(global): Lint and fix global defines January 10, 2014
Octocat-spinner-32 init.lua Upload files to AEP for file-based config of checks and alarms April 17, 2014
Octocat-spinner-32 setup.lua add MultiFactor Auth April 02, 2014
Octocat-spinner-32 sigar.lua move files into the right location May 02, 2013
Octocat-spinner-32 virgo.json use this URI and update base for signing fixes June 06, 2013
README.md

Rackspace Monitoring Agent

Build Status

The monitoring agent is the first agent to use the infrastructure provided by virgo-base-agent

Installing The Agent

Make sure you have the required packages to build things on your system. EG. build-essential. Please note, if you don't want to compile things and or don't have too, you can install using the normal "Package" method as outlined here. Otherwise, continue reading this section.

First get the source

git clone https://github.com/racker/virgo virgo-0.1.9

Go into the directory that you just created

cd virgo-0.1.9

Then get the submodules that you need

git submodule update --init --recursive

Now configure and make all the things

./configure && make 

Now simply install the virgo client by running this last and final command.

make install

Post installation you will have a new Binary on your system, rackspace-monitoring-agent. To get the client running on your system please follow the setup procedure as found here

License

The Monitoring Agent is distributed under the Apache License 2.0.

Bundles

The Lua files in this repository are not used directly (nor will they run under Luvit). Instead, they must first be bundled into a zip archive which virgo undertands. Virgo makes this process easy by taking a flag to configure, --bundle, which should be set to the directory this repo lives in. See Virgo for more information on bundles.

Building for Rackspace Cloud Monitoring

Rackspace customers: Virgo is the open source project for the Rackspace Cloud Monitoring agent. Feel free to build your own copy from this source.

But! Please don't contact Rackspace Support about issues you encounter with your custom build. We can't support every change people may make and master might not be fully tested.

Versioning

The agent is versioned with a three digit dot seperated "semantic version" with the template being x.y.z. An example being e.g. 1.4.2. The rough meaning of each of these parts are:

  • major version numbers will change when we make a backwards incompatible change to the bundle format. Binaries can only run bundles with identical major version numbers. e.g. a binary of version 2.3.1 can only run bundles starting with 2.

  • minor version numbers will change when we make backwards compatible changes to the bundle format. Binaries can only run bundles with minor versions that are greater than or equal to the bundle version. e.g. a binary of version 2.3.1 can run a 2.3.4 bundle but not a 2.2.1 bundle.

  • patch version numbers will change everytime a new bundle is released. It has no semantic meaning to the versioning.

The zip file bundle and the binary shipped in an rpm/deb/msi will be identical. If the binary is 1.4.2 then the bundle will be 1.4.2.

Running tests

Virgo supplies infrastructure for running tests. Calling make test will launch Virgo with command line flags set to feed it the testing bundle and with the -e flag set to tests.

make test
Something went wrong with that request. Please try again.