Class HttpErrorHandlingPolicy

Object

HttpErrorHandlingPolicy

@StableApi
public final class HttpErrorHandlingPolicy
extends Object

Controls how the HTTPServer handles exceptions raised while scraping metrics.

The default policy built by builder() does not expose exception details and does not report the exception. Configure the builder to route diagnostic details to an application-appropriate sink.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	HttpErrorHandlingPolicy.Builder	Builder for HttpErrorHandlingPolicy.

Method Summary

Modifier and Type	Method	Description
static HttpErrorHandlingPolicy.Builder	builder()	Returns a builder for configuring scrape error handling.
static Consumer<Throwable>	julReporter()	Returns a synchronous reporter that logs scrape exceptions at Level.SEVERE using JUL.

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

builder

public static HttpErrorHandlingPolicy.Builder builder()

Returns a builder for configuring scrape error handling.

The builder defaults to a generic HTTP 500 response with no error reporter. This avoids exposing exception details to scrape clients or adding an implicit dependency on an application's logging configuration.

julReporter

public static Consumer<Throwable> julReporter()

Returns a synchronous reporter that logs scrape exceptions at Level.SEVERE using JUL.

Reporting is opt-in; the default policy does not log scrape exceptions.