From: Stephen L Johnson Date: Tue, 14 Sep 1999 21:56:39 +0000 (+0000) Subject: Initial import X-Git-Tag: start~40 X-Git-Url: http://git.etc.gen.nz/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5cceac7949d4a1153777980e19b7d422561c17e6;p=spong.git Initial import --- diff --git a/www/html/cpu.html b/www/html/cpu.html new file mode 100755 index 0000000..5fdc4c4 --- /dev/null +++ b/www/html/cpu.html @@ -0,0 +1,22 @@ + + + Son of Pong - Help CPU + + + +

cpu

+ +This check test to make sure that the "load" (the amount of CPU being +used) is not too high. If too much CPU is being used, services that are +provided by that system could be suffering and users on that system could be +noticing significant delays.

+ +A summary of the current load, the number of users, the number of processes +running, and the amount of time that the system has been up are provided.

+ +A list of the top 10 processes using the most CPU resources is also available +which might help indicate what processes are causing problems.

+ +

+ + diff --git a/www/html/disk.html b/www/html/disk.html new file mode 100755 index 0000000..e53f493 --- /dev/null +++ b/www/html/disk.html @@ -0,0 +1,21 @@ + + + Son of Pong - Help DISK + + + +

HELP - disk

+ +This check tests to make sure that your disks have enough free space available +to make you comforatble. If a disk fills up or doesn't have enough room for +additional information, then services could be impacted, or data could be +lost.

+ +A summary of the disks that are most "full" is provided. A full "df" output is +also provided to show you the overall status of your storage system.

+ +Swap space is also show here. Swap space is used by the virtual memory system on the server. If the amount of available swap space get to low, the system system perform will be impacted.

+ +The summary output of the command that displays swap space will be provided after the full "df" output.

+ + diff --git a/www/html/dns.html b/www/html/dns.html new file mode 100755 index 0000000..bcba5a3 --- /dev/null +++ b/www/html/dns.html @@ -0,0 +1,21 @@ + + + Son of Pong - Help dns + + + +

Help - dns

+ +DNS stands for Domain Name Service. This is the service that provides maps +between hostnames and IP addresses. This check is performed by connecting to +the DNS server at the remote machine and asking it to provide it's own IP +address based on it's name. If the server is down, it won't be able to do this +function, and an error will be returned.

+ +If this service is down, many problems could appear. People will report slow +networks or systems (due to timeouts while looking up addresses). People might +not be able to connect to services or systems. In general if DNS is down you +will run into multiple widespread problems.

+ + + diff --git a/www/html/ftp.html b/www/html/ftp.html new file mode 100755 index 0000000..ed82c50 --- /dev/null +++ b/www/html/ftp.html @@ -0,0 +1,15 @@ + + + Son of Pong - Help ftp + + + +

ftp

+ +This is a network service that some systems provide. It allows you to upload +and download files. This check is performed by actually connecting to the ftp +service on the remote machine and verifies that it responds correctly.

+ +If this service is down, users will not be able to "ftp" to that machine.

+ + diff --git a/www/html/help.html b/www/html/help.html new file mode 100755 index 0000000..e22e5d7 --- /dev/null +++ b/www/html/help.html @@ -0,0 +1,76 @@ + + + Son of Pong - Help (__UPDATE_TIME__) + + + +

Spong Basics

+ +Son of Pong (spong) is a simple system monitoring package, that will monitor +system attributes and network services on a variety of machines. It will +gather status reports and contact staff if there are problems. It will also +summarize the information and display it via web interface (which is what you +are using).

+ +Systems and the status of the services provided by those hosts are summarized +in a tables on the right of the screen. Hostnames make up the vertical axis +of each table, and services make up the horizontal axis. For each row, and +column of the table, if that service is running on that host, then a colored +dot is located in that position. The color of the dot represents the status +of that service. A green dot indicates that everything appears ok, a yellow +dot indicates that there might be a problem, and a red dot indicates that +there is a problem that requires attention.

+ +Problems that require attention are summarized and listed in the column on the +left of the screen. Information about each problem (such as the host, and +service having the problem, the time that the problem occured, and the person +to contact about the problem) is provided for each host that requires +attention.

+ +Help is provided by clicking the "Help" link on the main screen (which takes +you to this page). You can also get additional information about each service +by clicking on the service headings at the top of each table. + +If you click on the hostnames in the table, you will be taken to a screen +which provides more detailed information about that host. A table of the +services running on that host is listed at the top of the page, with the +bottom of the page having two columns. The column on the left shows any host +specific text that you supply. The column on the right shows the history of +problems that have occured on that host.

+ +If you click on any of the "dots" in the table, you will be taken to a page +showing more detailed service information. At the top of the page shows +detailed information that might be useful in diagnosing the problem, the +bottom of the page shows the history of that service.

+ +

Nitty Gritty Details

+ +If you are just a casual user of spong - someone who keeps track of the web +page, or someone who reacts to problems reported by spong, then hopefully the +above documentation is sufficient to your needs.

+ +However, if you are someone who needs to install spong, or configure either +the client thresholds, or the network services that should be monitored, then +the following HTML versions of the man pages should be of use.

+ +

spong - overview of spong +
+
spong.conf - distributed config file +
spong.hosts - host/service config file +
+
spong-client - collects/reports cpu,disk,etc info +
spong-network - collects/reports network service info +
spong-server - listens for/saves spong status updates +
spong-display - displays spong status via CGI program +
spong-message - alerts humans there's a problem +

+ + + + + +

+Written by Ed Hill +(ed-hill@uiowa.edu). diff --git a/www/html/history.html b/www/html/history.html new file mode 100755 index 0000000..72ccfd2 --- /dev/null +++ b/www/html/history.html @@ -0,0 +1,37 @@ + + + Son of Pong - History (__UPDATE_TIME__) + + + + + + + + + + + + +

+Son of Pong +

+Home || +History || +Help +

+__HACK_START__ +__GROUP_ALL_ERRORS__ +__HACK_END__ +

+Updated at __UPDATE_TIME__ + +

+ +__HISTORY_ALL__ +

+ diff --git a/www/html/home.html b/www/html/home.html new file mode 100755 index 0000000..cf9e0f8 --- /dev/null +++ b/www/html/home.html @@ -0,0 +1,40 @@ + + + Son of Pong - System Status Monitor (__UPDATE_TIME__) + + + + + + + + + + + + +

+Son of Pong +

+Home || +History || +Help +

+__HACK_START__ +__GROUP_ALL_ERRORS__ +__HACK_END__ +

+Updated at __UPDATE_TIME__ + +

+ +All Systems

+__GROUP_ALL_ALL__ +

+ +

diff --git a/www/html/host.html b/www/html/host.html new file mode 100755 index 0000000..43bf274 --- /dev/null +++ b/www/html/host.html @@ -0,0 +1,46 @@ + + + Son of Pong - Host Information (__UPDATE_TIME__) + + + + + + + + + + + + +

+Son of Pong +

+Home || +History || +Help +

+__HACK_START__ +__GROUP_ALL_ERRORS__ +__HACK_END__ +

+Updated at __UPDATE_TIME__ + +

+__HOST__

+__SERVICE_TABLE__ +

+Information

+__INFORMATION__ +

+History

+__HISTORY__ + +

+ + + diff --git a/www/html/http.html b/www/html/http.html new file mode 100755 index 0000000..7d53566 --- /dev/null +++ b/www/html/http.html @@ -0,0 +1,18 @@ + + + Son of Pong - Help http + + + +

Help - http

+ +This is a network service that some systems provide. It is what web servers +and browsers use to communicate. If this service is running on a machine, it +means that machine has a web server running. This check is performed by +requesting the "/robots.txt" document - this is a common file that "web +spiders" look at to see if they have permission to scan through the server.

+ +If this service is down, users will not be able to access web pages or programs +from that host.

+ + diff --git a/www/html/imap.html b/www/html/imap.html new file mode 100755 index 0000000..50d9de1 --- /dev/null +++ b/www/html/imap.html @@ -0,0 +1,18 @@ + + + Son of Pong - Help imap + + + +

Help - imap

+ +This is a network service that some systems provide. It is a mail service, +that allows people to access their mail on the remote machine. This check is +performed by actually connecting to the imap service on the remote machine and +verifies that it responds correctly.

+ +If this service is down, users will not be able to access their mail on that +machine.

+ + + diff --git a/www/html/jobs.html b/www/html/jobs.html new file mode 100755 index 0000000..eb53059 --- /dev/null +++ b/www/html/jobs.html @@ -0,0 +1,22 @@ + + + Son of Pong - Help jobs/procs + + + +

Help - jobs / procs

+ +This check looks to make sure certain "key" processes are running. For example +if you have a Oracle database installed on a system, you want to make sure all +the oracle processes associated with the database are running.

+ +A summary message is provided indicating what processes are not running (if +any), and more detailed information is also provided showing the complete +process list of all the processes that you expect to be running.

+ +If this service not "green", it indicates that some program that should be +running is not, which could prevent people from accessing a service, or cause +other problems.

+ + + diff --git a/www/html/lan.html b/www/html/lan.html new file mode 100755 index 0000000..2d0f0ae --- /dev/null +++ b/www/html/lan.html @@ -0,0 +1,40 @@ + + + Son of Pong - System Status Monitor (__UPDATE_TIME__) + + + + + + + + + + + + +
+Son of Pong +
+Home || +History || +Help +
+
+__HACK_START__ +__GROUP_lan_ERRORS__ +__HACK_END__ +
+
+Updated at __UPDATE_TIME__ + + + + + +LAN Systems
+__GROUP_lan_ALL__ +
+ +
+

diff --git a/www/html/logs.html b/www/html/logs.html new file mode 100755 index 0000000..3f1c52e --- /dev/null +++ b/www/html/logs.html @@ -0,0 +1,22 @@ + + + Son of Pong - Help logs + + + +

Help - logs

+ +This check looks for "keywords" in log files that shouldn't exist. If lines +having those words are found they are reported. You would typically check for +words like "ALERT" in your syslog file, and other phrases that indicate a +problem.

+ +Log entries that have the words you are looking for are reported to the spong +server, so that you can view them while looking at the problem.

+ +If this service is "red", it could indicate a variety of problems - depending +on the log and words you are checking for.

+ + + + diff --git a/www/html/nntp.html b/www/html/nntp.html new file mode 100755 index 0000000..a9cd7a6 --- /dev/null +++ b/www/html/nntp.html @@ -0,0 +1,19 @@ + + + Son of Pong - Help nntp + + + + + +

Help - nntp

+ +This is a network service that few systems provide. It is the Usenet news +service. This check is performed by actually connecting to the nntp service on +the remote machine and verifies that it responds correctly.

+ +If this service is down, then people will not be able to read or post Usenet +news messages.

+ + + diff --git a/www/html/ping.html b/www/html/ping.html new file mode 100755 index 0000000..4287755 --- /dev/null +++ b/www/html/ping.html @@ -0,0 +1,35 @@ + + + Son of Pong - Help ping + + + +

Help - ping

+ +This check tests the network connectivity of the machine. Periodically, every +machine is "pinged" from the spong server machine to check to see if it is +accessible via the network. If this service is "red", it could indicate a +couple of different problems.

+ +Either the machine itself is down or frozen, or there is a network problem +between the spong server and the machine. If you find that a large majority +of machines have their ping service marked as "red", this would typically +indicate a networking problem (or a wide scale problem associated with a +power failure or some other disaster).

+ +If the ping service is not available, then chances are most services running +on that machine are also marked "red" (or "purple"), since if the machine can +not be accessed via the network, any client information probably won't be +reported either.

+ +If there is a connectivity problem, then a traceroute is done between the spong +server and the machine being monitored. This information might be helpful to +someone trying to determine where the problem lies (if it is a networking +problem).

+ + + + + +

+ diff --git a/www/html/pop3.html b/www/html/pop3.html new file mode 100755 index 0000000..21c57cf --- /dev/null +++ b/www/html/pop3.html @@ -0,0 +1,18 @@ + + + Son of Pong - Help pop3 + + + +

Help - pop3

+ +This is a network service that some systems provide. It is a mail service, +that allows people to access their mail on the remote machine. This check is +performed by actually connecting to the pop3 service on the remote machine and +verifies that it responds correctly.

+ +If this service is down, users will not be able to access their mail on that +machine.

+ + + diff --git a/www/html/procs.html b/www/html/procs.html new file mode 100755 index 0000000..eb53059 --- /dev/null +++ b/www/html/procs.html @@ -0,0 +1,22 @@ + + + Son of Pong - Help jobs/procs + + + +

Help - jobs / procs

+ +If this service not "green", it indicates that some program that should be +running is not, which could prevent people from accessing a service, or cause +other problems.

+ + + diff --git a/www/html/service.html b/www/html/service.html new file mode 100755 index 0000000..0dbd262 --- /dev/null +++ b/www/html/service.html @@ -0,0 +1,46 @@ + + + Son of Pong - Service Information (__UPDATE_TIME__) + + + + + + + + + + + + +
+Son of Pong +
+Home || +History || +Help +
+
+__HACK_START__ +__GROUP_ALL_ERRORS__ +__HACK_END__ +
+
+Updated at __UPDATE_TIME__ + + + + + +__COLOR__ __HOST__, __SERVICE__
+
+__MESSAGE__ +
+
+ +History
+__HISTORY__ +
+ + + diff --git a/www/html/smtp.html b/www/html/smtp.html new file mode 100755 index 0000000..1b6fbbc --- /dev/null +++ b/www/html/smtp.html @@ -0,0 +1,20 @@ + + + Son of Pong - Help smtp + + + + + +

Help - smtp

+ +This is a network service that some systems provide. It is a mail service, +that allows people to send mail to other users. This check is performed by +actually connecting to the smtp service on the remote machine and verifies that +it responds correctly.

+ +If this service is down, users will not be send email messages to others. It +could also indicate that mail messages are being delayed.

+ + + diff --git a/www/html/unix.html b/www/html/unix.html new file mode 100755 index 0000000..5f205e4 --- /dev/null +++ b/www/html/unix.html @@ -0,0 +1,55 @@ + + + Son of Pong - System Status Monitor (__UPDATE_TIME__) + + + + + + + + + + + + +
+Son of Pong +
+Home || +History || +Help +
+
+__HACK_START__ +__GROUP_unix-blue_ERRORS__ +__GROUP_unix-sp_ERRORS__ +__GROUP_unix-core_ERRORS__ +__GROUP_unix-dept_ERRORS__ +__HACK_END__ +
+
+Updated at __UPDATE_TIME__ + + + + + +Blue Cluster
+__GROUP_unix-blue_ALL__ +
+ +SP Cluster
+__GROUP_unix-sp_ALL__ +
+ +Core Systems
+__GROUP_unix-core_ALL__ +
+ +Department Servers
+__GROUP_unix-dept_ALL__ +
+ +
+