Commit f692b0e9 authored by Phillip Webb's avatar Phillip Webb

Rework title anchors for actuator docs

Closes gh-26615
parent 2dbf39c7
......@@ -13,8 +13,18 @@ configurations {
documentation
}
repositories {
maven {
url "https://repo.spring.io/release"
mavenContent {
includeGroup "io.spring.asciidoctor"
}
}
}
dependencies {
asciidoctorExtensions("org.springframework.restdocs:spring-restdocs-asciidoctor")
asciidoctorExtensions("io.spring.asciidoctor:spring-asciidoctor-extensions-section-ids")
api(project(":spring-boot-project:spring-boot-actuator"))
......
overview=overview
overview-endpoint-urls=overview.endpoint-urls
overview-timestamps=overview.timestamps
audit-events=audit-events
audit-events-retrieving=audit-events.retrieving
audit-events-retrieving-query-parameters=audit-events.retrieving.query-parameters
audit-events-retrieving-response-structure=audit-events.retrieving.response-structure
beans=beans
beans-retrieving=beans.retrieving
beans-retrieving-response-structure=beans.retrieving.response-structure
caches=caches
caches-all=caches.all
caches-all-response-structure=caches.all.response-structure
caches-named=caches.named
caches-named-query-parameters=caches.named.query-parameters
caches-named-response-structure=caches.named.response-structure
caches-evict-all=caches.evict-all
caches-evict-named=caches.evict-named
caches-evict-named-request-structure=caches.evict-named.request-structure
conditions=conditions
conditions-retrieving=conditions.retrieving
conditions-retrieving-response-structure=conditions.retrieving.response-structure
configprops=configprops
configprops-retrieving=configprops.retrieving
configprops-retrieving-response-structure=configprops.retrieving.response-structure
configprops-retrieving-by-prefix=configprops.retrieving-by-prefix
configprops-retrieving-by-prefix-response-structure=configprops.retrieving-by-prefix.response-structure
env=env
env-entire=env.entire
env-entire-response-structure=env.entire.response-structure
env-single-property=env.single-property
env-single-response-structure=env.single-property.response-structure
flyway=flyway
flyway-retrieving=flyway.retrieving
flyway-retrieving-response-structure=flyway.retrieving.response-structure
health=health
health-retrieving=health.retrieving
health-retrieving-response-structure=health.retrieving.response-structure
health-retrieving-component=health.retrieving-component
health-retrieving-component-response-structure=health.retrieving-component.response-structure
health-retrieving-component-nested=health.retrieving-component-nested
health-retrieving-component-instance-response-structure=health.retrieving-component-nested.response-structure
heapdump=heapdump
heapdump-retrieving=heapdump.retrieving
http-trace=http-trace
http-trace-retrieving=http-trace.retrieving
http-trace-retrieving-response-structure=http-trace.retrieving.response-structure
info=info
info-retrieving=info.retrieving
info-retrieving-response-structure=info.retrieving.response-structure
info-retrieving-response-structure-build=info.retrieving.response-structure.build
info-retrieving-response-structure-git=info.retrieving.response-structure.git
integrationgraph=integrationgraph
integrationgraph-retrieving=integrationgraph.retrieving
integrationgraph-retrieving-response-structure=integrationgraph.retrieving.response-structure
integrationgraph-rebuilding=integrationgraph.rebuilding
liquibase=liquibase
liquibase-retrieving=liquibase.retrieving
liquibase-retrieving-response-structure=liquibase.retrieving.response-structure
log-file=logfile
logfile-retrieving=logfile.retrieving
logfile-retrieving-part=logfile.retrieving-part
loggers=loggers
loggers-all=loggers.all
loggers-all-response-structure=loggers.all.response-structure
loggers-single=loggers.single
loggers-single-response-structure=loggers.single.response-structure
loggers-group=loggers.group
loggers-group-response-structure=loggers.group.response-structure
loggers-setting-level=loggers.setting-level
loggers-setting-level-request-structure=loggers.setting-level.request-structure
loggers-group-setting-level=loggers.group-setting-level
loggers-group-setting-level-request-structure=loggers.group-setting-level.request-structure
loggers-clearing-level=loggers.clearing-level
mappings=mappings
mappings-retrieving=mappings.retrieving
mappings-retrieving-response-structure=mappings.retrieving.response-structure
mappings-retrieving-response-structure-dispatcher-servlets=mappings.retrieving.response-structure-dispatcher-servlets
mappings-retrieving-response-structure-servlets=mappings.retrieving.response-structure-servlets
mappings-retrieving-response-structure-servlet-filters=mappings.retrieving.response-structure-servlet-filters
mappings-retrieving-response-structure-dispatcher-handlers=mappings.retrieving.response-structure-dispatcher-handlers
metrics=metrics
metrics-retrieving-names=metrics.retrieving-names
metrics-retrieving-names-response-structure=metrics.retrieving-names.response-structure
metrics-retrieving-metric=metrics.retrieving-metric
metrics-retrieving-metric-query-parameters=metrics.retrieving-metric.query-parameters
metrics-retrieving-metric-response-structure=metrics.retrieving-metric.response-structure
metrics-drilling-down=metrics.drilling-down
prometheus=prometheus
prometheus-retrieving=prometheus.retrieving
prometheus-retrieving-query-parameters=prometheus.retrieving.query-parameters
prometheus-retrieving-names=prometheus.retrieving-names
quartz=quartz
quartz-report=quartz.report
quartz-report-response-structure=quartz.report.response-structure
quartz-job-groups=quartz.job-groups
quartz-job-groups-response-structure=quartz.job-groups.response-structure
quartz-trigger-groups=quartz.trigger-groups
quartz-trigger-groups-response-structure=quartz.trigger-groups.response-structure
quartz-job-group=quartz.job-group
quartz-job-group-response-structure=quartz.job-group.response-structure
quartz-trigger-group=quartz.trigger-group
quartz-trigger-group-response-structure=quartz.trigger-group.response-structure
quartz-job=quartz.job
quartz-job-response-structure=quartz.job.response-structure
quartz-trigger=quartz.trigger
quartz-trigger-common-response-structure=quartz.trigger.common-response-structure
quartz-trigger-cron-response-structure=quartz.trigger.cron-response-structure
quartz-trigger-simple-response-structure=quartz.trigger.simple-response-structure
quartz-trigger-daily-time-interval-response-structure=quartz.trigger.daily-time-interval-response-structure
quartz-trigger-calendar-interval-response-structure=quartz.trigger.calendar-interval-response-structure
quartz-trigger-custom-response-structure=quartz.trigger.custom-response-structure
scheduled-tasks=scheduled-tasks
scheduled-tasks-retrieving=scheduled-tasks.retrieving
scheduled-tasks-retrieving-response-structure=scheduled-tasks.retrieving.response-structure
sessions=sessions
sessions-retrieving=sessions.retrieving
sessions-retrieving-query-parameters=sessions.retrieving.query-parameters
sessions-retrieving-response-structure=sessions.retrieving.response-structure
sessions-retrieving-id=sessions.retrieving-id
sessions-retrieving-id-response-structure=sessions.retrieving-id.response-structure
sessions-deleting=sessions.deleting
shutdown=shutdown
shutdown-shutting-down=shutdown.shutting-down
shutdown-shutting-down-response-structure=shutdown.shutting-down.response-structure
startup=startup
startup-retrieving=startup.retrieving
startup-retrieving-snapshot=startup.retrieving.snapshot
startup-retrieving-drain=startup.retrieving.drain
startup-retrieving-response-structure=startup.retrieving.response-structure
threaddump=threaddump
threaddump-retrieving-json=threaddump.retrieving-json
threaddump-retrieving-json-response-structure=threaddump.retrieving-json.response-structure
threaddump-retrieving-text=threaddump.retrieving-text
......@@ -4,7 +4,7 @@ The `auditevents` endpoint provides information about the application's audit ev
[[audit-events-retrieving]]
[[audit-events.retrieving]]
== Retrieving Audit Events
To retrieve the audit events, make a `GET` request to `/actuator/auditevents`, as shown in the following curl-based example:
......@@ -17,7 +17,7 @@ include::{snippets}/auditevents/filtered/http-response.adoc[]
[[audit-events-retrieving-query-parameters]]
[[audit-events.retrieving.query-parameters]]
=== Query Parameters
The endpoint uses query parameters to limit the events that it returns.
The following table shows the supported query parameters:
......@@ -27,7 +27,7 @@ include::{snippets}/auditevents/filtered/request-parameters.adoc[]
[[audit-events-retrieving-response-structure]]
[[audit-events.retrieving.response-structure]]
=== Response Structure
The response contains details of all of the audit events that matched the query.
The following table describes the structure of the response:
......
......@@ -4,7 +4,7 @@ The `beans` endpoint provides information about the application's beans.
[[beans-retrieving]]
[[beans.retrieving]]
== Retrieving the Beans
To retrieve the beans, make a `GET` request to `/actuator/beans`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/beans/http-response.adoc[]
[[beans-retrieving-response-structure]]
[[beans.retrieving.response-structure]]
=== Response Structure
The response contains details of the application's beans.
The following table describes the structure of the response:
......
......@@ -4,7 +4,7 @@ The `caches` endpoint provides access to the application's caches.
[[caches-all]]
[[caches.all]]
== Retrieving All Caches
To retrieve the application's caches, make a `GET` request to `/actuator/caches`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/caches/all/http-response.adoc[]
[[caches-all-response-structure]]
[[caches.all.response-structure]]
=== Response Structure
The response contains details of the application's caches.
The following table describes the structure of the response:
......@@ -26,7 +26,7 @@ include::{snippets}/caches/all/response-fields.adoc[]
[[caches-named]]
[[caches.named]]
== Retrieving Caches by Name
To retrieve a cache by name, make a `GET` request to `/actuator/caches/\{name}`, as shown in the following curl-based example:
......@@ -39,7 +39,7 @@ include::{snippets}/caches/named/http-response.adoc[]
[[caches-named-query-parameters]]
[[caches.named.query-parameters]]
=== Query Parameters
If the requested name is specific enough to identify a single cache, no extra parameter is required.
Otherwise, the `cacheManager` must be specified.
......@@ -50,7 +50,7 @@ include::{snippets}/caches/named/request-parameters.adoc[]
[[caches-named-response-structure]]
[[caches.named.response-structure]]
=== Response Structure
The response contains details of the requested cache.
The following table describes the structure of the response:
......@@ -60,7 +60,7 @@ include::{snippets}/caches/named/response-fields.adoc[]
[[caches-evict-all]]
[[caches.evict-all]]
== Evict All Caches
To clear all available caches, make a `DELETE` request to `/actuator/caches` as shown in the following curl-based example:
......@@ -68,7 +68,7 @@ include::{snippets}/caches/evict-all/curl-request.adoc[]
[[caches-evict-named]]
[[caches.evict-named]]
== Evict a Cache by Name
To evict a particular cache, make a `DELETE` request to `/actuator/caches/\{name}` as shown in the following curl-based example:
......@@ -78,7 +78,7 @@ NOTE: As there are two caches named `countries`, the `cacheManager` has to be pr
[[caches-evict-named-request-structure]]
[[caches.evict-named.request-structure]]
=== Request Structure
If the requested name is specific enough to identify a single cache, no extra parameter is required.
Otherwise, the `cacheManager` must be specified.
......
......@@ -4,7 +4,7 @@ The `conditions` endpoint provides information about the evaluation of condition
[[conditions-retrieving]]
[[conditions.retrieving]]
== Retrieving the Report
To retrieve the report, make a `GET` request to `/actuator/conditions`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/conditions/http-response.adoc[]
[[conditions-retrieving-response-structure]]
[[conditions.retrieving.response-structure]]
=== Response Structure
The response contains details of the application's condition evaluation.
The following table describes the structure of the response:
......
......@@ -4,7 +4,7 @@ The `configprops` endpoint provides information about the application's `@Config
[[configprops-retrieving]]
[[configprops.retrieving]]
== Retrieving All @ConfigurationProperties Beans
To retrieve all of the `@ConfigurationProperties` beans, make a `GET` request to `/actuator/configprops`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/configprops/all/http-response.adoc[]
[[configprops-retrieving-response-structure]]
[[configprops.retrieving.response-structure]]
=== Response Structure
The response contains details of the application's `@ConfigurationProperties` beans.
The following table describes the structure of the response:
......@@ -26,7 +26,7 @@ include::{snippets}/configprops/all/response-fields.adoc[]
[[configprops-retrieving-by-prefix]]
[[configprops.retrieving-by-prefix]]
== Retrieving @ConfigurationProperties Beans By Prefix
To retrieve the `@ConfigurationProperties` beans mapped under a certain prefix, make a `GET` request to `/actuator/configprops/\{prefix}`, as shown in the following curl-based example:
......@@ -40,7 +40,7 @@ NOTE: The `\{prefix}` does not need to be exact, a more general prefix will retu
[[configprops-retrieving-by-prefix-response-structure]]
[[configprops.retrieving-by-prefix.response-structure]]
=== Response Structure
The response contains details of the application's `@ConfigurationProperties` beans.
The following table describes the structure of the response:
......
......@@ -4,7 +4,7 @@ The `env` endpoint provides information about the application's `Environment`.
[[env-entire]]
[[env.entire]]
== Retrieving the Entire Environment
To retrieve the entire environment, make a `GET` request to `/actuator/env`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/env/all/http-response.adoc[]
[[env-entire-response-structure]]
[[env.entire.response-structure]]
=== Response Structure
The response contains details of the application's `Environment`.
The following table describes the structure of the response:
......@@ -26,7 +26,7 @@ include::{snippets}/env/all/response-fields.adoc[]
[[env-single-property]]
[[env.single-property]]
== Retrieving a Single Property
To retrieve a single property, make a `GET` request to `/actuator/env/{property.name}`, as shown in the following curl-based example:
......@@ -39,7 +39,7 @@ include::{snippets}/env/single/http-response.adoc[]
[[env-single-response-structure]]
[[env.single-property.response-structure]]
=== Response Structure
The response contains details of the requested property.
The following table describes the structure of the response:
......
......@@ -4,7 +4,7 @@ The `flyway` endpoint provides information about database migrations performed b
[[flyway-retrieving]]
[[flyway.retrieving]]
== Retrieving the Migrations
To retrieve the migrations, make a `GET` request to `/actuator/flyway`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/flyway/http-response.adoc[]
[[flyway-retrieving-response-structure]]
[[flyway.retrieving.response-structure]]
=== Response Structure
The response contains details of the application's Flyway migrations.
The following table describes the structure of the response:
......
......@@ -4,8 +4,8 @@ The `health` endpoint provides detailed information about the health of the appl
[[health-retrieving]]
== Retrieving the Health of the application
[[health.retrieving]]
== Retrieving the Health of the Application
To retrieve the health of the application, make a `GET` request to `/actuator/health`, as shown in the following curl-based example:
include::{snippets}/health/curl-request.adoc[]
......@@ -16,7 +16,7 @@ include::{snippets}/health/http-response.adoc[]
[[health-retrieving-response-structure]]
[[health.retrieving.response-structure]]
=== Response Structure
The response contains details of the health of the application.
The following table describes the structure of the response:
......@@ -29,8 +29,8 @@ If you need to return V2 JSON you should use an accept header or `application/vn
[[health-retrieving-component]]
== Retrieving the Health of a component
[[health.retrieving-component]]
== Retrieving the Health of a Component
To retrieve the health of a particular component of the application's health, make a `GET` request to `/actuator/health/\{component}`, as shown in the following curl-based example:
include::{snippets}/health/component/curl-request.adoc[]
......@@ -41,7 +41,7 @@ include::{snippets}/health/component/http-response.adoc[]
[[health-retrieving-component-response-structure]]
[[health.retrieving-component.response-structure]]
=== Response Structure
The response contains details of the health of a particular component of the application's health.
The following table describes the structure of the response:
......@@ -51,8 +51,8 @@ include::{snippets}/health/component/response-fields.adoc[]
[[health-retrieving-component-nested]]
== Retrieving the Health of a nested component
[[health.retrieving-component-nested]]
== Retrieving the Health of a Nested Component
If a particular component contains other nested components (as the `broker` indicator in the example above), the health of such a nested component can be retrieved by issuing a `GET` request to `/actuator/health/\{component}/\{subcomponent}`, as shown in the following curl-based example:
include::{snippets}/health/instance/curl-request.adoc[]
......@@ -66,7 +66,7 @@ The health endpoint supports any number of `/\{component}` identifiers in the UR
[[health-retrieving-component-instance-response-structure]]
[[health.retrieving-component-nested.response-structure]]
=== Response Structure
The response contains details of the health of an instance of a particular component of the application.
The following table describes the structure of the response:
......
......@@ -4,7 +4,7 @@ The `heapdump` endpoint provides a heap dump from the application's JVM.
[[heapdump-retrieving]]
[[heapdump.retrieving]]
== Retrieving the Heap Dump
To retrieve the heap dump, make a `GET` request to `/actuator/heapdump`.
The response is binary data in https://docs.oracle.com/javase/8/docs/technotes/samples/hprof.html[HPROF] format and can be large.
......
......@@ -4,7 +4,7 @@ The `httptrace` endpoint provides information about HTTP request-response exchan
[[http-trace-retrieving]]
[[http-trace.retrieving]]
== Retrieving the Traces
To retrieve the traces, make a `GET` request to `/actuator/httptrace`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/httptrace/http-response.adoc[]
[[http-trace-retrieving-response-structure]]
[[http-trace.retrieving.response-structure]]
=== Response Structure
The response contains details of the traced HTTP request-response exchanges.
The following table describes the structure of the response:
......
......@@ -4,7 +4,7 @@ The `info` endpoint provides general information about the application.
[[info-retrieving]]
[[info.retrieving]]
== Retrieving the Info
To retrieve the information about the application, make a `GET` request to `/actuator/info`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/info/http-response.adoc[]
[[info-retrieving-response-structure]]
[[info.retrieving.response-structure]]
=== Response Structure
The response contains general information about the application.
Each section of the response is contributed by an `InfoContributor`.
......@@ -24,7 +24,7 @@ Spring Boot provides `build` and `git` contributions.
[[info-retrieving-response-structure-build]]
[[info.retrieving.response-structure.build]]
==== Build Response Structure
The following table describe the structure of the `build` section of the response:
......@@ -33,7 +33,7 @@ include::{snippets}/info/response-fields-beneath-build.adoc[]
[[info-retrieving-response-structure-git]]
[[info.retrieving.response-structure.git]]
==== Git Response Structure
The following table describes the structure of the `git` section of the response:
......
......@@ -4,8 +4,8 @@ The `integrationgraph` endpoint exposes a graph containing all Spring Integratio
[[integrationgraph-retrieving]]
== Retrieving the Spring Integration graph
[[integrationgraph.retrieving]]
== Retrieving the Spring Integration Graph
To retrieve the information about the application, make a `GET` request to `/actuator/integrationgraph`, as shown in the following curl-based example:
include::{snippets}/integrationgraph/graph/curl-request.adoc[]
......@@ -16,15 +16,15 @@ include::{snippets}/integrationgraph/graph/http-response.adoc[]
[[integrationgraph-retrieving-response-structure]]
[[integrationgraph.retrieving.response-structure]]
=== Response Structure
The response contains all Spring Integration components used within the application, as well as the links between them.
More information about the structure can be found in the {spring-integration-docs}index-single.html#integration-graph[reference documentation].
[[integrationgraph-rebuilding]]
== Rebuilding the Spring Integration graph
[[integrationgraph.rebuilding]]
== Rebuilding the Spring Integration Graph
To rebuild the exposed graph, make a `POST` request to `/actuator/integrationgraph`, as shown in the following curl-based example:
include::{snippets}/integrationgraph/rebuild/curl-request.adoc[]
......
......@@ -4,7 +4,7 @@ The `liquibase` endpoint provides information about database change sets applied
[[liquibase-retrieving]]
[[liquibase.retrieving]]
== Retrieving the Changes
To retrieve the changes, make a `GET` request to `/actuator/liquibase`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/liquibase/http-response.adoc[]
[[liquibase-retrieving-response-structure]]
[[liquibase.retrieving.response-structure]]
=== Response Structure
The response contains details of the application's Liquibase change sets.
The following table describes the structure of the response:
......
[[log-file]]
[[logfile]]
= Log File (`logfile`)
The `logfile` endpoint provides access to the contents of the application's log file.
[[logfile-retrieving]]
[[logfile.retrieving]]
== Retrieving the Log File
To retrieve the log file, make a `GET` request to `/actuator/logfile`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/logfile/entire/http-response.adoc[]
[[logfile-retrieving-part]]
[[logfile.retrieving-part]]
== Retrieving Part of the Log File
NOTE: Retrieving part of the log file is not supported when using Jersey.
......
......@@ -4,7 +4,7 @@ The `loggers` endpoint provides access to the application's loggers and the conf
[[loggers-all]]
[[loggers.all]]
== Retrieving All Loggers
To retrieve the application's loggers, make a `GET` request to `/actuator/loggers`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/loggers/all/http-response.adoc[]
[[loggers-all-response-structure]]
[[loggers.all.response-structure]]
=== Response Structure
The response contains details of the application's loggers.
The following table describes the structure of the response:
......@@ -26,7 +26,7 @@ include::{snippets}/loggers/all/response-fields.adoc[]
[[loggers-single]]
[[loggers.single]]
== Retrieving a Single Logger
To retrieve a single logger, make a `GET` request to `/actuator/loggers/{logger.name}`, as shown in the following curl-based example:
......@@ -39,7 +39,7 @@ include::{snippets}/loggers/single/http-response.adoc[]
[[loggers-single-response-structure]]
[[loggers.single.response-structure]]
=== Response Structure
The response contains details of the requested logger.
The following table describes the structure of the response:
......@@ -49,7 +49,7 @@ include::{snippets}/loggers/single/response-fields.adoc[]
[[loggers-group]]
[[loggers.group]]
== Retrieving a Single Group
To retrieve a single group, make a `GET` request to `/actuator/loggers/{group.name}`,
as shown in the following curl-based example:
......@@ -63,7 +63,7 @@ include::{snippets}/loggers/group/http-response.adoc[]
[[loggers-group-response-structure]]
[[loggers.group.response-structure]]
=== Response Structure
The response contains details of the requested group.
The following table describes the structure of the response:
......@@ -73,7 +73,7 @@ include::{snippets}/loggers/group/response-fields.adoc[]
[[loggers-setting-level]]
[[loggers.setting-level]]
== Setting a Log Level
To set the level of a logger, make a `POST` request to `/actuator/loggers/{logger.name}` with a JSON body that specifies the configured level for the logger, as shown in the following curl-based example:
......@@ -83,7 +83,7 @@ The preceding example sets the `configuredLevel` of the `com.example` logger to
[[loggers-setting-level-request-structure]]
[[loggers.setting-level.request-structure]]
=== Request Structure
The request specifies the desired level of the logger.
The following table describes the structure of the request:
......@@ -93,7 +93,7 @@ include::{snippets}/loggers/set/request-fields.adoc[]
[[loggers-group-setting-level]]
[[loggers.group-setting-level]]
== Setting a Log Level for a Group
To set the level of a logger, make a `POST` request to `/actuator/loggers/{group.name}` with a JSON body that specifies the configured level for the logger group, as shown in the following curl-based example:
......@@ -103,7 +103,7 @@ The preceding example sets the `configuredLevel` of the `test` logger group to `
[[loggers-group-setting-level-request-structure]]
[[loggers.group-setting-level.request-structure]]
=== Request Structure
The request specifies the desired level of the logger group.
The following table describes the structure of the request:
......@@ -113,7 +113,7 @@ include::{snippets}/loggers/set/request-fields.adoc[]
[[loggers-clearing-level]]
[[loggers.clearing-level]]
== Clearing a Log Level
To clear the level of a logger, make a `POST` request to `/actuator/loggers/{logger.name}` with a JSON body containing an empty object, as shown in the following curl-based example:
......
......@@ -4,7 +4,7 @@ The `mappings` endpoint provides information about the application's request map
[[mappings-retrieving]]
[[mappings.retrieving]]
== Retrieving the Mappings
To retrieve the mappings, make a `GET` request to `/actuator/mappings`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/mappings/http-response.adoc[]
[[mappings-retrieving-response-structure]]
[[mappings.retrieving.response-structure]]
=== Response Structure
The response contains details of the application's mappings.
The items found in the response depend on the type of web application (reactive or Servlet-based).
......@@ -29,7 +29,7 @@ The entries that may be found in `contexts.*.mappings` are described in the foll
[[mappings-retrieving-response-structure-dispatcher-servlets]]
[[mappings.retrieving.response-structure-dispatcher-servlets]]
=== Dispatcher Servlets Response Structure
When using Spring MVC, the response contains details of any `DispatcherServlet` request mappings beneath `contexts.*.mappings.dispatcherServlets`.
The following table describes the structure of this section of the response:
......@@ -39,7 +39,7 @@ include::{snippets}/mappings/response-fields-dispatcher-servlets.adoc[]
[[mappings-retrieving-response-structure-servlets]]
[[mappings.retrieving.response-structure-servlets]]
=== Servlets Response Structure
When using the Servlet stack, the response contains details of any `Servlet` mappings beneath `contexts.*.mappings.servlets`.
The following table describes the structure of this section of the response:
......@@ -49,7 +49,7 @@ include::{snippets}/mappings/response-fields-servlets.adoc[]
[[mappings-retrieving-response-structure-servlet-filters]]
[[mappings.retrieving.response-structure-servlet-filters]]
=== Servlet Filters Response Structure
When using the Servlet stack, the response contains details of any `Filter` mappings beneath `contexts.*.mappings.servletFilters`.
The following table describes the structure of this section of the response:
......@@ -59,7 +59,7 @@ include::{snippets}/mappings/response-fields-servlet-filters.adoc[]
[[mappings-retrieving-response-structure-dispatcher-handlers]]
[[mappings.retrieving.response-structure-dispatcher-handlers]]
=== Dispatcher Handlers Response Structure
When using Spring WebFlux, the response contains details of any `DispatcherHandler` request mappings beneath `contexts.*.mappings.dispatcherHandlers`.
The following table describes the structure of this section of the response:
......
......@@ -4,7 +4,7 @@ The `metrics` endpoint provides access to application metrics.
[[metrics-retrieving-names]]
[[metrics.retrieving-names]]
== Retrieving Metric Names
To retrieve the names of the available metrics, make a `GET` request to `/actuator/metrics`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/metrics/names/http-response.adoc[]
[[metrics-retrieving-names-response-structure]]
[[metrics.retrieving-names.response-structure]]
=== Response Structure
The response contains details of the metric names.
The following table describes the structure of the response:
......@@ -26,7 +26,7 @@ include::{snippets}/metrics/names/response-fields.adoc[]
[[metrics-retrieving-metric]]
[[metrics.retrieving-metric]]
== Retrieving a Metric
To retrieve a metric, make a `GET` request to `/actuator/metrics/{metric.name}`, as shown in the following curl-based example:
......@@ -39,9 +39,9 @@ include::{snippets}/metrics/metric/http-response.adoc[]
[[metrics-retrieving-metric-query-parameters]]
[[metrics.retrieving-metric.query-parameters]]
=== Query Parameters
The endpoint uses query parameters to <<metrics-drilling-down,drill down>> into a metric by using its tags.
The endpoint uses query parameters to <<metrics.drilling-down,drill down>> into a metric by using its tags.
The following table shows the single supported query parameter:
[cols="2,4"]
......@@ -49,7 +49,7 @@ include::{snippets}/metrics/metric-with-tags/request-parameters.adoc[]
[[metrics-retrieving-metric-response-structure]]
[[metrics.retrieving-metric.response-structure]]
=== Response structure
The response contains details of the metric.
The following table describes the structure of the response:
......@@ -58,7 +58,7 @@ include::{snippets}/metrics/metric/response-fields.adoc[]
[[metrics-drilling-down]]
[[metrics.drilling-down]]
== Drilling Down
To drill down into a metric, make a `GET` request to `/actuator/metrics/{metric.name}` using the `tag` query parameter, as shown in the following curl-based example:
......
......@@ -4,7 +4,7 @@ The `prometheus` endpoint provides Spring Boot application's metrics in the form
[[prometheus-retrieving]]
[[prometheus.retrieving]]
== Retrieving All Metrics
To retrieve all metrics, make a `GET` request to `/actuator/prometheus`, as shown in the following curl-based example:
......@@ -25,7 +25,7 @@ include::{snippets}/prometheus/openmetrics/http-response.adoc[]
[[prometheus-retrieving-query-parameters]]
[[prometheus.retrieving.query-parameters]]
=== Query Parameters
The endpoint uses query parameters to limit the samples that it returns.
The following table shows the supported query parameters:
......@@ -35,7 +35,7 @@ include::{snippets}/prometheus/names/request-parameters.adoc[]
[[prometheus-retrieving-names]]
[[prometheus.retrieving-names]]
== Retrieving Filtered Metrics
To retrieve metrics matching specific names, make a `GET` request to `/actuator/prometheus` with the `includedNames` query parameter, as shown in the following curl-based example:
......
......@@ -4,7 +4,7 @@ The `quartz` endpoint provides information about jobs and triggers that are mana
[[quartz-report]]
[[quartz.report]]
== Retrieving Registered Groups
Jobs and triggers are managed in groups.
To retrieve the list of registered job and trigger groups, make a `GET` request to `/actuator/quartz`, as shown in the following curl-based example:
......@@ -17,7 +17,7 @@ include::{snippets}/quartz/report/http-response.adoc[]
[[quartz-report-response-structure]]
[[quartz.report.response-structure]]
=== Response Structure
The response contains the groups names for registered jobs and triggers.
The following table describes the structure of the response:
......@@ -27,7 +27,7 @@ include::{snippets}/quartz/report/response-fields.adoc[]
[[quartz-job-groups]]
[[quartz.job-groups]]
== Retrieving Registered Job Names
To retrieve the list of registered job names, make a `GET` request to `/actuator/quartz/jobs`, as shown in the following curl-based example:
......@@ -39,7 +39,7 @@ include::{snippets}/quartz/jobs/http-response.adoc[]
[[quartz-job-groups-response-structure]]
[[quartz.job-groups.response-structure]]
=== Response Structure
The response contains the registered job names for each group.
The following table describes the structure of the response:
......@@ -49,7 +49,7 @@ include::{snippets}/quartz/jobs/response-fields.adoc[]
[[quartz-trigger-groups]]
[[quartz.trigger-groups]]
== Retrieving Registered Trigger Names
To retrieve the list of registered trigger names, make a `GET` request to `/actuator/quartz/triggers`, as shown in the following curl-based example:
......@@ -61,7 +61,7 @@ include::{snippets}/quartz/triggers/http-response.adoc[]
[[quartz-trigger-groups-response-structure]]
[[quartz.trigger-groups.response-structure]]
=== Response Structure
The response contains the registered trigger names for each group.
The following table describes the structure of the response:
......@@ -71,7 +71,7 @@ include::{snippets}/quartz/triggers/response-fields.adoc[]
[[quartz-job-group]]
[[quartz.job-group]]
== Retrieving Overview of a Job Group
To retrieve an overview of the jobs in a particular group, make a `GET` request to `/actuator/quartz/jobs/\{groupName}`, as shown in the following curl-based example:
......@@ -84,7 +84,7 @@ include::{snippets}/quartz/job-group/http-response.adoc[]
[[quartz-job-group-response-structure]]
[[quartz.job-group.response-structure]]
=== Response Structure
The response contains an overview of jobs in a particular group.
The following table describes the structure of the response:
......@@ -94,7 +94,7 @@ include::{snippets}/quartz/job-group/response-fields.adoc[]
[[quartz-trigger-group]]
[[quartz.trigger-group]]
== Retrieving Overview of a Trigger Group
To retrieve an overview of the triggers in a particular group, make a `GET` request to `/actuator/quartz/triggers/\{groupName}`, as shown in the following curl-based example:
......@@ -108,7 +108,7 @@ include::{snippets}/quartz/trigger-group/http-response.adoc[]
[[quartz-trigger-group-response-structure]]
[[quartz.trigger-group.response-structure]]
=== Response Structure
The response contains an overview of triggers in a particular group.
Trigger implementation specific details are available.
......@@ -119,7 +119,7 @@ include::{snippets}/quartz/trigger-group/response-fields.adoc[]
[[quartz-job]]
[[quartz.job]]
== Retrieving Details of a Job
To retrieve the details about a particular job, make a `GET` request to `/actuator/quartz/jobs/\{groupName}/\{jobName}`, as shown in the following curl-based example:
......@@ -134,7 +134,7 @@ If a key in the data map is identified as sensitive, its value is sanitized.
[[quartz-job-response-structure]]
[[quartz.job.response-structure]]
=== Response Structure
The response contains the full details of a job including a summary of the triggers associated with it, if any.
The triggers are sorted by next fire time and priority.
......@@ -145,7 +145,7 @@ include::{snippets}/quartz/job-details/response-fields.adoc[]
[[quartz-trigger]]
[[quartz.trigger]]
== Retrieving Details of a Trigger
To retrieve the details about a particular trigger, make a `GET` request to `/actuator/quartz/triggers/\{groupName}/\{triggerName}`, as shown in the following curl-based example:
......@@ -155,7 +155,7 @@ The preceding example retrieves the details of trigger identified by the `sample
[[quartz-trigger-common-response-structure]]
[[quartz.trigger.common-response-structure]]
=== Common Response Structure
The response has a common structure and an additional object that is specific to the trigger's type.
There are five supported types:
......@@ -173,7 +173,7 @@ include::{snippets}/quartz/trigger-details-common/response-fields.adoc[]
[[quartz-trigger-cron-response-structure]]
[[quartz.trigger.cron-response-structure]]
=== Cron Trigger Response Structure
A cron trigger defines the cron expression that is used to determine when it has to fire.
The resulting response for such a trigger implementation is similar to the following:
......@@ -182,7 +182,7 @@ include::{snippets}/quartz/trigger-details-cron/http-response.adoc[]
Much of the response is common to all trigger types.
The structure of the common elements of the response was <<quartz-trigger-common-response-structure,described previously>>.
The structure of the common elements of the response was <<quartz.trigger.common-response-structure,described previously>>.
The following table describes the structure of the parts of the response that are specific to cron triggers:
[cols="2,1,3"]
......@@ -190,7 +190,7 @@ include::{snippets}/quartz/trigger-details-cron/response-fields.adoc[]
[[quartz-trigger-simple-response-structure]]
[[quartz.trigger.simple-response-structure]]
=== Simple Trigger Response Structure
A simple trigger is used to fire a Job at a given moment in time, and optionally repeated at a specified interval.
The resulting response for such a trigger implementation is similar to the following:
......@@ -199,7 +199,7 @@ include::{snippets}/quartz/trigger-details-simple/http-response.adoc[]
Much of the response is common to all trigger types.
The structure of the common elements of the response was <<quartz-trigger-common-response-structure,described previously>>.
The structure of the common elements of the response was <<quartz.trigger.common-response-structure,described previously>>.
The following table describes the structure of the parts of the response that are specific to simple triggers:
[cols="2,1,3"]
......@@ -207,7 +207,7 @@ include::{snippets}/quartz/trigger-details-simple/response-fields.adoc[]
[[quartz-trigger-daily-time-interval-response-structure]]
[[quartz.trigger.daily-time-interval-response-structure]]
=== Daily Time Interval Trigger Response Structure
A daily time interval trigger is used to fire a Job based upon daily repeating time intervals.
The resulting response for such a trigger implementation is similar to the following:
......@@ -216,7 +216,7 @@ include::{snippets}/quartz/trigger-details-daily-time-interval/http-response.ado
Much of the response is common to all trigger types.
The structure of the common elements of the response was <<quartz-trigger-common-response-structure,described previously>>.
The structure of the common elements of the response was <<quartz.trigger.common-response-structure,described previously>>.
The following table describes the structure of the parts of the response that are specific to daily time interval triggers:
[cols="2,1,3"]
......@@ -224,7 +224,7 @@ include::{snippets}/quartz/trigger-details-daily-time-interval/response-fields.a
[[quartz-trigger-calendar-interval-response-structure]]
[[quartz.trigger.calendar-interval-response-structure]]
=== Calendar Interval Trigger Response Structure
A calendar interval trigger is used to fire a Job based upon repeating calendar time intervals.
The resulting response for such a trigger implementation is similar to the following:
......@@ -233,7 +233,7 @@ include::{snippets}/quartz/trigger-details-calendar-interval/http-response.adoc[
Much of the response is common to all trigger types.
The structure of the common elements of the response was <<quartz-trigger-common-response-structure,described previously>>.
The structure of the common elements of the response was <<quartz.trigger.common-response-structure,described previously>>.
The following table describes the structure of the parts of the response that are specific to calendar interval triggers:
[cols="2,1,3"]
......@@ -241,7 +241,7 @@ include::{snippets}/quartz/trigger-details-calendar-interval/response-fields.ado
[[quartz-trigger-custom-response-structure]]
[[quartz.trigger.custom-response-structure]]
=== Custom Trigger Response Structure
A custom trigger is any other implementation.
The resulting response for such a trigger implementation is similar to the following:
......@@ -250,7 +250,7 @@ include::{snippets}/quartz/trigger-details-custom/http-response.adoc[]
Much of the response is common to all trigger types.
The structure of the common elements of the response was <<quartz-trigger-common-response-structure,described previously>>.
The structure of the common elements of the response was <<quartz.trigger.common-response-structure,described previously>>.
The following table describes the structure of the parts of the response that are specific to custom triggers:
[cols="2,1,3"]
......
......@@ -4,7 +4,7 @@ The `scheduledtasks` endpoint provides information about the application's sched
[[scheduled-tasks-retrieving]]
[[scheduled-tasks.retrieving]]
== Retrieving the Scheduled Tasks
To retrieve the scheduled tasks, make a `GET` request to `/actuator/scheduledtasks`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/scheduled-tasks/http-response.adoc[]
[[scheduled-tasks-retrieving-response-structure]]
[[scheduled-tasks.retrieving.response-structure]]
=== Response Structure
The response contains details of the application's scheduled tasks.
The following table describes the structure of the response:
......
......@@ -4,7 +4,7 @@ The `sessions` endpoint provides information about the application's HTTP sessio
[[sessions-retrieving]]
[[sessions.retrieving]]
== Retrieving Sessions
To retrieve the sessions, make a `GET` request to `/actuator/sessions`, as shown in the following curl-based example:
......@@ -17,7 +17,7 @@ include::{snippets}/sessions/username/http-response.adoc[]
[[sessions-retrieving-query-parameters]]
[[sessions.retrieving.query-parameters]]
=== Query Parameters
The endpoint uses query parameters to limit the sessions that it returns.
The following table shows the single required query parameter:
......@@ -27,7 +27,7 @@ include::{snippets}/sessions/username/request-parameters.adoc[]
[[sessions-retrieving-response-structure]]
[[sessions.retrieving.response-structure]]
=== Response Structure
The response contains details of the matching sessions.
The following table describes the structure of the response:
......@@ -37,7 +37,7 @@ include::{snippets}/sessions/username/response-fields.adoc[]
[[sessions-retrieving-id]]
[[sessions.retrieving-id]]
== Retrieving a Single Session
To retrieve a single session, make a `GET` request to `/actuator/sessions/\{id}`, as shown in the following curl-based example:
......@@ -50,7 +50,7 @@ include::{snippets}/sessions/id/http-response.adoc[]
[[sessions-retrieving-id-response-structure]]
[[sessions.retrieving-id.response-structure]]
=== Response Structure
The response contains details of the requested session.
The following table describes the structure of the response:
......@@ -60,7 +60,7 @@ include::{snippets}/sessions/id/response-fields.adoc[]
[[sessions-deleting]]
[[sessions.deleting]]
== Deleting a Session
To delete a session, make a `DELETE` request to `/actuator/sessions/\{id}`, as shown in the following curl-based example:
......
......@@ -4,7 +4,7 @@ The `shutdown` endpoint is used to shut down the application.
[[shutdown-shutting-down]]
[[shutdown.shutting-down]]
== Shutting Down the Application
To shut down the application, make a `POST` request to `/actuator/shutdown`, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/shutdown/http-response.adoc[]
[[shutdown-shutting-down-response-structure]]
[[shutdown.shutting-down.response-structure]]
=== Response Structure
The response contains details of the result of the shutdown request.
The following table describes the structure of the response:
......
......@@ -4,14 +4,14 @@ The `startup` endpoint provides information about the application's startup sequ
[[startup-retrieving]]
== Retrieving the Application Startup steps
[[startup.retrieving]]
== Retrieving the Application Startup Steps
The application startup steps can either be retrieved as a snapshot (`GET`) or drained from the buffer (`POST`).
[[startup-retrieving-snapshot]]
=== Retrieving a snapshot of the Application Startup steps
[[startup.retrieving.snapshot]]
=== 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:
include::{snippets}/startup-snapshot/curl-request.adoc[]
......@@ -22,8 +22,8 @@ include::{snippets}/startup-snapshot/http-response.adoc[]
[[startup-retrieving-drain]]
== Draining the Application Startup steps
[[startup.retrieving.drain]]
=== 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:
include::{snippets}/startup/curl-request.adoc[]
......@@ -34,7 +34,7 @@ include::{snippets}/startup/http-response.adoc[]
[[startup-retrieving-response-structure]]
[[startup.retrieving.response-structure]]
=== Response Structure
The response contains details of the application startup steps.
The following table describes the structure of the response:
......
......@@ -4,7 +4,7 @@ The `threaddump` endpoint provides a thread dump from the application's JVM.
[[threaddump-retrieving-json]]
[[threaddump.retrieving-json]]
== Retrieving the Thread Dump as JSON
To retrieve the thread dump as JSON, make a `GET` request to `/actuator/threaddump` with an appropriate `Accept` header, as shown in the following curl-based example:
......@@ -16,7 +16,7 @@ include::{snippets}/threaddump/json/http-response.adoc[]
[[threaddump-retrieving-json-response-structure]]
[[threaddump.retrieving-json.response-structure]]
=== Response Structure
The response contains details of the JVM's threads.
The following table describes the structure of the response:
......@@ -26,7 +26,7 @@ include::{snippets}/threaddump/json/response-fields.adoc[]
[[threaddump-retrieving-text]]
[[threaddump.retrieving-text]]
== Retrieving the Thread Dump as Text
To retrieve the thread dump as text, make a `GET` request to `/actuator/threaddump` that
accepts `text/plain`, as shown in the following curl-based example:
......
......@@ -20,14 +20,14 @@ This API documentation describes Spring Boot Actuators web endpoints.
== Overview
Before you proceed, you should read the following topics:
* <<overview-endpoint-urls>>
* <<overview-timestamps>>
* <<overview.endpoint-urls>>
* <<overview.timestamps>>
NOTE: In order to get the correct JSON responses documented below, Jackson must be available.
[[overview-endpoint-urls]]
[[overview.endpoint-urls]]
=== URLs
By default, all web endpoints are available beneath the path `/actuator` with URLs of
the form `/actuator/\{id}`. The `/actuator` base path can be configured by using the
......@@ -44,7 +44,7 @@ The preceding `application.properties` example changes the form of the endpoint
[[overview-timestamps]]
[[overview.timestamps]]
=== Timestamps
All timestamps that are consumed by the endpoints, either as query parameters or in the
request body, must be formatted as an offset date and time as specified in
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment