Skip to content

Folder Pools

Folder Pools distribute hosts automatically across a set of predefined folders — useful when you want to spread hosts across multiple Checkmk remote sites or when you need balanced folder sizes.

Go to: Modules → Checkmk → Folder Pools

How It Works

Each Folder Pool has a seat count that defines the maximum number of hosts the folder can hold. The Syncer assigns incoming hosts to folders that still have available seats. When a host is removed or its pool assignment no longer matches, its seat is freed automatically.

The Syncer creates the folders in Checkmk automatically. Link them to your remote sites in Checkmk to distribute monitoring across sites.

Configuration

Create a Folder Pool entry with:

  • Name — used to reference the pool in export rules
  • Folder Name — the Checkmk folder path
  • Seat Count — maximum number of hosts in this folder
  • Assigned Site ID — (optional) the Checkmk site ID to associate with this pool

Using a Pool in Export Rules

In an export rule, use the Pool Folder action and reference the pool by name. If you leave the action parameter empty, the Syncer queries from all available pools. To restrict assignment to specific pools, provide a comma-separated list of pool names:

pool_site_a,pool_site_b

This ensures a host is only placed in one of the listed pools, ignoring any others.

Note

Folder Pool rules stack with other folder rules. Use the Last Match option on the pool rule to prevent unintended stacking with other folder assignments.

Sync Command

To synchronize pool state without running a full export:

./cmdbsyncer checkmk sync_folder_pools ACCOUNTNAME

Auto-creating Pools with Autocreate Rules

For environments where the set of sites changes frequently, you can use the Autocreate Rules feature to generate Folder Pool entries automatically based on imported site objects.