Collecting the Troubleshooting Information

Alerts

If you encounter issues in your PCF environment, gather and analyse the information associated to the failed action or process. Having this information enables you to detect the component that experiences the failure and resolve the issue faster.

The following table covers the components which might experience an issue, and the logs that contain the information corresponding to the issue.

Issues

Issue

Logs

Deployment errors

Review the following logs to determine the issue. These logs assist you in identifying the component that may be the source of the error.

Use the following commands on the master node:

  • View the available pods and review the pod status:

    kubectl logs -n namespace pod_name 

    Depending on the pod's state, perform the appropriate remediation actions. To understand the pod's states, see States.

  • View the configured helm charts and their status:

    helm list 
  • View the helm chart details for the REST endpoint:

    helm get namespace -pcf-rest-ep 

Communication issues between the NFs

  1. On the master node, run the following command to identify the pod that is responsible for the communication:

    kubectl logs -n namespace pod_name 
  2. Use the tcpdump utility to trace the packets.

Registration and deregistration issues

Use the following command to review the PCF REST endpoint logs:

helm get namespace -pcf-rest-ep 

Ops Center issues

Review the pod's log that hosts the Ops Center to determine the issue.

kubectl logs -n namespace pod_name 
To resolve the issue, if you require the configuration information, then run one of the following commands:
show full-configuration 

Or,

show running-config 

Traffic routing issues

To view the traffic routing-specific logs, use the following configuration:

kubectl get pod -o yaml -n namespace pcf-rest-ep pod_name 
istioctl get virtualservice -n namespace -o yaml 
istioctl get destinationrules -n namespace -o yaml 

Also, review the logs of the following pods:

  • Pcf-rest-ep instance

  • Pcf-engine instance

  • Datastore or Session DB

Subscriber issues

Review the logs associated to the PCF Engine and REST endpoint to determine the issue.

For additional information about the subscriber availability status and the subscriber count in the database, run the following command:

cdl show session count/summary 

Alerts are notification messages that are generated when incidents requiring your attention or response occur. Review the historical and active alerts to determine the issue.

Alerts for PCF are generated through the CEE utility. To view these alerts, run the following command in the CEE Ops Center:

For active alerts:

show alerts active 

For historical alerts:

show alerts history 
Note

You must have appropriate permission to view the alert details.

For information on application-based alerts, see PCF Application-Based Alerts.