Module brave.http

Package brave.http

Class HttpClientParser

java.lang.Object

brave.http.HttpParser

brave.http.HttpClientParser

public class HttpClientParser
extends HttpParser

Parses the request and response into reasonable defaults for http client spans. Subclass to customize, for example, to add tags based on response headers.

Constructor Summary

Constructors

Constructor	Description
HttpClientParser()

Method Summary

Modifier and Type	Method	Description
<Req> void	request(HttpAdapter<Req,?> adapter, Req req, SpanCustomizer customizer)	Customizes the span based on the request that will be sent to the server.
<Resp> void	response(HttpAdapter<?,Resp> adapter, Resp res, java.lang.Throwable error, SpanCustomizer customizer)	Customizes the span based on the response received from the server.

Methods inherited from class brave.http.HttpParser

error, errorParser, spanName

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpClientParser

public HttpClientParser()

Method Detail

request

public <Req> void request(HttpAdapter<Req,?> adapter,
                          Req req,
                          SpanCustomizer customizer)

Customizes the span based on the request that will be sent to the server.

Override to change what data from the http request are parsed into the span representing it. By default, this sets the span name to the http method and tags "http.method" and "http.path".

If you only want to change the span name, you can override HttpParser.spanName(HttpAdapter, Object) instead.

Overrides:

request in class HttpParser

See Also:

HttpParser.spanName(HttpAdapter, Object)

response

public <Resp> void response(HttpAdapter<?,Resp> adapter,
                            @Nullable
                            Resp res,
                            @Nullable
                            java.lang.Throwable error,
                            SpanCustomizer customizer)

Customizes the span based on the response received from the server.

Override to change what data from the http response or error are parsed into the span modeling it.

By default, this tags "http.status_code" when it is not 2xx. If there's an exception or the status code is neither 2xx nor 3xx, it tags "error". This also overrides the span name based on the HttpAdapter.methodFromResponse(Object) and HttpAdapter.route(Object) where possible (ex "get /users/:userId").

If routing is supported, and a GET didn't match due to 404, the span name will be "get not_found". If it didn't match due to redirect, the span name will be "get redirected". If routing is not supported, the span name is left alone.

If you only want to change how exceptions are parsed, override HttpParser.error(Integer, Throwable, SpanCustomizer) instead.

Note: Either the response or error parameters may be null, but not both.

Overrides:

response in class HttpParser

See Also:

HttpParser.error(Integer, Throwable, SpanCustomizer)