Update servlet-3 to new agent api

This commit is contained in:
Trask Stalnaker 2019-10-19 11:57:47 -07:00
parent 4a2517a7d3
commit a5c54c54f7
8 changed files with 56 additions and 160 deletions

View File

@ -2,6 +2,8 @@ package datadog.trace.instrumentation.servlet3;
import static datadog.trace.agent.decorator.HttpServerDecorator.DD_SPAN_ATTRIBUTE; import static datadog.trace.agent.decorator.HttpServerDecorator.DD_SPAN_ATTRIBUTE;
import static datadog.trace.agent.tooling.ByteBuddyElementMatchers.safeHasSuperType; import static datadog.trace.agent.tooling.ByteBuddyElementMatchers.safeHasSuperType;
import static datadog.trace.instrumentation.api.AgentTracer.propagate;
import static datadog.trace.instrumentation.servlet3.HttpServletRequestInjectAdapter.SETTER;
import static java.util.Collections.singletonMap; import static java.util.Collections.singletonMap;
import static net.bytebuddy.matcher.ElementMatchers.isInterface; import static net.bytebuddy.matcher.ElementMatchers.isInterface;
import static net.bytebuddy.matcher.ElementMatchers.isMethod; import static net.bytebuddy.matcher.ElementMatchers.isMethod;
@ -12,9 +14,7 @@ import static net.bytebuddy.matcher.ElementMatchers.not;
import com.google.auto.service.AutoService; import com.google.auto.service.AutoService;
import datadog.trace.agent.tooling.Instrumenter; import datadog.trace.agent.tooling.Instrumenter;
import datadog.trace.bootstrap.CallDepthThreadLocalMap; import datadog.trace.bootstrap.CallDepthThreadLocalMap;
import io.opentracing.Span; import datadog.trace.instrumentation.api.AgentSpan;
import io.opentracing.propagation.Format;
import io.opentracing.util.GlobalTracer;
import java.util.Map; import java.util.Map;
import javax.servlet.AsyncContext; import javax.servlet.AsyncContext;
import javax.servlet.ServletRequest; import javax.servlet.ServletRequest;
@ -64,17 +64,13 @@ public final class AsyncContextInstrumentation extends Instrumenter.Default {
final ServletRequest request = context.getRequest(); final ServletRequest request = context.getRequest();
final Object spanAttr = request.getAttribute(DD_SPAN_ATTRIBUTE); final Object spanAttr = request.getAttribute(DD_SPAN_ATTRIBUTE);
if (spanAttr instanceof Span) { if (spanAttr instanceof AgentSpan) {
request.removeAttribute(DD_SPAN_ATTRIBUTE); request.removeAttribute(DD_SPAN_ATTRIBUTE);
final Span span = (Span) spanAttr; final AgentSpan span = (AgentSpan) spanAttr;
// Override propagation headers by injecting attributes from the current span // Override propagation headers by injecting attributes from the current span
// into the new request // into the new request
if (request instanceof HttpServletRequest) { if (request instanceof HttpServletRequest) {
GlobalTracer.get() propagate().inject(span, (HttpServletRequest) request, SETTER);
.inject(
span.context(),
Format.Builtin.TEXT_MAP,
new HttpServletRequestInjectAdapter((HttpServletRequest) request));
} }
final String path; final String path;
if (args.length == 1 && args[0] instanceof String) { if (args.length == 1 && args[0] instanceof String) {

View File

@ -28,7 +28,6 @@ public final class FilterChain3Instrumentation extends Instrumenter.Default {
"datadog.trace.agent.decorator.ServerDecorator", "datadog.trace.agent.decorator.ServerDecorator",
"datadog.trace.agent.decorator.HttpServerDecorator", "datadog.trace.agent.decorator.HttpServerDecorator",
packageName + ".HttpServletRequestExtractAdapter", packageName + ".HttpServletRequestExtractAdapter",
packageName + ".HttpServletRequestExtractAdapter$MultivaluedMapFlatIterator",
packageName + ".Servlet3Decorator", packageName + ".Servlet3Decorator",
packageName + ".TagSettingAsyncListener" packageName + ".TagSettingAsyncListener"
}; };

View File

@ -28,7 +28,6 @@ public final class HttpServlet3Instrumentation extends Instrumenter.Default {
"datadog.trace.agent.decorator.ServerDecorator", "datadog.trace.agent.decorator.ServerDecorator",
"datadog.trace.agent.decorator.HttpServerDecorator", "datadog.trace.agent.decorator.HttpServerDecorator",
packageName + ".HttpServletRequestExtractAdapter", packageName + ".HttpServletRequestExtractAdapter",
packageName + ".HttpServletRequestExtractAdapter$MultivaluedMapFlatIterator",
packageName + ".Servlet3Decorator", packageName + ".Servlet3Decorator",
packageName + ".TagSettingAsyncListener", packageName + ".TagSettingAsyncListener",
}; };

View File

@ -1,111 +1,34 @@
package datadog.trace.instrumentation.servlet3; package datadog.trace.instrumentation.servlet3;
import io.opentracing.propagation.TextMap; import datadog.trace.instrumentation.api.AgentPropagation;
import java.util.AbstractMap;
import java.util.ArrayList; import java.util.ArrayList;
import java.util.Collections; import java.util.Collections;
import java.util.Enumeration;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List; import java.util.List;
import java.util.Map;
import java.util.Set;
import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletRequest;
/** public class HttpServletRequestExtractAdapter
* Tracer extract adapter for {@link HttpServletRequest}. implements AgentPropagation.Getter<HttpServletRequest> {
*
* @author Pavol Loffay
*/
// FIXME: This code is duplicated in several places. Extract to a common dependency.
public class HttpServletRequestExtractAdapter implements TextMap {
private final Map<String, List<String>> headers; public static final HttpServletRequestExtractAdapter GETTER =
new HttpServletRequestExtractAdapter();
public HttpServletRequestExtractAdapter(final HttpServletRequest httpServletRequest) { @Override
headers = servletHeadersToMultiMap(httpServletRequest); public List<String> keys(final HttpServletRequest carrier) {
final ArrayList<String> keys = Collections.list(carrier.getHeaderNames());
keys.addAll(Collections.list(carrier.getAttributeNames()));
return keys;
} }
@Override @Override
public Iterator<Map.Entry<String, String>> iterator() { public String get(final HttpServletRequest carrier, final String key) {
return new MultivaluedMapFlatIterator<>(headers.entrySet());
}
@Override
public void put(final String key, final String value) {
throw new UnsupportedOperationException("This class should be used only with Tracer.inject()!");
}
protected Map<String, List<String>> servletHeadersToMultiMap(
final HttpServletRequest httpServletRequest) {
final Map<String, List<String>> headersResult = new HashMap<>();
final Enumeration<String> headerNamesIt = httpServletRequest.getHeaderNames();
while (headerNamesIt.hasMoreElements()) {
final String headerName = headerNamesIt.nextElement();
final Enumeration<String> valuesIt = httpServletRequest.getHeaders(headerName);
final List<String> valuesList = new ArrayList<>(1);
while (valuesIt.hasMoreElements()) {
valuesList.add(valuesIt.nextElement());
}
headersResult.put(headerName, valuesList);
}
/* /*
* Read from the attributes and override the headers. * Read from the attributes and override the headers.
* This is used by HttpServletRequestInjectAdapter when a request is async-dispatched. * This is used by HttpServletRequestSetter when a request is async-dispatched.
*/ */
final Enumeration<String> attributeNamesIt = httpServletRequest.getAttributeNames(); final Object attribute = carrier.getAttribute(key);
while (attributeNamesIt.hasMoreElements()) { if (attribute instanceof String) {
final String attributeName = attributeNamesIt.nextElement(); return (String) attribute;
final Object valuesIt = httpServletRequest.getAttribute(attributeName);
if (valuesIt instanceof String) {
headersResult.put(attributeName, Collections.singletonList((String) valuesIt));
}
}
return headersResult;
}
public static final class MultivaluedMapFlatIterator<K, V> implements Iterator<Map.Entry<K, V>> {
private final Iterator<Map.Entry<K, List<V>>> mapIterator;
private Map.Entry<K, List<V>> mapEntry;
private Iterator<V> listIterator;
public MultivaluedMapFlatIterator(final Set<Map.Entry<K, List<V>>> multiValuesEntrySet) {
mapIterator = multiValuesEntrySet.iterator();
}
@Override
public boolean hasNext() {
if (listIterator != null && listIterator.hasNext()) {
return true;
}
return mapIterator.hasNext();
}
@Override
public Map.Entry<K, V> next() {
if (mapEntry == null || (!listIterator.hasNext() && mapIterator.hasNext())) {
mapEntry = mapIterator.next();
listIterator = mapEntry.getValue().iterator();
}
if (listIterator.hasNext()) {
return new AbstractMap.SimpleImmutableEntry<>(mapEntry.getKey(), listIterator.next());
} else {
return new AbstractMap.SimpleImmutableEntry<>(mapEntry.getKey(), null);
}
}
@Override
public void remove() {
throw new UnsupportedOperationException();
} }
return carrier.getHeader(key);
} }
} }

View File

@ -1,27 +1,17 @@
package datadog.trace.instrumentation.servlet3; package datadog.trace.instrumentation.servlet3;
import io.opentracing.propagation.TextMap; import datadog.trace.instrumentation.api.AgentPropagation;
import java.util.Iterator;
import java.util.Map;
import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletRequest;
/** Inject into request attributes since the request headers can't be modified. */ /** Inject into request attributes since the request headers can't be modified. */
public class HttpServletRequestInjectAdapter implements TextMap { public class HttpServletRequestInjectAdapter
implements AgentPropagation.Setter<HttpServletRequest> {
private final HttpServletRequest httpServletRequest; public static final HttpServletRequestInjectAdapter SETTER =
new HttpServletRequestInjectAdapter();
public HttpServletRequestInjectAdapter(final HttpServletRequest httpServletRequest) {
this.httpServletRequest = httpServletRequest;
}
@Override @Override
public Iterator<Map.Entry<String, String>> iterator() { public void set(final HttpServletRequest carrier, final String key, final String value) {
throw new UnsupportedOperationException( carrier.setAttribute(key, value);
"This class should be used only with Tracer.extract()!");
}
@Override
public void put(final String key, final String value) {
httpServletRequest.setAttribute(key, value);
} }
} }

View File

@ -1,16 +1,16 @@
package datadog.trace.instrumentation.servlet3; package datadog.trace.instrumentation.servlet3;
import static datadog.trace.agent.decorator.HttpServerDecorator.DD_SPAN_ATTRIBUTE; import static datadog.trace.agent.decorator.HttpServerDecorator.DD_SPAN_ATTRIBUTE;
import static datadog.trace.instrumentation.api.AgentTracer.activateSpan;
import static datadog.trace.instrumentation.api.AgentTracer.propagate;
import static datadog.trace.instrumentation.api.AgentTracer.startSpan;
import static datadog.trace.instrumentation.servlet3.HttpServletRequestExtractAdapter.GETTER;
import static datadog.trace.instrumentation.servlet3.Servlet3Decorator.DECORATE; import static datadog.trace.instrumentation.servlet3.Servlet3Decorator.DECORATE;
import datadog.trace.api.DDTags; import datadog.trace.api.DDTags;
import datadog.trace.context.TraceScope; import datadog.trace.instrumentation.api.AgentScope;
import io.opentracing.Scope; import datadog.trace.instrumentation.api.AgentSpan;
import io.opentracing.Span;
import io.opentracing.SpanContext;
import io.opentracing.propagation.Format;
import io.opentracing.tag.Tags; import io.opentracing.tag.Tags;
import io.opentracing.util.GlobalTracer;
import java.security.Principal; import java.security.Principal;
import java.util.concurrent.atomic.AtomicBoolean; import java.util.concurrent.atomic.AtomicBoolean;
import javax.servlet.ServletRequest; import javax.servlet.ServletRequest;
@ -22,7 +22,7 @@ import net.bytebuddy.asm.Advice;
public class Servlet3Advice { public class Servlet3Advice {
@Advice.OnMethodEnter(suppress = Throwable.class) @Advice.OnMethodEnter(suppress = Throwable.class)
public static Scope startSpan( public static AgentScope onEnter(
@Advice.This final Object servlet, @Advice.Argument(0) final ServletRequest req) { @Advice.This final Object servlet, @Advice.Argument(0) final ServletRequest req) {
final Object spanAttr = req.getAttribute(DD_SPAN_ATTRIBUTE); final Object spanAttr = req.getAttribute(DD_SPAN_ATTRIBUTE);
if (!(req instanceof HttpServletRequest) || spanAttr != null) { if (!(req instanceof HttpServletRequest) || spanAttr != null) {
@ -31,30 +31,19 @@ public class Servlet3Advice {
} }
final HttpServletRequest httpServletRequest = (HttpServletRequest) req; final HttpServletRequest httpServletRequest = (HttpServletRequest) req;
final SpanContext extractedContext = final AgentSpan.Context extractedContext = propagate().extract(httpServletRequest, GETTER);
GlobalTracer.get()
.extract(
Format.Builtin.HTTP_HEADERS,
new HttpServletRequestExtractAdapter(httpServletRequest));
final Scope scope = final AgentSpan span =
GlobalTracer.get() startSpan("servlet.request", extractedContext)
.buildSpan("servlet.request") .setTag("span.origin.type", servlet.getClass().getName());
.ignoreActiveSpan()
.asChildOf(extractedContext)
.withTag("span.origin.type", servlet.getClass().getName())
.startActive(false);
final Span span = scope.span();
DECORATE.afterStart(span); DECORATE.afterStart(span);
DECORATE.onConnection(span, httpServletRequest); DECORATE.onConnection(span, httpServletRequest);
DECORATE.onRequest(span, httpServletRequest); DECORATE.onRequest(span, httpServletRequest);
if (scope instanceof TraceScope) {
((TraceScope) scope).setAsyncPropagation(true);
}
req.setAttribute(DD_SPAN_ATTRIBUTE, span); req.setAttribute(DD_SPAN_ATTRIBUTE, span);
final AgentScope scope = activateSpan(span, false);
scope.setAsyncPropagation(true);
return scope; return scope;
} }
@ -62,14 +51,14 @@ public class Servlet3Advice {
public static void stopSpan( public static void stopSpan(
@Advice.Argument(0) final ServletRequest request, @Advice.Argument(0) final ServletRequest request,
@Advice.Argument(1) final ServletResponse response, @Advice.Argument(1) final ServletResponse response,
@Advice.Enter final Scope scope, @Advice.Enter final AgentScope scope,
@Advice.Thrown final Throwable throwable) { @Advice.Thrown final Throwable throwable) {
// Set user.principal regardless of who created this span. // Set user.principal regardless of who created this span.
final Object spanAttr = request.getAttribute(DD_SPAN_ATTRIBUTE); final Object spanAttr = request.getAttribute(DD_SPAN_ATTRIBUTE);
if (spanAttr instanceof Span && request instanceof HttpServletRequest) { if (spanAttr instanceof AgentSpan && request instanceof HttpServletRequest) {
final Principal principal = ((HttpServletRequest) request).getUserPrincipal(); final Principal principal = ((HttpServletRequest) request).getUserPrincipal();
if (principal != null) { if (principal != null) {
((Span) spanAttr).setTag(DDTags.USER_NAME, principal.getName()); ((AgentSpan) spanAttr).setTag(DDTags.USER_NAME, principal.getName());
} }
} }
@ -77,13 +66,13 @@ public class Servlet3Advice {
if (request instanceof HttpServletRequest && response instanceof HttpServletResponse) { if (request instanceof HttpServletRequest && response instanceof HttpServletResponse) {
final HttpServletRequest req = (HttpServletRequest) request; final HttpServletRequest req = (HttpServletRequest) request;
final HttpServletResponse resp = (HttpServletResponse) response; final HttpServletResponse resp = (HttpServletResponse) response;
final Span span = scope.span(); final AgentSpan span = scope.span();
if (throwable != null) { if (throwable != null) {
DECORATE.onResponse(span, resp); DECORATE.onResponse(span, resp);
if (resp.getStatus() == HttpServletResponse.SC_OK) { if (resp.getStatus() == HttpServletResponse.SC_OK) {
// exception is thrown in filter chain, but status code is incorrect // exception is thrown in filter chain, but status code is incorrect
Tags.HTTP_STATUS.set(span, 500); span.setTag(Tags.HTTP_STATUS.getKey(), 500);
} }
DECORATE.onError(span, throwable); DECORATE.onError(span, throwable);
DECORATE.beforeFinish(span); DECORATE.beforeFinish(span);

View File

@ -1,7 +1,7 @@
package datadog.trace.instrumentation.servlet3; package datadog.trace.instrumentation.servlet3;
import datadog.trace.agent.decorator.HttpServerDecorator; import datadog.trace.agent.decorator.HttpServerDecorator;
import io.opentracing.Span; import datadog.trace.instrumentation.api.AgentSpan;
import java.net.URI; import java.net.URI;
import java.net.URISyntaxException; import java.net.URISyntaxException;
import javax.servlet.ServletException; import javax.servlet.ServletException;
@ -53,7 +53,7 @@ public class Servlet3Decorator
} }
@Override @Override
public Span onRequest(final Span span, final HttpServletRequest request) { public AgentSpan onRequest(final AgentSpan span, final HttpServletRequest request) {
assert span != null; assert span != null;
if (request != null) { if (request != null) {
span.setTag("servlet.context", request.getContextPath()); span.setTag("servlet.context", request.getContextPath());
@ -62,7 +62,7 @@ public class Servlet3Decorator
} }
@Override @Override
public Span onError(final Span span, final Throwable throwable) { public AgentSpan onError(final AgentSpan span, final Throwable throwable) {
if (throwable instanceof ServletException && throwable.getCause() != null) { if (throwable instanceof ServletException && throwable.getCause() != null) {
super.onError(span, throwable.getCause()); super.onError(span, throwable.getCause());
} else { } else {

View File

@ -2,7 +2,7 @@ package datadog.trace.instrumentation.servlet3;
import static datadog.trace.instrumentation.servlet3.Servlet3Decorator.DECORATE; import static datadog.trace.instrumentation.servlet3.Servlet3Decorator.DECORATE;
import io.opentracing.Span; import datadog.trace.instrumentation.api.AgentSpan;
import io.opentracing.tag.Tags; import io.opentracing.tag.Tags;
import java.io.IOException; import java.io.IOException;
import java.util.concurrent.atomic.AtomicBoolean; import java.util.concurrent.atomic.AtomicBoolean;
@ -12,9 +12,9 @@ import javax.servlet.http.HttpServletResponse;
public class TagSettingAsyncListener implements AsyncListener { public class TagSettingAsyncListener implements AsyncListener {
private final AtomicBoolean activated; private final AtomicBoolean activated;
private final Span span; private final AgentSpan span;
public TagSettingAsyncListener(final AtomicBoolean activated, final Span span) { public TagSettingAsyncListener(final AtomicBoolean activated, final AgentSpan span) {
this.activated = activated; this.activated = activated;
this.span = span; this.span = span;
} }
@ -31,7 +31,7 @@ public class TagSettingAsyncListener implements AsyncListener {
@Override @Override
public void onTimeout(final AsyncEvent event) throws IOException { public void onTimeout(final AsyncEvent event) throws IOException {
if (activated.compareAndSet(false, true)) { if (activated.compareAndSet(false, true)) {
Tags.ERROR.set(span, Boolean.TRUE); span.setError(true);
span.setTag("timeout", event.getAsyncContext().getTimeout()); span.setTag("timeout", event.getAsyncContext().getTimeout());
DECORATE.beforeFinish(span); DECORATE.beforeFinish(span);
span.finish(); span.finish();
@ -45,7 +45,7 @@ public class TagSettingAsyncListener implements AsyncListener {
if (((HttpServletResponse) event.getSuppliedResponse()).getStatus() if (((HttpServletResponse) event.getSuppliedResponse()).getStatus()
== HttpServletResponse.SC_OK) { == HttpServletResponse.SC_OK) {
// exception is thrown in filter chain, but status code is incorrect // exception is thrown in filter chain, but status code is incorrect
Tags.HTTP_STATUS.set(span, 500); span.setTag(Tags.HTTP_STATUS.getKey(), 500);
} }
DECORATE.onError(span, event.getThrowable()); DECORATE.onError(span, event.getThrowable());
DECORATE.beforeFinish(span); DECORATE.beforeFinish(span);