io.opencensus.contrib.http.servlet

Class OcHttpServletFilter

java.lang.Object

io.opencensus.contrib.http.servlet.OcHttpServletFilter

All Implemented Interfaces:

javax.servlet.Filter

@ExperimentalApi
public class OcHttpServletFilter
extends Object
implements javax.servlet.Filter

This filter class implements Filter interface called by web container. The filter is used as an interceptor to enable tracing of http requests.

Since:

0.19

Field Summary

Fields

Modifier and Type	Field and Description
static String	OC_EXTRACTOR Set optional OC_EXTRACTOR attribute in ServletContext with HttpExtractor customExtractor.
static String	OC_PUBLIC_ENDPOINT Set optional OC_PUBLIC_ENDPOINT attribute in ServletContext with Boolean publicEndpoint.
static String	OC_TRACE_PROPAGATOR Set optional OC_TRACE_PROPAGATOR attribute in ServletContext with TextFormat propagator.

Constructor Summary

Constructors

Constructor and Description
OcHttpServletFilter() Creates a new OcHttpServletFilter.

Method Summary

Modifier and Type	Method and Description
void	destroy()
void	doFilter(javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, javax.servlet.FilterChain chain)
void	init(javax.servlet.FilterConfig filterConfig)

Methods inherited from class java.lang.Object

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

Field Detail

OC_TRACE_PROPAGATOR

public static final String OC_TRACE_PROPAGATOR

Set optional OC_TRACE_PROPAGATOR attribute in ServletContext with TextFormat propagator. By default TraceContextFormat is used to propagate trace context.

Since:

0.20

See Also:

Constant Field Values

OC_EXTRACTOR

public static final String OC_EXTRACTOR

Set optional OC_EXTRACTOR attribute in ServletContext with HttpExtractor customExtractor. Default extractor is used if custom extractor is not provided.

Since:

0.20

See Also:

Constant Field Values

OC_PUBLIC_ENDPOINT

public static final String OC_PUBLIC_ENDPOINT

Set optional OC_PUBLIC_ENDPOINT attribute in ServletContext with Boolean publicEndpoint. set to true for publicly accessible HTTP(S) server. If true then incoming * tracecontext will be added as a link instead of as a parent. By default it is set to true.

Since:

0.20

See Also:

Constant Field Values

Constructor Detail

OcHttpServletFilter

public OcHttpServletFilter()

Creates a new OcHttpServletFilter.

Method Detail

init

public void init(javax.servlet.FilterConfig filterConfig)
          throws javax.servlet.ServletException

Specified by:

init in interface javax.servlet.Filter

Throws:

javax.servlet.ServletException

doFilter

public void doFilter(javax.servlet.ServletRequest request,
                     javax.servlet.ServletResponse response,
                     javax.servlet.FilterChain chain)
              throws IOException,
                     javax.servlet.ServletException

Specified by:

doFilter in interface javax.servlet.Filter

Throws:

IOException

javax.servlet.ServletException

destroy

public void destroy()

Specified by:

destroy in interface javax.servlet.Filter