Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Self-hosted DevOps monitoring toolkit

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 amon
Octocat-spinner-32 config
Octocat-spinner-32 contrib
Octocat-spinner-32 installers
Octocat-spinner-32 tests
Octocat-spinner-32 .gitignore
Octocat-spinner-32 LICENSE
Octocat-spinner-32 MANIFEST.in
Octocat-spinner-32 README.rst
Octocat-spinner-32 install.sh
Octocat-spinner-32 setup.py
README.rst

Amon - developer friendly system monitoring and logging tool

Introduction

Amon was designed with one goal in mind - to help you completely monitor your web applications.

1. System monitoring

When we deploy our web applications it's important to know how much server resources they use over time, so that we can improve and optimize them. With Amon you can monitor your CPU usage, RAM, average load, network interfaces and disk drives.

2. Process monitoring

Monitoring the whole system gives you a nice overview, but sometimes you need to monitor specific processes, like your database or server.

3. Language agnostic logging

4. Language agnostic exception handling

Installation

  1. Download the tarball and install the package with python setup.py install
  2. Copy the system info collect daemon contrib/amon/amon to /etc/init.d/amon
  3. Make it executable with sudo chmod +x /etc/init.d/amon and then start the daemon with sudo invoke-rc.d/amon start

Installing Mongodb

Amon stores the system information in a Mongo database. In this section I will cover just the basics of how to install and run a mongo instance. You can find much more details at http://mongodb.org

  1. We need to create 3 directories for Mongo: -

    mkdir /usr/local/mongodb - the main directory
    mkdir /usr/local/mongodb/data - for the database
    mkdir /usr/local/mongodb/bin - for the mongo executables
    touch /var/log/mongodb.log - the mongodb log file
    
  2. Download Mongo from http://www.mongodb.org/downloads and copy the mongod file to /usr/local/mongodb/bin

  3. Copy the Mongo init script contrib/mongodb/mongodb.conf to /etc/init/mongodb.conf

  4. Start the database with sudo start mongodb

Usage

At it's core Amon is a web application. You can start it with python cherryd -i amon.web

And then open http://127.0.0.1:2464 ( or your server ip address ) in your browser

Requirements

Python 2.5+

pymongo >=1.1

CherryPy >=3.2

Jinja2 >=2.5

MongoDB

Something went wrong with that request. Please try again.