Troubleshoot your app

In this Topic you will learn how you can troubleshoot your application hosted on Cloud Foundry. This should help you to identify any issues your application or the platform might have. This information might help you to identify and fix the issue your application has on your own, or at least speed up the support process, if the STACKIT Support or Platform Team has to jump in to help.

Collect diagnostic information

There are some first steps on how you can investigate an incident in your application on your own. Here is what might help.

Application states

Once you are logged in with the cf-cli to your org and space you can see a list of the apps deployed in your space and their requested state with the command:

cf apps

You can also get detailed information about the state and healthiness of the containers within your app with the command:

cf app <APPNAME>

There you will see some metrics like the state, cpu-, memory- and disk-space-usage of your containers, that might already be an indicator for troubles.

Application logs

You can checkout the logs of your space and application streamed in real time with the command:

cf logs <APPNAME>

The log-output might give you some information about errors in your application or the platform.

You can also drain the log information into an external log service like STACKIT LogMe. We recommend to use such an external service to analyze and visualize your log output for any critical applications.

Environment variables

Environment variables are the way, how the platform is communicating with your application. Environment variables in an unexpected state might be a root cause for your incidents.

You can check your applications environment variables with the command:

cf env

Find out more about how to set and unset environment variables in “Manage environment variables and secrets”.

Collect support information

At some times an incident can be caused by an issue with the platform. In those cases please don’t hesitate to open a ticket with the STACKIT Support.

In order for the Support and Platform Teams to be able to help you as fast as possible you should gather some information.

We definitely need the Platform, Organisation and Space your Application or Service is running in, you can just find this information by using the command:

cf target

This will give you your currently targeted API, space and organisation.

• We need the API-endpoint value in order to see, if you are using the internal or public Cloud Foundry Instance.
• We need the Org value to see which org are you using for your application.
• We need the Space value to see where exactly we could find your application for further diagnostics.

Additionally at times it also can help to have your STACKIT Project ID at hand, you can read this ID out from the URL of your project in the STACKIT Portal as seen in the image below.

Common issues

You can find a good list of common issues and how to potentially fix them the official Cloud Foundry documentation about common issues.