Application Startup (startup)

The startup endpoint provides information about the application’s startup sequence.

Retrieving the Application Startup Steps

The application startup steps can either be retrieved as a snapshot (GET) or drained from the buffer (POST).

Retrieving a snapshot of the Application Startup Steps

To retrieve the steps recorded so far during the application startup phase, make a GET request to /actuator/startup, as shown in the following curl-based example:

$ curl 'http://localhost:8080/actuator/startup' -i -X GET

The resulting response is similar to the following:

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 889

{
  "springBootVersion" : "3.3.5",
  "timeline" : {
    "startTime" : "2024-10-24T11:38:18.351618412Z",
    "events" : [ {
      "endTime" : "2024-10-24T11:38:18.759531312Z",
      "duration" : "PT0.000006352S",
      "startTime" : "2024-10-24T11:38:18.759524960Z",
      "startupStep" : {
        "name" : "spring.beans.instantiate",
        "id" : 3,
        "tags" : [ {
          "key" : "beanName",
          "value" : "homeController"
        } ],
        "parentId" : 2
      }
    }, {
      "endTime" : "2024-10-24T11:38:18.759538195Z",
      "duration" : "PT0.000020599S",
      "startTime" : "2024-10-24T11:38:18.759517596Z",
      "startupStep" : {
        "name" : "spring.boot.application.starting",
        "id" : 2,
        "tags" : [ {
          "key" : "mainApplicationClass",
          "value" : "com.example.startup.StartupApplication"
        } ]
      }
    } ]
  }
}

Draining the Application Startup Steps

To drain and return the steps recorded so far during the application startup phase, make a POST request to /actuator/startup, as shown in the following curl-based example:

$ curl 'http://localhost:8080/actuator/startup' -i -X POST

The resulting response is similar to the following:

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 888

{
  "springBootVersion" : "3.3.5",
  "timeline" : {
    "startTime" : "2024-10-24T11:38:18.351618412Z",
    "events" : [ {
      "endTime" : "2024-10-24T11:38:18.662003164Z",
      "duration" : "PT0.000199003S",
      "startTime" : "2024-10-24T11:38:18.661804161Z",
      "startupStep" : {
        "name" : "spring.beans.instantiate",
        "id" : 1,
        "tags" : [ {
          "key" : "beanName",
          "value" : "homeController"
        } ],
        "parentId" : 0
      }
    }, {
      "endTime" : "2024-10-24T11:38:18.662029273Z",
      "duration" : "PT0.00112931S",
      "startTime" : "2024-10-24T11:38:18.660899963Z",
      "startupStep" : {
        "name" : "spring.boot.application.starting",
        "id" : 0,
        "tags" : [ {
          "key" : "mainApplicationClass",
          "value" : "com.example.startup.StartupApplication"
        } ]
      }
    } ]
  }
}

Response Structure

The response contains details of the application startup steps. The following table describes the structure of the response:

Path Type Description

springBootVersion

String

Spring Boot version for this application.

timeline.startTime

String

Start time of the application.

timeline.events

Array

An array of steps collected during application startup so far.

timeline.events.[].startTime

String

The timestamp of the start of this event.

timeline.events.[].endTime

String

The timestamp of the end of this event.

timeline.events.[].duration

String

The precise duration of this event.

timeline.events.[].startupStep.name

String

The name of the StartupStep.

timeline.events.[].startupStep.id

Number

The id of this StartupStep.

timeline.events.[].startupStep.parentId

Number

The parent id for this StartupStep.

timeline.events.[].startupStep.tags

Array

An array of key/value pairs with additional step info.

timeline.events.[].startupStep.tags[].key

String

The key of the StartupStep Tag.

timeline.events.[].startupStep.tags[].value

String

The value of the StartupStep Tag.