| Safe Haskell | None |
|---|---|
| Language | Haskell2010 |
System.Nagios.Plugin
- data CheckStatus
- data CheckResult
- data NagiosPlugin a
- runNagiosPlugin :: NagiosPlugin a -> IO ()
- runNagiosPlugin' :: NagiosPlugin a -> IO (a, CheckState)
- addPerfDatum :: Text -> PerfValue -> UOM -> Maybe PerfValue -> Maybe PerfValue -> Maybe PerfValue -> Maybe PerfValue -> NagiosPlugin ()
- addPerfData :: ToPerfData a => a -> NagiosPlugin ()
- addBarePerfDatum :: Text -> PerfValue -> UOM -> NagiosPlugin ()
- addResult :: CheckStatus -> Text -> NagiosPlugin ()
- checkStatus :: CheckResult -> CheckStatus
- checkInfo :: CheckResult -> Text
- worstResult :: [CheckResult] -> CheckResult
- finishState :: CheckState -> (CheckStatus, Text)
- data UOM
- = Second
- | Millisecond
- | Microsecond
- | Percent
- | Byte
- | Kilobyte
- | Megabyte
- | Gigabyte
- | Terabyte
- | Counter
- | NullUnit
- | UnknownUOM
- data PerfValue
- data PerfDatum = PerfDatum {}
- class ToPerfData a where
- toPerfData :: a -> [PerfDatum]
- barePerfDatum :: Text -> PerfValue -> UOM -> PerfDatum
Plugin types and control flow
data CheckStatus Source
Nagios plugin exit statuses. Ordered by priority -
OK < Warning < Critical < Unknown, which correspond to plugin exit
statuses of 0, 1, 2, and 3 respectively.
Constructors
| OK | Check executed successfully and detected no service problems. |
| Warning | Nothing's actually broken but this should be followed up. |
| Critical | Check executed successfully and detected a service failure. |
| Unknown | Check unable to determine service status. |
Instances
data CheckResult Source
A CheckResult is the exit status of the plugin combined with the
plugin's info text. A NagiosPlugin which exits with
CheckResult (Critical "entropy decreasing in closed system")
as its peak-badness CheckResult (and no PerfDatums) will a) exit with
status 2 and b) output the text "CRITICAL: entropy decreasing in closed
system".
Instances
data NagiosPlugin a Source
runNagiosPlugin :: NagiosPlugin a -> IO () Source
Execute a Nagios check. The program will terminate at the check's completion. A default status will provided if none is given.
runNagiosPlugin' :: NagiosPlugin a -> IO (a, CheckState) Source
Execute a Nagios check as with runNagiosPlugin, but return its
final state rather than terminating.
Arguments
| :: Text | Name of the quantity being measured. |
| -> PerfValue | Measured value. |
| -> UOM | Unit of the measured value. |
| -> Maybe PerfValue | Minimum threshold. |
| -> Maybe PerfValue | Maximum threshold. |
| -> Maybe PerfValue | Warning threshold. |
| -> Maybe PerfValue | Critical threshold. |
| -> NagiosPlugin () |
Insert a performance metric into the list the check will output.
addPerfData :: ToPerfData a => a -> NagiosPlugin () Source
Alternative mechanism for adding perfdata generated from complex
types; just implement the toPerfData typeclass.
Arguments
| :: Text | Name of the quantity being measured. |
| -> PerfValue | Measured value. |
| -> UOM | Unit of the measured value. |
| -> NagiosPlugin () |
Convenience function to insert a perfdatum without thresholds for min, max, warn or crit. Note that unless the range of the metric is actually unbounded, specifying explicit thresholds is considered good practice (it makes life easier for authors of graphing packages).
FIXME: implement thresholds properly and default to negative and positive infinity for min and max here.
addResult :: CheckStatus -> Text -> NagiosPlugin () Source
Insert a result. Only the CheckStatus with the most badness
will determine the check's exit status.
checkStatus :: CheckResult -> CheckStatus Source
Extract the return status from a CheckResult.
checkInfo :: CheckResult -> Text Source
Extract the infotext from a CheckResult.
worstResult :: [CheckResult] -> CheckResult Source
Returns result with greatest badness, or a default UNKNOWN result if no results have been specified.
finishState :: CheckState -> (CheckStatus, Text) Source
Given a check's final state, return the status and output it would exit with.
Nagios performance data
A Nagios "unit of measure". NoUOM translates to an empty
string in the check output; it is idiomatic to use it liberally
whenever the standard units do not fit.
Constructors
| Second | |
| Millisecond | |
| Microsecond | |
| Percent | |
| Byte | |
| Kilobyte | |
| Megabyte | |
| Gigabyte | |
| Terabyte | |
| Counter | |
| NullUnit | |
| UnknownUOM | Deprecated: Will be removed in 0.4.0 in favour of failing on parse. |
Value of a performance metric.
Constructors
| RealValue Double | |
| IntegralValue Int64 |
One performance metric. A plugin will output zero or more of these,
whereupon Nagios generally passes them off to an external system such
as RRDTool or
Vaultaire.
The thresholds are purely informative (designed to be graphed), and
do not affect alerting; likewise with _min and _max.
Constructors
| PerfDatum | |
Fields
| |
class ToPerfData a where Source
Methods
toPerfData :: a -> [PerfDatum] Source