[XML] ApacheStats version 0.4

Rolf Poser · Joined: 10 Dec 2003 Posts: 42

Hello Everyone!

After numerous bugs and simplifications, I thought it would be prudent to put out a newer release of apachestats.

It now uses LWP by default to keep things simple, but a high-speed version is also provided. The templates have been cleaned up significantly, and there is a new graph for threads - busy/idle threads expressed as % of total threads. See the documentation for further details.

I'm attaching the intro readme.txt:

==============================================
ApacheStats v 0.4 - Copyright Rolf Poser - GNU Public License

RELEASED 20 May 2004

Please see the various documents in the "docs/" subdirectory.

Notably, the docs/TOC.txt tells you where to find what information.

Yes, all of this documentation will be made available in html form
eventually. But for now, it is content before form!

Thanks -- Rolf. (rolf@stasolutions.co.za)

QUICK INSTALL GUIDE:
=====================
(NOTE: a more detailed version of this is in docs/INSTALL.txt)

For those that can't wait to read through all of the finer detail:

(0. Do you have perl > 5.x and cacti > 0.8.5a ? This is fairly important!)

1. Pick a script - the default ws_apachestats.pl should be good for most
people (see docs/TUNING.txt for a high-speed version).

2. Copy the script to $cacti_path/scripts and make sure to name it
"ws_apachestats.pl".

3. Ensure that the apache server you are targeting has the ExtendedStatus On
and has permissions to allow for queries (look for /server-status).

4. Import the host xml file for apachestats from the xml directory.

5. Define a new graph and enter the hostname information as per usual (I'm
assuming you know how cacti works).

5. Have a cup of coffee - the graphs will only get created and populated after
two cycles of cacti querying the web server (~10 minutes on system).

6. You're welcome to post questions for help on the message board at
www.raxnet.net/board if you get stuck, although I can't promise to always be
responsive.

ApacheStats v 0.4 - Copyright Rolf Poser - GNU Public License

testtest · Joined: 17 May 2004 Posts: 25 Location: Europe

Rolf Poser · Joined: 10 Dec 2003 Posts: 42

Testtest:

You're welcome!

Actually I'd been stalling on releasing 0.3 for a few months - been very busy with "real" (i.e. the stuff that pays the bills) work.

I realised that part of the problem was my sucky understanding of cacti templates and that the ones released with 0.2 weren't working for many people (i.e. the hostname wasn't being substituted). Also, the more I can include in the documentation, the less of a pain it is for someone trying to figure out what's wrong.

Thanks again for your assistance - I appreciate all comments, since this is my first real open source project. (My second one is Squidstats which I'll hopefully update to release 0.2 this weekend.)

Thanks,
Rolf.

PS: I don't really qualify as a seasoned programmer - most of what you see in apachestats is code that was contributed by others to this project...
Maybe 10% is mine. (OK the documentation is all mine, but that doesn't count as code.)

testtest · Joined: 17 May 2004 Posts: 25 Location: Europe

Rolf Poser · Joined: 10 Dec 2003 Posts: 42

testest

I've just released a tool that does some or perhaps all of what you're looking for.

In this forum you should find SocketStats-0.1

Good luck
Rolf.

Guest · Posted: Thu May 20, 2004 6:48 pm Post subject: Re: I've just written one:

testtest · Joined: 17 May 2004 Posts: 25 Location: Europe

norbert · Joined: 25 May 2004 Posts: 1

Hello,

I adjusted the script from the scripts page to work with apache2 and be less cryptic (1 doc line, plus output naming)

Have some fun with it

testtest · Joined: 17 May 2004 Posts: 25 Location: Europe

Roderik · Joined: 07 Dec 2003 Posts: 6

works great! thx

irishpadres · Joined: 13 Sep 2003 Posts: 9 Location: Los Angeles, CA

I've come across the problem that if a host is down, the wget process will hang there longer than 5 minutes and throw the entire cactid process out of control. So, I added -t 3 and -T 5 to the wget options to change the number of retries from unlimited to 3 and the timeout to 5 seconds.

-=Kevin=-

Guest · Posted: Sun Aug 15, 2004 1:19 am Post subject:

Hi Irishpadres
where do yo uadd these variables exactly? I think I need these variables to stop cacti showing blank images

irishpadres · Joined: 13 Sep 2003 Posts: 9 Location: Los Angeles, CA

You would modify the ws_apachestats.pl script and change the $RETRIEVER variable from

$RETRIEVER="/usr/bin/wget --user-agent=\"ApacheStats\/0.4 wget\/1.8\" -q -O -";

to

$RETRIEVER="/usr/bin/wget --user-agent=\"ApacheStats\/0.4 wget\/1.8\" -q -O - -t 3 -T 5";

-t is the number of retries
-T is the number of seconds for all timeout values (dns, connect, and read)

Rolf Poser · Joined: 10 Dec 2003 Posts: 42

Thank you very much !

I'll add this to the next version of ApacheStats.

Regards,
Rolf.

Entity · Joined: 02 Oct 2004 Posts: 8

Very nice script and templates. Thanks for sharing them

I'm using Cacti 0.86 and Apache2 and found it working with the directive

allow from 127.0.0.1

The only thing that fooled me at first, was rrdtools complaining about all graphs and CDEFs. It turned out to be some problem with the template import. In the graph templates for the stats I had to step into each "Graph Template Item" which uses any collected data (like CDEFs) and simply save it again or otherwise the datasource wouldn't even be added to the "Graph Items Input" list.

Best regards,

Entity