Stephen Quinney

NAME

BuzzSaw::Filter::Kernel - A BuzzSaw event filter for kernel log entries

VERSION

This documentation refers to BuzzSaw::Filter::Kernel version 0.12.0

SYNOPSIS

   my $filter = BuzzSaw::Filter::Kernel->new();

   while ( defined( my $line = $fh->getline ) ) {
     my %event = $parser->parse_line($line);

     my ( $accept, @tags ) = $filter->check(\%event);

     if ($accept) {
        # store log entry in DB
     }
   }

DESCRIPTION

This is a Moose class which provides a filter which implements the BuzzSaw::Filter role. It is used to filter log entries and find those associated with the Linux kernel. The module attempts to spot important issues, it currently supports checking for segfaults, Out-Of-Memory (OOM) issues, kernel panics and oops. When an event is accepted by the Kernel filter module it returns a kernel tag along with one of segfault, oops, oom or panic.

The BuzzSaw project provides a suite of tools for processing log file entries. Entries in files are parsed and filtered into a set of events of interest which are stored in a database. A report generation framework is also available which makes it easy to generate regular reports regarding the events discovered.

ATTRIBUTES

There are no attributes in this class.

SUBROUTINES/METHODS

( $accept, @tags ) = $filter->check(\%event)

This method checks for log entries which are associated with important kernel issues. It does this by firstly looking for lines where the program attribute is set to kernel. If that matches then it looks checks the message to see if there is evidence of a segfault, oom, oops or panic. If an event is accepted for storage then the accept variable will be set to true and a set of tags will be returned which contain kernel and one of segfault, oops, oom or panic.

DEPENDENCIES

This module is powered by Moose. This module implements the BuzzSaw::Filter Moose role.

SEE ALSO

BuzzSaw, BuzzSaw::Parser

PLATFORMS

This is the list of platforms on which we have tested this software. We expect this software to work on any Unix-like platform which is supported by Perl.

ScientificLinux6

BUGS AND LIMITATIONS

Please report any bugs or problems (or praise!) to bugs@lcfg.org, feedback and patches are also always very welcome.

AUTHOR

    Stephen Quinney <squinney@inf.ed.ac.uk>

LICENSE AND COPYRIGHT

    Copyright (C) 2012 University of Edinburgh. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the terms of the GPL, version 2 or later.