Jitterbit · Private agents
Agent is incapable to process this message
Short answer
This Jitterbit ProcessEngine.log message means the agent has no free capacity, because every worker thread is in use or a capability metric reached its threshold. Review ProcessEngine.log for repeated capability status changes.
VerifiedLast verified
01Error text
Agent (Id: ...) is incapable to process this message. Message will be auto-retried.
Capability status changed from true to false02Likely causes
- Every worker thread in the process engine is in use.
- An optional capability metric (CPU, memory or Apache thread usage) is enabled and has reached its threshold.
- A single agent in the group handles more load than it can sustain while others are idle.
03How to fix it
- Review
ProcessEngine.logfor repeated capability status changes. - If many operations run at once, consider a conservative increase in
MaxNumberOfWorkerThreads. - Check which metrics are enabled in
[AgentCapability]and the host CPU and memory at the time of the issue. - If limits are consistently reached, add agents to the group.
04Official documentation
→Related errors
- Agent Not Running or UnreachableThis Jitterbit Studio message means the private agent services are not running or the agent host cannot reach the Harmony cloud. If the services are not running, start them. If a start fails, check the agent logs.
- Failed to find file in the local file storeThis Jitterbit transformation error means deployment metadata for a file did not fully sync from Harmony to the agent, which is usually transient. Re-run the operation. On agent 11.38 and later the metadata is restored on the next environment sync.
- Error 1720 or 1722 on Windows installationError 1720 or 1722 when installing the Jitterbit private agent on Windows usually comes from the bundled PostgreSQL, a missing Visual C++ Redistributable or leftovers from a previous agent. Install the 64-bit Microsoft Visual C++ Redistributable before the agent, and keep it installed.
Test every fix in a non-production environment before you apply it to production. See how entries are verified.
More for Jitterbit work:Open Jitterbit jobsJitterbit rates and salaries