Tanzu Platform SaaS

Troubleshooting your business applications

Last Updated February 19, 2025

A business application is a grouping of multiple component apps and microservices that work together to achieve a specific business outcome. Creating a business application allows you to focus on the applications and services that are pertinent to your application. This allows you to quickly identify potential problem areas and understand how the application is behaving. You can drill down into individual component apps or microservices to access rich information about their performance and behavior.

For information about creating business applications in Tanzu Platform, see Create business applications in Tanzu Platform.

View business applications

To view your business applications in the Tanzu Platform UI, on the left navigation pane, go to Applications > Business Applications.

You can see the Status chart and the list of business applications.

The Business Applications page shows the Status chart and the list of business applications.

The Status chart shows the following data:

  • The Total number of your business applications.
  • The number of the business applications per status. The status of a business application is based on the statuses of the applications within that business applications.

    StatusDescription
    RunningAll applications within the business application are running
    Partial RunningOne or more applications within the business application have stopped
    StoppedAll applications within the business application have stopped
    UnknownNo information about the applications within the business application

Find a business application

The Business Applications page also contains a table list of the discovered business applications. You can:

  • Filter by status by clicking a status on the pie chart or the legend of the Status chart.
  • Search by name.
  • Sort by the properties in the table columns.

    PropertyDescription
    Name

    The name of the business application.

    For an application on Kubernetes, this is the name of the Kubernetes namespace.

    For an application on Cloud Foundry, this is the name of the Cloud Foundry cluster.

    ComponentsThe number of components that the business application has.
    App StatusThe status of the business application. The status can be running, partially running, stopped, or unknown.
    Last UpdatedHow long ago the business application was discovered and created in Tanzu Platform

Examine a business application

You can drill down into the topology of an application to examine its components, their dependencies, and statuses. This is useful if a business application is not in the running status.

On the Business Applications page, click the name of the business application you want to examine. The business application details page opens.

The Business Application detail page shows a topology map and dynamic info on the right.

On the details page, you can examine the topology maps of the business application. To switch between the two topology maps, use the selector on the top left.

Topology MapDescription
Logical App

Shows the dependencies and the dependents of the business application. An arrow between two components indicates a dependency and its direction. The text on an arrow indicates the type of relationship between the dependent components.
In the example:

1 - tasreleng is the Cloud Foundry organization or the attached Cloud Foundry data source that provides this information.

2 - trainstat is the business application that maps to the Cloud Foundry Space. This business application is contained in the Cloud Foundry organization, and contains an application and a service.

3 - tas-trainstat is the application and trainstat-redis is the service within this Cloud Foundry Space.

PlatformShows a high-level overview of the components that make up the application platform in the scope of the business application. This includes details about components such as application services, availability zones, routes, foundation, and how your business application depends on these components. If a Business Applications is comprised of more than one Tanzu Platform Space or Kubernetes namespace, they will show up here in the Platform view.

A red dot in a component on the map indicates that this component is not running and needs attention.

When you click a component on a topology map, the panels on the right dynamically show the following information for the selected component:

PanelDescription
PropertiesShows the configuration details of the component that is selected on the topology map. For example, if you click a Spring application on the topology map, this panel shows the collected actuator-based Spring application configuration key values and Git information. You can examine the history of the changes of the properties.
DependenciesA textual representation of the dependencies of the component that is selected on the topology map