LoggingServiceBuilder (filter-service-metrics 1.13 1.13 API)

java.lang.Object
- com.linecorp.armeria.common.logging.LoggingDecoratorBuilder
- - com.linecorp.armeria.server.logging.LoggingServiceBuilder

public final class LoggingServiceBuilder
extends LoggingDecoratorBuilder

Builds a new LoggingService.

Constructor Summary

Constructors
Constructor and Description

LoggingServiceBuilder()
Deprecated.
Use LoggingService.builder().

Constructors
Constructor and Description
`LoggingServiceBuilder()` Deprecated. Use `LoggingService.builder()`.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`LoggingService`	`build(HttpService delegate)` Returns a newly-created `LoggingService` decorating `HttpService` based on the properties of this builder.
`LoggingServiceBuilder`	`contentSanitizer(Function<Object,?> contentSanitizer)` Sets the `Function` to use to sanitize request and response content before logging.
`LoggingServiceBuilder`	`failureResponseLogLevel(LogLevel failedResponseLogLevel)` Sets the `LogLevel` to use when logging failure responses (e.g., failed with an exception).
`LoggingServiceBuilder`	`headersSanitizer(Function<? super HttpHeaders,?> headersSanitizer)` Sets the `Function` to use to sanitize request, response and trailers before logging.
`LoggingServiceBuilder`	`logger(org.slf4j.Logger logger)` Sets the `Logger` to use when logging.
`Function<? super HttpService,LoggingService>`	`newDecorator()` Returns a newly-created `LoggingService` decorator based on the properties of this builder.
`LoggingServiceBuilder`	`requestContentSanitizer(Function<Object,?> requestContentSanitizer)` Sets the `Function` to use to sanitize request content before logging.
`LoggingServiceBuilder`	`requestHeadersSanitizer(Function<? super HttpHeaders,?> requestHeadersSanitizer)` Sets the `Function` to use to sanitize request headers before logging.
`LoggingServiceBuilder`	`requestLogLevel(LogLevel requestLogLevel)` Sets the `LogLevel` to use when logging requests.
`LoggingServiceBuilder`	`requestLogLevelMapper(Function<? super RequestOnlyLog,LogLevel> requestLogLevelMapper)` Sets the `Function` to use when mapping the log level of request logs.
`LoggingServiceBuilder`	`requestTrailersSanitizer(Function<? super HttpHeaders,?> requestTrailersSanitizer)` Sets the `Function` to use to sanitize request trailers before logging.
`LoggingServiceBuilder`	`responseCauseSanitizer(Function<? super Throwable,?> responseCauseSanitizer)` Sets the `Function` to use to sanitize a response cause before logging.
`LoggingServiceBuilder`	`responseContentSanitizer(Function<Object,?> responseContentSanitizer)` Sets the `Function` to use to sanitize response content before logging.
`LoggingServiceBuilder`	`responseHeadersSanitizer(Function<? super HttpHeaders,?> responseHeadersSanitizer)` Sets the `Function` to use to sanitize response headers before logging.
`LoggingServiceBuilder`	`responseLogLevelMapper(Function<? super RequestLog,LogLevel> responseLogLevelMapper)` Sets the `Function` to use when mapping the log level of response logs.
`LoggingServiceBuilder`	`responseTrailersSanitizer(Function<? super HttpHeaders,?> responseTrailersSanitizer)` Sets the `Function` to use to sanitize response trailers before logging.
`LoggingServiceBuilder`	`sampler(Sampler<? super ServiceRequestContext> sampler)` Sets the `Sampler` that determines which request needs logging.
`LoggingServiceBuilder`	`samplingRate(float samplingRate)` Sets the rate at which to sample requests to log.
`LoggingServiceBuilder`	`successfulResponseLogLevel(LogLevel successfulResponseLogLevel)` Sets the `LogLevel` to use when logging successful responses (e.g., no unhandled exception).

Methods inherited from class com.linecorp.armeria.common.logging.LoggingDecoratorBuilder
failedResponseLogLevel, logger, requestContentSanitizer, requestHeadersSanitizer, requestLogLevel, requestLogLevelMapper, requestTrailersSanitizer, responseCauseSanitizer, responseContentSanitizer, responseHeadersSanitizer, responseLogLevelMapper, responseTrailersSanitizer, successfulResponseLogLevel, toString

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - LoggingServiceBuilder
```
@Deprecated
public LoggingServiceBuilder()
```
    Deprecated. Use LoggingService.builder().
    
    Creates a new LoggingServiceBuilder.
- Method Detail
  - sampler
```
public LoggingServiceBuilder sampler(Sampler<? super ServiceRequestContext> sampler)
```
    Sets the Sampler that determines which request needs logging.
  - samplingRate
```
public LoggingServiceBuilder samplingRate(float samplingRate)
```
    Sets the rate at which to sample requests to log. Any number between 0.0 and 1.0 will cause a random sample of the requests to be logged.
  - build
```
public LoggingService build(HttpService delegate)
```
    Returns a newly-created LoggingService decorating HttpService based on the properties of this builder.
  - newDecorator
```
public Function<? super HttpService,LoggingService> newDecorator()
```
    Returns a newly-created LoggingService decorator based on the properties of this builder.
  - logger
```
public LoggingServiceBuilder logger(org.slf4j.Logger logger)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the Logger to use when logging. If unset, a default Logger will be used.
    
    Overrides:
    
    logger in class LoggingDecoratorBuilder
  - requestLogLevel
```
public LoggingServiceBuilder requestLogLevel(LogLevel requestLogLevel)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the LogLevel to use when logging requests. If unset, will use LogLevel.TRACE.
    
    Overrides:
    
    requestLogLevel in class LoggingDecoratorBuilder
  - successfulResponseLogLevel
```
public LoggingServiceBuilder successfulResponseLogLevel(LogLevel successfulResponseLogLevel)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the LogLevel to use when logging successful responses (e.g., no unhandled exception). If unset, will use LogLevel.TRACE.
    
    Overrides:
    
    successfulResponseLogLevel in class LoggingDecoratorBuilder
  - failureResponseLogLevel
```
public LoggingServiceBuilder failureResponseLogLevel(LogLevel failedResponseLogLevel)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the LogLevel to use when logging failure responses (e.g., failed with an exception). If unset, will use LogLevel.WARN. The request will be logged too if it was not otherwise.
    
    Overrides:
    
    failureResponseLogLevel in class LoggingDecoratorBuilder
  - requestLogLevelMapper
```
public LoggingServiceBuilder requestLogLevelMapper(Function<? super RequestOnlyLog,LogLevel> requestLogLevelMapper)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the Function to use when mapping the log level of request logs.
    
    Overrides:
    
    requestLogLevelMapper in class LoggingDecoratorBuilder
  - responseLogLevelMapper
```
public LoggingServiceBuilder responseLogLevelMapper(Function<? super RequestLog,LogLevel> responseLogLevelMapper)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the Function to use when mapping the log level of response logs.
    
    Overrides:
    
    responseLogLevelMapper in class LoggingDecoratorBuilder
  - requestHeadersSanitizer
```
public LoggingServiceBuilder requestHeadersSanitizer(Function<? super HttpHeaders,?> requestHeadersSanitizer)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the Function to use to sanitize request headers before logging. It is common to have the Function that removes sensitive headers, like Cookie, before logging. If unset, will use Function.identity().
    
    Overrides:
    
    requestHeadersSanitizer in class LoggingDecoratorBuilder
  - responseHeadersSanitizer
```
public LoggingServiceBuilder responseHeadersSanitizer(Function<? super HttpHeaders,?> responseHeadersSanitizer)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the Function to use to sanitize response headers before logging. It is common to have the Function that removes sensitive headers, like Set-Cookie, before logging. If unset, will use Function.identity().
    
    Overrides:
    
    responseHeadersSanitizer in class LoggingDecoratorBuilder
  - requestTrailersSanitizer
```
public LoggingServiceBuilder requestTrailersSanitizer(Function<? super HttpHeaders,?> requestTrailersSanitizer)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the Function to use to sanitize request trailers before logging. If unset, will use Function.identity().
    
    Overrides:
    
    requestTrailersSanitizer in class LoggingDecoratorBuilder
  - responseTrailersSanitizer
```
public LoggingServiceBuilder responseTrailersSanitizer(Function<? super HttpHeaders,?> responseTrailersSanitizer)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the Function to use to sanitize response trailers before logging. If unset, will use Function.identity().
    
    Overrides:
    
    responseTrailersSanitizer in class LoggingDecoratorBuilder
  - headersSanitizer
```
public LoggingServiceBuilder headersSanitizer(Function<? super HttpHeaders,?> headersSanitizer)
```
    Description copied from class: LoggingDecoratorBuilder
    Sets the Function to use to sanitize request, response and trailers before logging. It is common to have the Function that removes sensitive headers, like "Cookie" and "Set-Cookie", before logging. This method is a shortcut for:
```
 builder.requestHeadersSanitizer(headersSanitizer);
 builder.requestTrailersSanitizer(headersSanitizer);
 builder.responseHeadersSanitizer(headersSanitizer);
 builder.responseTrailersSanitizer(headersSanitizer);
 
```
    Overrides:
    
    headersSanitizer in class LoggingDecoratorBuilder
    
    See Also:
    
    LoggingDecoratorBuilder.requestHeadersSanitizer(Function), LoggingDecoratorBuilder.requestTrailersSanitizer(Function), LoggingDecoratorBuilder.responseHeadersSanitizer(Function), LoggingDecoratorBuilder.responseTrailersSanitizer(Function)
  - requestContentSanitizer
```
public LoggingServiceBuilder requestContentSanitizer(Function<Object,?> requestContentSanitizer)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the Function to use to sanitize request content before logging. It is common to have the Function that removes sensitive content, such as an GPS location query, before logging. If unset, will use Function.identity().
    
    Overrides:
    
    requestContentSanitizer in class LoggingDecoratorBuilder
  - responseContentSanitizer
```
public LoggingServiceBuilder responseContentSanitizer(Function<Object,?> responseContentSanitizer)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the Function to use to sanitize response content before logging. It is common to have the Function that removes sensitive content, such as an address, before logging. If unset, will use Function.identity().
    
    Overrides:
    
    responseContentSanitizer in class LoggingDecoratorBuilder
  - contentSanitizer
```
public LoggingServiceBuilder contentSanitizer(Function<Object,?> contentSanitizer)
```
    Description copied from class: LoggingDecoratorBuilder
    Sets the Function to use to sanitize request and response content before logging. It is common to have the Function that removes sensitive content, such as an GPS location query and an address, before logging. If unset, will use Function.identity(). This method is a shortcut for:
```
 builder.requestContentSanitizer(contentSanitizer);
 builder.responseContentSanitizer(contentSanitizer);
 
```
    Overrides:
    
    contentSanitizer in class LoggingDecoratorBuilder
    
    See Also:
    
    LoggingDecoratorBuilder.requestContentSanitizer(Function), LoggingDecoratorBuilder.responseContentSanitizer(Function)
  - responseCauseSanitizer
```
public LoggingServiceBuilder responseCauseSanitizer(Function<? super Throwable,?> responseCauseSanitizer)
```
    Description copied from class: LoggingDecoratorBuilder
    
    Sets the Function to use to sanitize a response cause before logging. You can sanitize the stack trace of the exception to remove sensitive information, or prevent from logging the stack trace completely by returning null in the Function. If unset, will use Function.identity().
    
    Overrides:
    
    responseCauseSanitizer in class LoggingDecoratorBuilder

Class LoggingServiceBuilder

Constructor Summary

Method Summary

Methods inherited from class com.linecorp.armeria.common.logging.LoggingDecoratorBuilder

Methods inherited from class java.lang.Object

Constructor Detail

LoggingServiceBuilder

Method Detail

sampler

samplingRate

build

newDecorator

logger

requestLogLevel

successfulResponseLogLevel

failureResponseLogLevel

requestLogLevelMapper

responseLogLevelMapper

requestHeadersSanitizer

responseHeadersSanitizer

requestTrailersSanitizer

responseTrailersSanitizer

headersSanitizer

requestContentSanitizer

responseContentSanitizer

contentSanitizer

responseCauseSanitizer