
public abstract class PropagationTags

Encapsulates logic related to the Service Propagation including:

  - parsing and validation the x-datadog-tags header value
  - dropping non _dd.p.* tags
  - error handling and propagation
  - concurrent updates to the sampling priority
  - producing the x-datadog-tags header value
  - producing meta tags to be sent to the agent

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`public enum`	`PropagationTags.HeaderType`
`public interface`	`PropagationTags.Factory`

Method Summary

Modifier and Type	Method	Description
`static PropagationTags.Factory`	`factory(Config config)`
`static PropagationTags.Factory`	`factory(int datadogTagsLimit)`
`static PropagationTags.Factory`	`factory()`
`abstract void`	`updateTraceSamplingPriority(int samplingPriority, int samplingMechanism)`	Updates the trace-level sampling priority decision if it hasn't already been made and _dd.p.dmtag doesn't exist.
`abstract int`	`getSamplingPriority()`
`abstract void`	`updateTraceOrigin(CharSequence origin)`
`abstract CharSequence`	`getOrigin()`
`abstract long`	`getTraceIdHighOrderBits()`
`abstract void`	`updateTraceIdHighOrderBits(long highOrderBits)`
`abstract String`	`getW3CTracestate()`	Gets the original W3Ctracestate header value.
`abstract void`	`updateW3CTracestate(String tracestate)`	Stores the original W3Ctracestate header value.
`abstract String`	`headerValue(PropagationTags.HeaderType headerType)`	Constructs a header value that includes valid propagated _dd.p.* tags and possibly a newsampling decision tag _dd.p.dm based on the current state.
`abstract void`	`fillTagMap(Map<String, String> tagMap)`	Fills a provided tagMap with valid propagated _dd.p.* tags and possibly a new sampling decisiontags _dd.p.dm (root span only) based on the current state, or sets only an error tag if theheader value exceeds a configured limit.
`HashMap<String, String>`	`createTagMap()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - factory
```
 static PropagationTags.Factory factory(Config config)
```
  - factory
```
 static PropagationTags.Factory factory(int datadogTagsLimit)
```
  - factory
```
 static PropagationTags.Factory factory()
```
  - updateTraceSamplingPriority
```
 abstract void updateTraceSamplingPriority(int samplingPriority, int samplingMechanism)
```
    Updates the trace-level sampling priority decision if it hasn't already been made and _dd.p.dmtag doesn't exist. Called on the root span context.
  - getSamplingPriority
```
 abstract int getSamplingPriority()
```
  - updateTraceOrigin
```
 abstract void updateTraceOrigin(CharSequence origin)
```
  - getOrigin
```
 abstract CharSequence getOrigin()
```
  - getTraceIdHighOrderBits
```
 abstract long getTraceIdHighOrderBits()
```
  - updateTraceIdHighOrderBits
```
 abstract void updateTraceIdHighOrderBits(long highOrderBits)
```
  - getW3CTracestate
```
 abstract String getW3CTracestate()
```
    Gets the original W3Ctracestate header value.
  - updateW3CTracestate
```
 abstract void updateW3CTracestate(String tracestate)
```
    Stores the original W3Ctracestate header value.
    
    Parameters:
    
    tracestate - The original W3C tracestate header value.
  - headerValue
```
 abstract String headerValue(PropagationTags.HeaderType headerType)
```
    Constructs a header value that includes valid propagated _dd.p.* tags and possibly a newsampling decision tag _dd.p.dm based on the current state. Returns null if the value lengthexceeds a configured limit or empty.
  - fillTagMap
```
 abstract void fillTagMap(Map<String, String> tagMap)
```
    Fills a provided tagMap with valid propagated _dd.p.* tags and possibly a new sampling decisiontags _dd.p.dm (root span only) based on the current state, or sets only an error tag if theheader value exceeds a configured limit.
  - createTagMap
```
 HashMap<String, String> createTagMap()
```

Class PropagationTags

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

factory

factory

factory

updateTraceSamplingPriority

getSamplingPriority

updateTraceOrigin

getOrigin

getTraceIdHighOrderBits

updateTraceIdHighOrderBits

getW3CTracestate

updateW3CTracestate

headerValue

fillTagMap

createTagMap