|
Big-Brother Integration | Top |
Requirement
BB Client Integration
BB Clients are the Web Servers were mod_benchmark has been installed.
They produce statistics that will be sent to one or more BB Displays.
-
Edit the $LARRDHOME/bf-larrd.sh file and add the "benchmark"
keyword (without quotes) in the BFMETS variable
-
Copy bbclient/benchmark-bf.sh and bbclient/benchmark-alert.pl scripts
under the $LARRDHOME/bf directory
-
Configure the copy of benchmark-bf.sh script:
-
check the value of the DUMPNAME variable (in must be equal to
/dirname/benchmark.dump where "dirname" is the directory name
specified with the BenchmarkWithStatProg Apache directive)
-
gives the full path for benchmark-alert.pl in the ALERTPGM variable
-
Configure the copy of benchmark-alert.pl script:
This script is called by benchmark-bf.sh, its role is to analyze the statistics
and compute the Server status (green, yellow or red). This is the status that will be sent to the BB Display.
Also generates alerts based on definitions of { URI, threshold1, threshold2 } triplets.
Edit the file and adapt the %threshold variable to your own needs.
BB Display Integration
-
Edit the $LARRDHOME/larrd-config.pl script and add the "benchmark" keyword (with the
quotes) in the DATALIST array
-
Edit the $LARRDHOME/larrd-grapher.cgi script, go to the end of the %graph_c
variable declaration. Insert just before the closing parenthesis the content of the
bbdisplay/larrd-benchmark.data
file.
This will define the benchmark graphs
-
Copy bbdisplay/benchmark-larrd.pl under $LARRDHOME
-
Configure the copy of benchmark-larrd.pl to group the statistics into one or more lines
per graph:
the statistics give a mean time per requested URI, but to avoid a real mess on the graph (that could not handle
hundreds or thousands of lines !), we suggest to "group" the URIs by category.
For example, all the "static" pages (HTML, JPG, GIF...) could be gathered on a line and the "dynamic" pages
(JSP, PHP...) could be gathered on another line.
This sorting/gathering is very easy to configure, just edit the file and change the values in the
%urigroups hash table.
Checking
After some few minutes, a new column named "benchmark" should appear on thr Big Brother main page.
The status should be green and when you click on it, the dumped statistics for the Web Site should be displayed
as well the corresponding graph.
|
 |