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.


www.trickytools.com