Bridges Do Not Start
A bridge that waits shows "Pending Creation" in the Management Console, and its status shows the reason. This page explains what each reason means and what to do.
Before umh-core starts a new bridge, it runs bridge admission. A new bridge waits when one of the instance's resources is degraded, when its resource health is not proven yet, or when the instance has reached its bridge limit. The reason says which of the three it is. Bridge admission is on only while agent.enableResourceLimitBlocking is true.
What the reason says
CPU degraded: [message] — the instance's CPU is short on headroom. The message comes from the CPU health check. The CPU Health page explains every status and how to fix it. If the message is "CPU contention" while the machine has free cores, see CPU contention while cores are free. If the message starts with "CPU not measured", umh-core cannot read a file it needs to measure the CPU. The CPU Health page says how to check that file.
Memory degraded: [message] — memory is short. Free memory on the host, or raise the container's memory limit.
Disk degraded: [message] — the disk is short. Free space on the volume, or make the volume larger.
Resource health not proven yet — umh-core has not yet shown the instance's resources to be healthy. A bridge always waits for this proof, so a fresh instance starts no bridges until its first health readings arrive. If the reason stays at "no health reading yet", the instance cannot read its own resources: use the emergency setting below and report it to UMH. The reason "instance not active yet" means the container has not reached the active state; the same advice applies. The reasons "container monitor not available", "container health status unavailable" and "CPU cores not measured yet" also mean umh-core has no reading yet. The same advice applies.
Cannot create bridge - limit exceeded (N bridges maximum with X CPU cores, 1 core reserved for Redpanda) — the instance has reached its bridge limit. The count includes the bridges already running and the waiting bridges listed before this one in config.yaml. The Sizing Guide explains the limit and what raises it.
What to do
Read the reason on the bridge's status.
Fix the resource it names. For CPU, follow the CPU Health page. For the bridge limit, follow the Sizing Guide.
Wait. The bridge starts on its own once the resource is healthy again, or once the instance runs fewer bridges than its limit. Nothing needs to be redeployed.
Emergency settings: Turn off bridge admission
Only if the bridge is needed now, use the emergency setting Turn off bridge admission (agent.enableResourceLimitBlocking: false). It turns off all three checks, including the bridge limit. Edit the instance's Config File:
The setting takes effect without a restart. While it is false, the instance shows as degraded with the reason "Bridge admission is off", so it is not left in place by accident. It is an emergency fallback, not a permanent configuration: while bridge admission is off, nothing stops a new bridge from loading an instance that is already short on resources. Set it back to true once the resource problem is fixed.
After a restart
After a restart, every bridge waits until the instance's resource health is proven. The first bridges in config.yaml order then start, up to the bridge limit. The rest keep waiting with the limit reason, and each starts once the instance runs fewer bridges than its limit, for example after another bridge is removed.
Last updated

