Debugging application issues
Check your deploy command output to see whether it succeeded or not. If your deployment process was terminated, you should see an error message in the output that describes the reason why the deployment failed.
This kind of failure is most likely due to either a misconfigured manifest or wrong command. For example, the following output says that you must configure route traffic percent to sum to 100:
Run the following command to get the of the Route
object with which you deployed your application:
kubectl get route <route-name> --output yaml
The conditions
in status
provide the reason if there is any failure. For details, see Knative Error Conditions and Reporting.
To list all Ingress resources and their corresponding labels, run the following command:
NAME LABELS
helloworld-go map[serving.knative.dev/route:helloworld-go serving.knative.dev/routeNamespace:default serving.knative.dev/service:helloworld-go]
The labels serving.knative.dev/route
and serving.knative.dev/routeNamespace
indicate the Route in which the Ingress resource resides. Your Route and Ingress should be listed. If your Ingress does not exist, the route controller believes that the Revisions targeted by your Route/Service isn’t ready. Please proceed to later sections to diagnose Revision readiness status.
Otherwise, run the following command to look at the ClusterIngress created for your Route
kubectl get ingresses.networking.internal.knative.dev <INGRESS_NAME> --output yaml
Now, if Ingress shows status , there must be a corresponding VirtualService. Run the following command:
the network configuration in VirtualService must match that of Ingress and Route. VirtualService currently doesn’t expose a Status field, so if one exists and have matching configurations with Ingress and Route, you may want to wait a little bit for those settings to propagate.
If you are familar with Istio and istioctl
, you may try using istioctl
to look deeper using Istio .
Check Ingress status
Knative uses a LoadBalancer service called istio-ingressgateway
Service.
To check the IP address of your Ingress, use
kubectl get svc -n istio-system istio-ingressgateway
If there is no external IP address, use
kubectl describe svc istio-ingressgateway -n istio-system
to see a reason why IP addresses weren’t provisioned. Most likely it is due to a quota issue.
kubectl get configuration <configuration-name> --output jsonpath="{.status.latestCreatedRevisionName}"
If you configure your Route
with Revision
directly, look up the revision name in the Route
yaml file.
Then run the following command:
A ready should have the following condition in status
:
conditions:
status: "True"
type: Ready
If you see this condition, check the following to continue debugging:
Tip
If you see other conditions, you can look up the meaning of the conditions in Knative . An alternative is to check Pod status.
To get the Pod
s for all your deployments:
kubectl get pods
NAME READY STATUS RESTARTS AGE
configuration-example-00001-deployment-659747ff99-9bvr4 2/2 Running 0 3h
Choose one and use the following command to see detailed information for its status
. Some useful fields are conditions
and :