Skip to content

Latest commit

 

History

History
 
 

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 

README.md

Span stacktrace capture

This module provides a SpanProcessor that captures the code.stacktrace.

Capturing the stack trace is an expensive operation and does not provide any value on short-lived spans. As a consequence it should only be used when the span duration is known, thus on span end.

However, the current SDK API does not allow to modify span attributes on span end, so we have to introduce other components to make it work as expected.

Usage

This extension does not support autoconfiguration because it needs to wrap the SimpleSpanExporter or BatchingSpanProcessor that invokes the SpanExporter.

As a consequence you have to use Manual SDK setup section below to configure it.

Manual SDK setup

Here is an example registration of StackTraceSpanProcessor to capture stack trace for all the spans that have a duration >= 1000 ns. The spans that have an ignorespan string attribute will be ignored.

InMemorySpanExporter spansExporter = InMemorySpanExporter.create();
SpanProcessor exportProcessor = SimpleSpanProcessor.create(spansExporter);

Predicate<ReadableSpan> filterPredicate = readableSpan -> {
  if(readableSpan.getAttribute(AttributeKey.stringKey("ignorespan")) != null){
    return false;
  }
  return true;
};
SdkTracerProvider tracerProvider = SdkTracerProvider.builder()
    .addSpanProcessor(new StackTraceSpanProcessor(exportProcessor, 1000, filterPredicate))
    .build();

OpenTelemetrySdk sdk = OpenTelemetrySdk.builder().setTracerProvider(tracerProvider).build();

Component owners

Learn more about component owners in component_owners.yml.