Munin contributed plugins

even being bootstrapped, and this crucial error may be logged in an apache

log or in syslog.

This plugin attempts to give visibility into all such "important events"

that may affect the proper functioning of a given service. It attempts to

answer the question, "Is my service running normally?".

should be taken. To try to help with this, the plugin uses the extinfo

field to list which logs currently have important events in them.

and providing different configuration for each instance. In general, you

should think of a single instance of this plugin as representing a single

class of services.

=head2 EXAMPLE CONFIGS

This example uses services autoconf:

	env.my_special_service_warning 100

This example DOESN'T use services autoconf:

	[service_events]

	user root

	env.services auth.example.com admin.example.com www.example.com

    env.auth_example_com_logbinding my-custom-binding[0-9]+

	env.cfxsvc_logfiles /srv/*/*/logs/app.log

	env.cfxsvc_regex error|alert|crit|emerg

	env.phpfpm_logfiles /srv/*/*/logs/php-fpm*.log

	env.phpfpm_regex Fatal error

	env.apache_logfiles /srv/*/*/logs/errors.log

	env.apache_regex error|alert|crit|emerg

	env.warning 1

	env.critical 5

	env.auth_example_com_warning 100

	env.auth_example_com_critical 300

	env.www_example_com_warning 50

	env.www_example_com_critical 100

This graph will ONLY ever show values for the three listed services, even

if other services are installed whose logfiles match the logfiles search.

Also notice that in this example, we've only listed a log binding for the

auth service. The plugin will use the service name by default for any

services that don't specify a log binding, so in this case, auth has a

custom log binding, while all other services have log bindings equal to

their names.

    echo "graph_info Lists number of matching lines found in various logfiles associated with each service. Extinfo displays currently affected logs."

    local n svcnm varnm service svc svc_counter logbinding logfile lognm logmatch prvlines curlines matches extinfo_var

        # Get previous line count to determine whether or not the file may have been rotated (defaulting to 0)

        prvlines="${prvlines:-0}"

        # Get the current number of lines in the file (defaulting to 0 on error)

        curlines="${curlines:-0}"

        # If there were matches, aggregate them and add this log to the extinfo for the service

        if [ "$matches" -gt 0 ]; then

            # Aggregate and add to the correct service counter

            svc_counter="${svcnm}_total"

            !((matches+=${!svc_counter}))

            typeset "$svc_counter=$matches"

            # Add this log to extinfo for service

            extinfo_var="${svcnm}_extinfo"

            typeset "$extinfo_var=${!extinfo_var}$logfile, "

        fi

        extinfo_var="${svcnm}_extinfo"

        echo "${svcnm}.extinfo ${!extinfo_var}"