Troubleshooting#

GRPC Endpoint Not Responding

If grpcurl or any client fails to connect:

  • Check that Flowkit is running and listening on :50051

  • Confirm port forwarding if running inside Docker

  • Ensure firewall or network rules don’t block access

“function not registered” Error

This error indicates a missing or misnamed function. Make sure:

  • You called RegisterFunction() in main.go

  • The function name exactly matches the GRPC request

  • The function is included before the GRPC server starts

Empty or Broken Streaming Output

When using StreamFunction, your Go function must:

  • Have Stream: true in the registration metadata

  • Use a goroutine to emit multiple FunctionResponse messages

  • Handle ctx cancellation to exit early when the client disconnects

Agent Doesn’t Respond

If Flowkit forwards calls to the Agent and nothing happens:

  • Verify the Agent is running and reachable

  • Check logs on both Agent and Flowkit for errors

  • Confirm that input contains all required fields for the Agent logic