Menu

• Welcome
• Documentation
  • Notes on reading the graphs
  • Examples of Smokeping configuration
  • Notes on extending Smokeping
  • How to install SmokePing
  • How run multiple distributed instances of SmokePing
  • Notes on upgrading Smokeping
  • Commandline tool for SmokePing
  • SmokePing webfrontend
  • poll smokeping site for numeric information
  • Reference for the SmokePing Config File
• Probes
• Matchers
• Libraries
• Demo
• Download
• Statistics
• Support
• Project Sponsors
• Cast

Gold Sponsors

Silver Sponsors ...

   

smokeping_cgi

OVERVIEW

This script acts as a 'website' for your SmokePing monitoring operation. It presents the targets you are looking at in a tree structure and draws graphs as they are required by people looking at the pages.

DESCRIPTION

To get smokeping.cgi going, you need a webserver which allows you to run CGI or better FastCGI scripts. The system must be setup so that the cgi process is allowed to write to the image caching area as defined in the config file.

This script runs fine as a normal CGI, BUT it will appear to be very slow, because it does a lot of things when starting up. So if the script has to be started a fresh on every click, this is both slow and a tough thing for your webserver. I therefore strongly recommend using FastCGI.

Please refer to the installation document for detailed setup instructions.

SETUP

When installing SmokePing, I recomend to place a little shell wrapper into your htdocs directory, to launch the actual smokeping.cgi process:

 #!/bin/sh
 # maybe add some extra perl search path
 # export PERL5LIB=/opt/rrdtool/lib/perl
 exec /opt/smokeping/bin/smokeping.cgi /opt/smokeping/etc/config

COPYRIGHT

Copyright (c) 2011 by Tobias Oetiker. All right reserved.

LICENSE

This program 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; either version 2 of the License, or (at your option) any later version.

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.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

AUTHOR

Tobias Oetiker <tobi@oetiker.ch>