Troubleshooting
Investigate integration, connectivity, and configuration problems.
Find guidance on DropPoints, certificates, authentication, Node upgrades, and Runtime errors.
9 Articles
Apps Troubleshooting v2
Use this checklist when a Flowgear App does not load, invoke a Workflow, publish, or appear in a Site.
Builder MCP Troubleshooting v2
Use this checklist when a Builder MCP client cannot connect, discover context, call Tools, Debug, or save a Workflow.
Local Cluster Troubleshooting v2
Use this checklist when a Workflow cannot select, save, Debug, publish, or run on a local Cluster.
Mapping and Expression Errors v2
Use the diagnostic Code, Path, message, and Expected shape in Problems to identify the failing Property.
MCP Authentication and Hostname Troubleshooting v2
Use this checklist when a Workflow or Builder MCP client cannot reach Flowgear, discover OAuth, authenticate, list tools, or call an eligible Workflow.
Missing or Incomplete Log Data v2
A missing value can be caused by search scope, execution state, redaction, deferred enumeration, size handling, storage failure, or a different activation context.
Workflow Is Slow v2
Use Step timings and data-flow shape to locate provider latency, clustter routing delay, unnecessary or inefficient enumeration, logging overhead, or a constrained downstream consumer.
Workflow Will Not Compile v2
Compilation errors occur when there is an invalid Workflow design or a dependency cannot be referenced.
Workflow Will Not Run v2
Determine whether the failure occurs before activation, due to Cluster choice, at a trigger or authorization boundary, or inside a Step.