8.5.4.3. Configuring Watchman


Set any of the following parameters in the /etc/sysconfig/watchman file to configure Watchman. This file is available by default starting with OpenShift Enterprise 2.1.4.
Expand
Table 8.6. Watchman Configuration Parameters
Parameter Function
GEAR_RETRIES This sets the number of gear restarts attempted before a RETRY_PERIOD.
RETRY_DELAY This sets the number of seconds to wait before attempting to restart the gear.
RETRY_PERIOD This sets the number of seconds to wait before resetting the GEAR_RETRIES entry.
STATE_CHANGE_DELAY This sets the number of seconds the gear remains broken before Watchman attempts to fix the issue.
STATE_CHECK_PERIOD Available starting with OpenShift Enterprise 2.1.4, this sets the number of seconds to wait since the last check before checking the gear state. Increase this to reduce the impact of the Watchman Gear State plug-in.
THROTTLER_CHECK_PERIOD Available starting with OpenShift Enterprise 2.1.4, this sets the number of seconds to wait before checking the cgroup state of the gear. Increase this to reduce the impact of the Watchman Throttler plug-in.
OOM_CHECK_PERIOD Available starting with OpenShift Enterprise 2.1.4, this sets the number of seconds to wait since the last check before looking for gears under out-of-memory (OOM) state.
Restart the Watchman tool for any changes to take effect:
# service openshift-watchman restart
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top