Skip to content
Find file
Fetching contributors…
Cannot retrieve contributors at this time
121 lines (75 sloc) 2.98 KB


Virgo is a project for building an on-host agents. The goal is to provide shared infrastructure for various types of agents.

The first agent to use this infrastructure is the Rackspace Cloud Monitoring agent.

Join in and build your agent with us.


virgo is distributed under the Apache License 2.0.

Building on a Unix-like Operating System


Running tests

make test

Running monitoring agent fixtures server

The monitoring agent comes with an example fixture server. This will send the fixtures found in agents/monitoring/tests/fixtures/ back and forth between a running agent. You can run a server and agent like this:

 python agents/monitoring/runner server_fixture
 python agents/monitoring/runner agent_fixture

If you want to have the fixtures server listen on something other than provide the environment variable LISTEN_IP="".

Building on RHEL 5.x

Add the EPEL repo and install dependencies

# rpm -ivh
# yum update
# yum groupinstall 'Development Tools'
# yum install git python26 gcc44 gcc44-c++

Default to python2.6:

# ln -s /usr/bin/python2.6 /usr/local/bin/python
# export PATH=/usr/local/bin:$PATH

Clone the repository:

# git clone

Configure and Build:

# ./configure
# CC=gcc44 CXX=g++44 make
# CC=gcc44 CXX=g++44 make install

Building on Windows

Install the following:

Once the dependencies are installed:

python configure

Now you can open monitoring-agent.sln from Visual Studio.

If you wish to compile from the command line, run:

python tools/ build

See also:


Change agent entry point

The entry point to the agent defaults to modules/monitoring/monitoring-agent.lua. To change this entry use the flag -e:

./monitoring-agent -z -e tests

This example would run agents/monitoring/tests/init.lua.

Distro Packages


yum install rpm-build
make rpm

Find the rpms in out/rpmbuild/RPMS/


apt-get install devscripts
make deb

Find the deb in out/debbuild/

Jump to Line
Something went wrong with that request. Please try again.