Skip to content

GH-1644: Document RefreshScopeHealthIndicator and how to disable it#1697

Open
won-seoop wants to merge 1 commit into
spring-cloud:mainfrom
won-seoop:docs/1644-refresh-health-indicator
Open

GH-1644: Document RefreshScopeHealthIndicator and how to disable it#1697
won-seoop wants to merge 1 commit into
spring-cloud:mainfrom
won-seoop:docs/1644-refresh-health-indicator

Conversation

@won-seoop

Copy link
Copy Markdown

Summary

Closes #1644.

The @RefreshScope section lacked any mention of the auto-configured RefreshScopeHealthIndicator. Users discovering the refresh health indicator in their /actuator/health output had no documentation explaining its purpose or how to opt out.

This PR adds a Health Indicator subsection under Refresh Scope that:

  • Explains what RefreshScopeHealthIndicator does (transitions to DOWN when a bean fails to re-initialize or rebind after a context refresh).
  • Shows how to disable it via management.health.refresh.enabled=false, consistent with the pattern already established in the Discovery Client docs.

Test plan

  • Documentation renders correctly (AsciiDoc structure is valid)
  • management.health.refresh.enabled=false disables the indicator (verified against RefreshEndpointAutoConfiguration which uses @ConditionalOnEnabledHealthIndicator("refresh"))

🤖 Generated with Claude Code

…disable it

The refresh scope section did not mention the auto-configured
RefreshScopeHealthIndicator. Users had no documentation to guide them
on its purpose or how to disable it, unlike the DiscoveryClient health
indicators which include explicit instructions.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improve documentation on refresh health indicator

2 participants