Asynchronous execution of Windows plugins

Owned by Anastasios Thomaidis
Last updated: Oct 08, 2024 by Matthew Hierholzer
Sometimes it is necessary to run plugins or local checks asynchronously. Here is guidance on how to achieve this!

LAST TESTED ON CHECKMK 2.3.0P1

Table of Contents

Step-by-step guide

Required settings

Set cache age for plug-ins and local checks

A cache age limit on plugins and local checks. If set, the output of plugins is cached and reused until this much time has passed.

Setup → Agents → Windows, Linux, Solaris, AIX → Agent rules → Set cache age for plug-ins and local checks → Add rule

Set execution mode for plug-ins and local checks

Some scripts are slow and can therefore stall the execution of the agent. To remedy this, such scripts may be run asynchronously. With this rule, asynchronous execution can be set on a per-script basis.

Setup → Agents → Windows, Linux, Solaris, AIX → Agent rules → Set execution mode for plug-ins and local checks → Add rule

Set timeouts for plug-ins and local checks

A timeout on plugins and local checks keeps those checks from stalling the whole agent. If no timeout is configured here, the default is 60 seconds.

Setup → Agents → Windows, Linux, Solaris, AIX → Agent rules → Set timeouts for plug-ins and local checks → Add rule


Optional settings

Set retry count for plug-ins and local checks

If set, the plugin may be called repeatedly - up to this many times or until it finishes successfully.

Setup → Agents → Windows, Linux, Solaris, AIX → Agent rules → Set retry count for plug-ins and local checks → Add rule


Please don't forget to set some conditions!

About the pattern: The pattern (wildcards supported) by which to select the affected scripts.

Recommended values for caching and timeout: >60 seconds


If you are not using the agent bakery, check this documentation page to see how to manually perform the configuration.