🎉 Join us at the MCP and Agents Community Party at KubeCon Atlanta on Nov 12
Documentation

Debug kagent#

Troubleshoot and debug issues with your kagent installation.

My agent doesn't seem to be working#

If your agent is not showing up even though you applied the manifest, it's likely because the agent has been rejected by the engine. This error should be reported on the status of the agent.

Run the following command to get the status of the agent:

kubectl get agent -n kagent [agent-name] -o yaml

This should give you the reason why the agent was rejected.

If it's not there, you can try to get the logs of the agent:

kubectl logs -n kagent deployment/kagent -c controller
kubectl logs -n kagent deployment/kagent -c app

You can also ask for help in the community or log an issue on GitHub. You can create a bug report using the kagent CLI by running kagent bug-report. Before attaching files to your bug report, make sure they don't contain any sensitive information!

Kagent Lab: Discover kagent and kmcp
Free, on‑demand lab: build custom AI agents with kagent and integrate tools via kmcp on Kubernetes.