Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Python script to monitor web pages.
branch: master
Failed to load latest commit information.
css Let anyone download the full history of raw data as a CSV file.
img Images seems to have been corrupted by excess use of sed while I migr…
js
screenshots Add a screenshot.
.gitignore Update files to ignore.
CHANGES.txt
COPYING Clarify WebPing license: this is pure GPL.
README.md
apache.conf Lower case system path.
bootstrap.py Upgrade bootstrap.py itself.
buildout.cfg Give explicit name to WebPing's shell command.
webping.conf Update email examples.
webping.py Style the warning message.

README.md

WebPing

WebPing is a tiny utility to check availability of remote web pages. It produces an HTML report to show results. It can send mails alerts when a page can't be reached. It also search for a given string in the page and calculate page response time.

This is basically a stupid and simple script. It was created at EDF for the very specific needs of the internal intranet team but can be used in other contexts.

WebPing in action

Requirements

  • a Python interpreter (tested with Python 2.4.x), to build and run WebPing.
  • an access to internet, to let buildout download its dependencies via PyPi.
  • a web server (tested with Apache 2.2.x), to serve generated HTML reports.
  • a cron-like software, to "tick" WebPing regularly.
  • SQLite > 3.x.

Install and Setup steps

This how-to is designed around our current internal use of WebPing. Don't forget to adapt it to you needs and your environment.

  1. Install required system packages.

    • On RHEL 5.x:

      $ sudo yum install git gcc sqlite-devel python-devel
      
    • On Ubuntu 11.04:

      $ sudo apt-get install git gcc libsqlite3-dev python-dev
      
  2. Check out the latest version of WebPing from GitHub:

    $ cd /var/www
    $ git clone git://github.com/kdeldycke/webping.git
    
  3. Fix rights and ownership (quick and dirty):

    $ chmod -R 755 ./webping
    $ chown -R www-data:www-data ./webping
    
  4. Initialize the buildout environment:

    $ su - www-data
    $ cd /var/www/webping
    $ python ./bootstrap.py --distribute
    
  5. Run buildout itself:

    $ ./bin/buildout
    
  6. Setup the cron file:

    $ sudo echo "*/10 * * * * www-data /var/www/webping/bin/webping" > /etc/cron.d/webping
    
  7. Register WebPing's specific web configuration to your Apache server:

    $ ln -s /var/www/webping/apache.conf /etc/apache/conf.d/
    $ /etc/init.d/apache stop
    $ /etc/init.d/apache start
    
  8. Eventually change WebPing config file to match your needs:

    $ vi /var/www/webping/webping.conf
    

Troubleshooting

Step 3 of the install process above is stuck when running the bootstrap script, and/or return a connection timeout error.
This may be due to your machine/user not having access to internet. Please carefully check your network/proxy configuration.
Pages seems to be checked regularly but with a constant delay.
Check that the ntp server is properly configured and running on the server side.

Author & Contributors

License

WebPing is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

For full details, please see the file named COPYING in the top directory of the source tree. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Embedded external projects

WebPing uses external softwares, scripts, libraries and artworks:

    jQuery JavaScript Library v1.3.2
    Copyright (c) 2009 John Resig
    Dual licensed under the MIT and GPL licenses.
    Source: http://jquery.com

    jQuery.Flot plugin v0.6
    Copyright (c) 2007-2009 IOLA and Ole Laursen
    Released under the MIT license.
    Source: http://code.google.com/p/flot

    jQuery.cuteTime plugin v1.1.1
    Copyright (c) 2009 Jeremy Horn <jeremydhorn@gmail.com>, http://tpgblog.com
    Dual licensed under MIT and GPL.
    Source: http://tpgblog.com/cutetime

    ExplorerCanvas
    Copyright (c) 2006 Google Inc.
    Released under the Apache License 2.0.
    Source: http://code.google.com/p/explorercanvas

    Crystal Project Icons
    Copyright (c) 2006-2007, Everaldo Coelho <everaldo@everaldo.com>, http://www.everaldo.com
    Released under the LGPL license.
    Source: http://www.kde-look.org/content/show.php/Crystal+Project?content=60475

    Buildout's bootstrap.py
    Copyright (c) 2006 Zope Corporation and Contributors
    Distributed under the Zope Public License, version 2.1 (ZPL).
    Source: http://svn.zope.org/repos/main/zc.buildout/trunk/bootstrap/bootstrap.py
Something went wrong with that request. Please try again.