Werk #20119: Deprecate Python module livestatus, use cmk.livestatus_client
| Component | Livestatus | ||
| Title | Deprecate Python module livestatus, use cmk.livestatus_client | ||
| Date | Jul 3, 2026 | ||
| Level | Prominent Change | ||
| Class | New Feature | ||
| Compatibility | Incompatible - Manual interaction might be required | ||
| Checkmk versions & editions |
|
The Python module livestatus, which ships inside every Checkmk site, is deprecated as of this version.
It will be removed in a future version of Checkmk.
The module has been a thin compatibility wrapper since Checkmk 2.3: the actual implementation lives in the cmk.livestatus_client namespace.
Checkmk itself no longer uses the old module at all.
Who is affected
You are affected if you run your own scripts or tools inside a Checkmk site that use the Livestatus Python API, i.e. anything doing
import livestatus
or
from livestatus import MultiSiteConnection
How to migrate
Simply replace the module name in your imports — the API itself is unchanged:
import cmk.livestatus_client as livestatus
or
from cmk.livestatus_client import MultiSiteConnection
You can start right away
The cmk.livestatus_client namespace is available inside sites since Checkmk 2.3.0.
So you can (and should) migrate your scripts as soon as possible — you can do so even before upgrading to Checkmk 3.0.