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