Package com.linecorp.armeria.server.metric

Class MetricCollectingService

java.lang.Object

com.linecorp.armeria.common.util.AbstractUnwrappable<Service<T_I,T_O>>

com.linecorp.armeria.server.DecoratingService<I,O,I,O>

com.linecorp.armeria.server.SimpleDecoratingService<HttpRequest,HttpResponse>

com.linecorp.armeria.server.SimpleDecoratingHttpService

com.linecorp.armeria.server.metric.MetricCollectingService

All Implemented Interfaces:

Unwrappable, HttpService, Service<HttpRequest,HttpResponse>

public final class MetricCollectingService
extends SimpleDecoratingHttpService

Decorates an HttpService to collect metrics into MeterRegistry.

Example:

 serverBuilder.service(
         "/service",
         THttpService.of(handler)
                     .decorate(MetricCollectingService.newDecorator(
                             MeterIdPrefixFunction.ofDefault("myService"))));
 
 

It is generally recommended not to use a class or package name as a metric name, because otherwise seemingly harmless refactoring such as rename may break metric collection.

Method Summary

Modifier and Type	Method	Description
static MetricCollectingServiceBuilder	builder(MeterIdPrefixFunction meterIdPrefixFunction)	Returns a newly created MetricCollectingServiceBuilder.
static Function<? super HttpService,MetricCollectingService>	newDecorator(MeterIdPrefixFunction meterIdPrefixFunction)	Returns a new HttpService decorator that tracks request stats using MeterRegistry.
HttpResponse	serve(ServiceRequestContext ctx, HttpRequest req)	Serves an incoming Request.

Methods inherited from class com.linecorp.armeria.server.SimpleDecoratingHttpService

exchangeType

Methods inherited from class com.linecorp.armeria.server.DecoratingService

serviceAdded, shouldCachePath

Methods inherited from class com.linecorp.armeria.common.util.AbstractUnwrappable

as, toString, unwrap

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.linecorp.armeria.server.HttpService

decorate, decorate

Methods inherited from interface com.linecorp.armeria.server.Service

as, serviceAdded, shouldCachePath, unwrap

Method Details

newDecorator

public static Function<? super HttpService,MetricCollectingService> newDecorator(MeterIdPrefixFunction meterIdPrefixFunction)

Returns a new HttpService decorator that tracks request stats using MeterRegistry.

builder

public static MetricCollectingServiceBuilder builder(MeterIdPrefixFunction meterIdPrefixFunction)

Returns a newly created MetricCollectingServiceBuilder.

serve

public HttpResponse serve(ServiceRequestContext ctx,
 HttpRequest req)
                   throws Exception

Description copied from interface: Service

Serves an incoming Request.

Parameters:

ctx - the context of the received Request

req - the received Request

Returns:

the Response

Throws:

Exception