ACS Administrator's Guide
- User directory: none
- Admin directory: /admin/monitoring/
- Procedures: /tcl/watchdog-defs, /tcl/cassandracle-defs
- Binaries: /bin/aolserver-errors.pl
The Big Picture
The ArsDigita Community System has an integrated set of monitoring
Monitoring parameters as centralized in the monitoring
section of the .ini file. Add a new
each person who should receive monitoring alerts.
; People to email for alerts
; location of the watchdog perl script
; watchdog frequency in minutes
Current page requests - monitor
The "current page request" section (linked from /admin/monitoring/)
will produce a report like the following.
|There are a total of 8 requests being served right now (to 8 distinct IP addresses). Note that this number seems to include only
the larger requests. Smaller requests, e.g., for files and in-line images, seem to come and go too fast for this program to
|conn #||client IP||state||method||url||n seconds||bytes|
This report will inform you which users are waiting on pages from your server.
In the report above, users asking for large images or pages are waiting. This
is normal because some users have very slow connections.
If you see the same or .adp file often, especially with the longest wait times, it is likely that the script is extremely slow or is hogging database handles. You should
- Examine and fix the page
- User ad_return_if_another_copy_is_running to limit the number of times the page can concurrently run (limit to a few less than your total db pool).
This will prevent multiple executions of that page from destroying your whole web service.
If you see a large number of requests from the same IP address, it is
likely that a poorly-designed spider is attacking your web service. To stop it,
ban that IP address from your system.
Cassandracle is a Web-based monitor for an Oracle installation.
The goal is that, at a glance, a novice Oracle DBA ought to be
able to identify problems and find pointers to relevant reference materials.
To use Cassandracle in your installation, you will need to
give the web service's database
user read access to some core Oracle tables.
- Log into Oracle via sqlplus
SQL> connect internal
- Run the commands in /sql/cassandracle.sql
SQL> grant ad_cassandracle to username;
This is a simple section with information about the current machine
and connection. The information provided is pretty sparse and should
expand in the future.
WatchDog (Error log)
WatchDogFrequency seconds, the service's error logs will
be scanned. If errors are found, they will be emailed to those configured
PersontoNotify. The administration pages have a tool
to search the error log for errors.
WatchDogFrequency is 0, the error logs won't be scanned
Registered Filters and Schedule Procedures
The procs ad_register_filter and ad_schedule_proc
are wrappers around the corresponding ns_ calls, which allow
us to more carefully track what's happening on the server and when.
which filters are called for which URLs and methods, and /admin/monitoring/scheduled-procs
shows which procedures are scheduled to be called in the future.
TopFrequency seconds, the system call residing
TopLocation will be run, and its output parsed into
overall and procedure-specific statistics. /admin/monitoring/top
shows the historical results of this periodic call, and lets you
see the current output of top on the machine your service is running
on, over the web.
TopFrequency is 0, top won't be run regularly.
See also ad-monitoring-defs.tcl and
- Caveat 1: top output varies a great deal from one implementation to
another, and this monitor currently only recognizes the syntax of the
default Solaris 7 top function.
- Caveat 2: Neither the regular monitoring nor running top from a
web page are possible if you are running the ACS in a chrooted
environment, since top looks in /proc, a sensitive directory.