This document describes how to view and manage app information from Spring Boot Actuator in Apps Manager.
The Apps Manager integration with Spring Boot Actuator requires:
A TAS for VMs user with the SpaceDeveloper
role. For more information, see App Space Roles.
Spring Boot v1.5 or later.
Completing the procedures in Configure Spring Boot Actuator Endpoints for Apps Manager.
After you configure your app, Apps Manager displays the Spring Boot logo next to the name of your app on the app page.
To view the data that your app sends to its /info
Actuator endpoint, select the Settings tab:
In the upper right of the app page, Apps Manager also displays the SHA of your app code repository from the latest build:
To view the health-check data that your app sends to its /health
Actuator endpoints:
Select the Overview tab.
Click an instance under the Instances section:
To trigger and view a thread dump from your app to its /dump
Actuator endpoint:
Select the Threads tab.
Click Refresh.
You can click each thread to expand and view its details. You can also modify which threads appear on the page using the Instance and Show dropdowns.
To retrieve and view tracing information from the /trace
Actuator endpoint of your app:
Select the Trace tab.
Click Refresh.
This page displays the last 100 requests from your app. You can click each individual request to expand and view its trace details. You can modify which requests appear on the page using the Instance dropdown.
By default, the Trace tab does not show requests and responses from Apps Manager polling app instances for data. To include these requests, clear the Hide Apps Manager Requests checkbox next to the Instance dropdown.
To trigger and view a heap dump from your app to its /heapdump
endpoint:
Select the settings dropdown for an instance of your app.
Click Heap Dump. This downloads a .zip
file.
To view a collated list of the endpoints an app serves:
Select the Settings tab.
Click View Mappings.
Spring Boot apps include loggers for many provided and user components of the app. You can set the log level for each logger in Apps Manager.
To view the Configure Logging Levels screen:
Select the Logs tab.
Click Configure Logging Levels.
Apps Manager displays the default log level for each logger in gray.
You can change the log level for a logger by clicking the desired level in the logger row, as shown in the following image. Whenever you set a log level, the following happens:
Each child namespace of the logger inherits the log level.
Note You can manually set any of the child loggers to override this inheritance.
All of the loggers with user-configured logging levels go to the top of the list.
You can reset log levels by clicking the white dot displayed on the current log level.
You can also filter which loggers you see using the Filter Loggers text box.
This section describes how to troubleshoot common issues with the integration of Apps Manager and Spring Boot Actuator.
You see the following failed request message in your app logs:
Could not find resource for relative : /cloudfoundryapplication of full path: http://example.com/cloudfoundryapplication
Apps Manager uses the /cloudfoundryapplication
endpoint as the root for Spring Boot Actuator integrations. It calls this endpoint for an app when you view the app in the Apps Manager UI, regardless of whether you have configured Spring Boot Actuator endpoints for Apps Manager.
If you are not using the Spring Boot Actuator integrations for Apps Manager, you can ignore this failed request message.