Error handling in checks
Letzte Aktualisierung: 05. März 2011
1. How to handle errors in checks
The way of handling unexpected situations is a crucial point in good software. It should not only make sure that all errors are correctly handled but also keep the actual code as simple and readable as possible.
For that reason Check_MK makes use of Python exceptions. The general rule is
Or lets state it otherwise:
Let's make an example: If the agent is excepted to send the three values name, size and usage in each line of output, then the check should not try to validate this but simply does:
name, size, usage = line
If the agent now sends an invalid line with too few or too many values then Python will raise an exception. That exception will be handled by Check_MK in a very sensible way. It makes the check return UNKNOWN, add an according error message to the check output and logs a detailed error message (debug_log is set to a filename in main.mk).
Please note: In cases where the check expects the agent to send broken ouput in some cases and is nevertheless able to execute the check correctly should handle this. This is sometimes the case for SNMP based checks. Some devices do not support all OIDs so they are missing or empty in the info table provided for the check.
2. saveint and savefloat
In the special case of numbers two helper functions are available. If you convert strings into numbers and the string is empty, the Python functions int and float would raise an Exception.
The functions saveint and savefloat simply ignores exceptions and return 0 and 0.0 in that case.