How to use

com.nike.wingtips.Span$Builder

constructor

/**
 * @return A new span builder that has all its fields copied from the given {@link Span}. If you call {@link Builder#build()} immediately on the returned builder you'd
 *          end up with an exact duplicate of the given span.
 */
public static Builder newBuilder(Span copy) {
  Builder builder = new Builder(copy.spanName, copy.spanPurpose);
  builder.traceId = copy.traceId;
  builder.spanId = copy.spanId;
  builder.parentSpanId = copy.parentSpanId;
  builder.sampleable = copy.sampleable;
  builder.userId = copy.userId;
  builder.spanStartTimeEpochMicros = copy.spanStartTimeEpochMicros;
  builder.spanStartTimeNanos = copy.spanStartTimeNanos;
  builder.durationNanos = copy.durationNanos;
  builder.tags = new LinkedHashMap<>(copy.tags);
  builder.annotations = new ArrayList<>(copy.annotations);
  return builder;
}

/**
 * @param spanName The {@link Span#getSpanName()} to initialize the builder with.
 * @param spanPurpose The {@link SpanPurpose} to initialize the builder with. See the javadocs for {@link SpanPurpose} for full details on what each enum
 *                    option means. If you pass in null for this then {@link SpanPurpose#UNKNOWN} will be used.
 * @return A new span builder with nothing populated beyond the given span name. Based on the behavior of {@link Builder#build()}, if you were to build it
 *          immediately you'd end up with an uncompleted root span for a new trace (same behavior as {@link #generateRootSpanForNewTrace(String, SpanPurpose)}.
 *          You are free to adjust any values before building however, so you can setup the builder to represent any span you want.
 */
public static Builder newBuilder(String spanName, SpanPurpose spanPurpose) {
  return new Builder(spanName, spanPurpose);
}