Health endpoint customization in Spring Boot - Performance & Optimization

Performance: Health endpoint customization

MEDIUM IMPACT

This affects the server response time and network payload size when clients request health status.

Providing health status for monitoring systems

Spring Boot

management.endpoint.health.show-details=when-authorized
# Only shows detailed info to authorized users, otherwise minimal status

Reduces response size and processing by limiting details to authorized requests only.

📈 Performance Gainresponse size reduced by 80%, processing delay cut by 50%

Providing health status for monitoring systems

Spring Boot

management.endpoint.health.show-details=always
# Exposes all health details including database, disk space, and custom checks

Exposing all health details causes large JSON responses and extra processing on each request.

📉 Performance Costincreases response size by 10-50kb, adds 2-5ms processing delay per request

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Full detailed health response	N/A	N/A	N/A	[X] Bad
Minimal health response with caching	N/A	N/A	N/A	[OK] Good

Rendering Pipeline

Health endpoint requests are handled by Spring Boot controllers which gather health data, serialize it to JSON, and send it over HTTP.

→Controller processing

→Health indicator execution

→JSON serialization

→Network transfer

⚠️ BottleneckHealth indicator execution especially if slow or blocking

Optimization Tips

1Limit health endpoint details to reduce payload size and processing time.

2Cache or run slow health checks asynchronously to avoid blocking responses.

3Use authorization to control who sees detailed health information.

Performance Quiz - 3 Questions

What is a main performance benefit of customizing the health endpoint to show fewer details?

A Improves UI rendering speed on client side

B Reduces response size and speeds up health check responses

C Increases security by hiding all endpoint data

D Allows more frequent health checks without limits

DevTools: Network

How to check: Open DevTools, go to Network tab, request /actuator/health endpoint, and inspect response size and timing.

What to look for: Look for large response payloads and long waiting times indicating slow health checks or large data.

Practice

1. What is the main purpose of customizing the health endpoint in Spring Boot?

easy

A. To automatically restart the application on failure

B. To change the port number of the application

C. To add specific checks that show detailed app status

D. To disable all health checks

Solution

1. Step 1: Understand the health endpoint role

   The health endpoint shows the app's status and can be extended to include custom checks.

2. Step 2: Identify customization purpose

   Customizing allows adding specific checks to provide detailed status beyond default info.

3. Final Answer:

   To add specific checks that show detailed app status -> Option C

4. Quick Check:

   Health endpoint customization = detailed app status [OK]

Hint: Health endpoint customization means adding detailed status checks [OK]

Common Mistakes:

• Thinking it changes app port
• Assuming it disables health checks
• Believing it restarts app automatically

2. Which interface must you implement to create a custom health check in Spring Boot?

easy

A. HealthIndicator

B. HealthCheck

C. HealthService

D. HealthStatus

Solution

1. Step 1: Recall Spring Boot health customization

   Custom health checks require implementing a specific interface.

2. Step 2: Identify correct interface

   The interface to implement is HealthIndicator, which requires overriding health().

3. Final Answer:

   HealthIndicator -> Option A

4. Quick Check:

   Custom health check interface = HealthIndicator [OK]

Hint: Custom health checks need HealthIndicator interface [OK]

Common Mistakes:

• Using HealthCheck instead of HealthIndicator
• Confusing with HealthService or HealthStatus
• Not overriding health() method

3. Given this custom health indicator code, what will the health endpoint show?

public class MyHealth implements HealthIndicator {
  @Override
  public Health health() {
    return Health.up().withDetail("db", "reachable").build();
  }
}

medium

A. {"status":"UP","details":{"db":"reachable"}}

B. {"status":"DOWN","details":{"db":"reachable"}}

C. {"status":"UP"}

D. {"status":"DOWN"}

Solution

1. Step 1: Analyze health() method return

   The method returns Health.up() with a detail key "db" set to "reachable".

2. Step 2: Understand output format

   The health endpoint shows status "UP" and includes the details map with "db":"reachable".

3. Final Answer:

   {"status":"UP","details":{"db":"reachable"}} -> Option A

4. Quick Check:

   Health.up() with details = status UP plus details [OK]

Hint: Health.up() withDetail adds details and sets status UP [OK]

Common Mistakes:

• Confusing UP with DOWN status
• Ignoring details in output
• Assuming default status without details

4. Identify the error in this custom health indicator code:

public class CustomHealth implements HealthIndicator {
  public Health health() {
    return Health.down().withDetails("error", "Database unreachable").build();
  }
}

medium

A. Method should be annotated with @Override

B. withDetails() method does not exist, should be withDetail()

C. Method name should be checkHealth() instead of health()

D. Health.down() cannot be used in custom indicators

Solution

1. Step 1: Check method signature and annotations

   The method correctly named health() matches interface; @Override annotation is optional but recommended.

2. Step 2: Verify method calls on Health builder

   The method withDetails() does not exist; correct method is withDetail() for adding one detail.

3. Final Answer:

   withDetails() method does not exist, should be withDetail() -> Option B

4. Quick Check:

   Use withDetail() to add single detail [OK]

Hint: Use withDetail() not withDetails() to add details [OK]

Common Mistakes:

• Missing @Override annotation (not error but best practice)
• Wrong method name instead of health()
• Thinking Health.down() is invalid

5. You want to customize the health endpoint to show "UP" only if both database and cache are reachable. Which approach correctly implements this logic?

hard

A. Use two separate HealthIndicator classes without combining results

B. Return Health.up() always and add details for database and cache status

C. Return Health.down() always and ignore individual checks

D. Return Health.up() if both checks pass; else Health.down() with details for each failure

Solution

1. Step 1: Understand combined health logic

   The health status should be UP only if both database and cache are reachable; otherwise DOWN.

2. Step 2: Implement conditional return with details

   Return Health.up() if both pass; else return Health.down() and include details explaining which failed.

3. Final Answer:

   Return Health.up() if both checks pass; else Health.down() with details for each failure -> Option D

4. Quick Check:

   Combined checks control status UP or DOWN with details [OK]

Hint: Return UP only if all checks pass; else DOWN with failure details [OK]

Common Mistakes:

• Returning UP regardless of failures
• Ignoring combined status logic
• Splitting checks without combining results