New CAS documentation site

CAS documentation has moved over to apereo.github.io/cas, starting with CAS version 4.x. The wiki will no longer be maintained. For the most recent version of the documentation, please refer to the aforementioned link.

Overview

Here is a plugins for those who are interested to check cas service by nagios and if available, it displays performance data.

The plugin makes a cas authentication to display service status, so you need a valid CAS account for make it working. For retrieving performance data it does a login into the CAS service managment application and look for the "<nagiosPerformanceData></nagiosPerformanceData>" tags. The user account needs rights to acces the service managment application to get performance data.

Here an example to call the plugin :

perl check_cas.pl -H cas.example.fr -u "/cas/login" -p 443 -l username -a password -r "Log In Successful"

Download

https://github.com/petegallagher/nagios-cas-plugin

Performance data

To activate performance data, you have to add these lines in "WEB-INF/view/jsp/services/viewStatistics.jsp" just before tag "<%@include file="includes/bottom.jsp" %>" :

<!--
Nagios Performance data

Performance data is defined by Nagios as "everything after the | of the plugin output" - please refer to Nagios documentation for information on capturing this data to logfiles. However, it is the responsibility of the plugin writer to ensure the performance data is in a "Nagios plugins" format. This is the expected format:

'label'=value[UOM];[warn];[crit];[min];[max]

Notes:
  1. space separated list of label/value pairs
  2. label can contain any characters
  3. the single quotes for the label are optional. Required if spaces, = or ' are in the label
  4. label length is arbitrary, but ideally the first 19 characters are unique (due to a limitation in RRD). Be aware of a limitation in the
amount of data that NRPE returns to Nagios
  5. to specify a quote character, use two single quotes
  6. warn, crit, min or max may be null (for example, if the threshold is not defined or min and max do not apply). Trailing unfilled semicolons can be dropped
  7. min and max are not required if UOM=%
  8. value, min and max in class [-0-9.]. Must all be the same UOM
  9. warn and crit are in the range format (see Section 2.5). Must be
the same UOM
 10. UOM (unit of measurement) is one of:
        1. no unit specified - assume a number (int or float) of things
(eg, users, processes, load averages)
        2. s - seconds (also us, ms)
        3. % - percentage
        4. B - bytes (also KB, MB, TB)
        5. c - a continous counter (such as bytes transmitted on an interface)

It is up to third party programs to convert the Nagios plugins performance data into graphs.

<nagiosPerformanceData>'Unexpired TGTs'=${unexpiredTgts};;;; 'Unexpired STs'=${unexpiredSts};;;; 'Expired TGTs'=${expiredTgts};;;; 'Expired STs'=${expiredSts};;;;</nagiosPerformanceData>
-->

The plugins just get the data betweens "nagiosPerformanceData" and add it after the plugins state. If data are not well formated, performance data will not work.