The New Check API

1. The New Check API

As you have learned in previous articles, a check must be declared to Checkmk. In the old times this had be done with a line like this:

check_info["uptime"] = (check_uptime, "Uptime", 1, inventory_uptime)

As of version 1.2.0 Checkmk offers an alternative dictionary based declaration:

check_info["uptime"] = {
    "inventory_function"  : inventory_uptime,
    "check_function"      : check_uptime,
    "has_perfdata"        : True,
    "service_description" : "Uptime",
}

This new style has the advantage that it also covers further keys that had been kept in special variables, which now become obsolete. Here is a more complex example (from the df check):

check_info['df'] = {
    "check_function"          : check_df,
    "inventory_function"      : inventory_df,
    "service_description"     : "fs_%s",
    "has_perfdata"            : True,
    "group"                   : "filesystem",
    "default_levels_variable" : "filesystem_default_levels",
    "includes"                : [ "df.include" ],
}

2. Available Parameters for check_info[mycheck]

The following table lists all possible keys in the new dictionary-type declaration. The only mandatory parameters are check_function and service_description: