Using Spring Boot Actuators with Apps Manager

This document describes how to view and manage app information from Spring Boot Actuator in Apps Manager.

Prerequisites

The Apps Manager integration with Spring Boot Actuator requires the following:

View Build and Git Information for Your App

To view the data that your app sends to its /info Actuator endpoint, select the Settings tab:

Info

In the upper right of the app page, Apps Manager also displays the SHA of your app code repository from the latest build:

Git sha

View App Health

To view the health-check data that your app sends to its /health Actuator endpoints, select the Overview tab and click an instance under the Instances section:

Info

View Thread Dump

To trigger and view a thread dump from your app to its /dump Actuator endpoint, select the Threads tab and click Refresh.

Thread Dump

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 drop-down menus.

View Request Traces

To retrieve and view tracing information from the /trace Actuator endpoint of your app, select the Trace tab and click Refresh.

Trace

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 drop-down menu.

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 Pivotal Apps Manager Requests checkbox next to the Instance drop-down menu.

Download Heap Dump

To trigger and view a heap dump from your app to its /heapdump endpoint, select the settings drop-down menu for an instance of your app and click Heap Dump. This downloads a .zip file.

Heap dump

Manage Log Levels

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 and click Configure Logging Levels.

Configure Logging Levels

Apps Manager displays the default log level for each logger in gray.

Defaults

You can modify the log level for a logger by clicking the desired level in the logger row, as shown in the image below. Whenever you set a log level, the following happens:

  • The log level displays in blue to indicate that it is user-configured.
  • Each child namespace of the logger inherits the log level.

    Note: You can manually set any of the child loggers to override this inheritance.

Set Log level

All of the loggers with user-configured logging levels float to the top of the list.

Float to top

You can reset log levels by clicking the white dot displayed on the current log level.

Reset Logs

You can also filter which loggers you see using the Filter Loggers textbox.

Filter Loggers

Troubleshoot Spring Boot Actuator Integration

This section describes how to troubleshoot common issues with the integration of Apps Manager and Spring Boot Actuator.

/cloudfoundryapplication Failed Request

Symptom

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

Explanation

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.

Solution

If you are not using the Spring Boot Actuator integrations for Apps Manager, you can ignore this failed request message.

Create a pull request or raise an issue on the source for this page in GitHub