Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

Sometimes it is necessary to run plugins or local checks asynchronous. Here is a guidance on how to achieve this!

Step-by-step guide

  1. Required settings
    1. Set cache age for plugins and local checks
      1. 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.

      2. Setup → Agents → Windows, Linux, Solaris, AIX → Agent rules → Set cache age for plugins and local checks → Edit rule: Set cache age for plugins and local checks


    2. Set execution mode for plugins and local checks
      1. 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.

        1. Setup → Agents → Windows, Linux, Solaris, AIX → Agent rules → Set execution mode for plugins and local checks → Edit rule: Set execution mode for plugins and local checks

    3. Set timeouts for plugins and local checks
      1. A timeout on plugins and local checks keeps those checks from staling the whole agent. If no timeout is configured here, the default is 60 seconds.

        1. Setup → Agents → Windows, Linux, Solaris, AIX → Agent rules → Set timeouts for plugins and local checks → New rule: Set timeouts for plugins and local checks


  2. Optional settings
    1. Set retry count for plugins and local checks
      1. If set, the plugin may be called repeately - up to this many times or until it finishes successfully.
        1. Setup → Agents → Windows, Linux, Solaris, AIX → Agent rules → Set retry count for plugins and local checks → New rule: Set retry count for plugins and local checks

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


All options are explained here, if you're not able to use agent bakery: https://docs.checkmk.com/latest/en/agent_windows.html#customizeexecution

  • No labels