Health
The connector reports its health status using the Spring Boot Actuator health endpoint.
To configure the information returned by the health
endpoint, configure the following properties:
-
management.endpoint.health.show-details
-
management.endpoint.health.show-components
For more information about the health endpoints, see Spring Boot documentation.
Health for the workflow, Solace binder, and the messaging service's binder components are exposed when management.endpoint.health.show-components
is enabled. For example:
management: endpoint: health: show-components: always show-details: always
This configuration would always show the full details of the health check including the workflows and binders. The default value is never
.
Workflow Health
A workflows
health indicator is provided to show the health status for each of a connector’s workflows. This health indicator has the following form:
{ "status": "(UP|DOWN)", "components": { "<workflow-id>": { "status": "(UP|DOWN)", "details": { "error": "<error message>" } } } }
Health Status | Description |
---|---|
|
A status that indicates the workflow is functioning as expected. |
|
A status that indicates the workflow is unhealthy. Operator intervention may be required. |
Figure 1. Workflow for Health Resolution Diagram
The following diagram describes the workflow to resolve any issues in the health status of this connector.
This health indicator is enabled by default. To disable it, set the property as follows:
management.health.workflows.enabled=false
Solace Binder Health
For more information, see Solace binder documentation.
Amazon SQS Binder Health
The following table lists the health status for binder for
Health Status | Description |
---|---|
UP |
Status indicating that the binder is functioning as expected. |
UNKNOWN |
Status indicating that the binder is in an unknown state. The binder will automatically recovers when the underlying connectivity issues are resolved. Operator intervention may be required. |
DOWN |
Status indicating that the binder is having difficulties reconnecting to Amazon SQS. The binder automatically recover when underlying connectivity issues are resolved. User intervention may be required. |
For more information, see Spring Cloud SQS Binder Health Indicator.