HttpSampler (Brave Instrumentation: Http Adapters 5.16.0 API)

java.lang.Object
- brave.http.HttpSampler

All Implemented Interfaces:

SamplerFunction<HttpRequest>

Direct Known Subclasses:

HttpRuleSampler
```
@Deprecated
public abstract class HttpSampler
extends Object
implements SamplerFunction<HttpRequest>
```
Deprecated.
Since 5.8, use SamplerFunction<HttpRequest>.
Decides whether to start a new trace based on http request properties such as path.
Ex. Here's a sampler that only traces api requests
```
{@code
 httpTracingBuilder.serverSampler(new HttpSampler() {
```
See Also:

HttpRuleSampler, SamplerFunction

Field Summary

Fields
Modifier and Type	Field	Description
`static HttpSampler`	`NEVER_SAMPLE`	Deprecated. Returns false to never start new traces for http requests.
`static HttpSampler`	`TRACE_ID`	Deprecated. Ignores the request and uses the `trace ID instead`.

Constructor Summary

Constructors
Constructor Description

HttpSampler()
Deprecated.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`abstract <Req> Boolean`	`trySample(HttpAdapter<Req,?> adapter, Req request)`	Deprecated. Returns an overriding sampling decision for a new trace.
`Boolean`	`trySample(HttpRequest request)`	Deprecated.

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

- Field Detail
  - TRACE_ID
```
public static final HttpSampler TRACE_ID
```
    Deprecated.
    
    Ignores the request and uses the trace ID instead.
  - NEVER_SAMPLE
```
public static final HttpSampler NEVER_SAMPLE
```
    Deprecated.
    
    Returns false to never start new traces for http requests. For example, you may wish to only capture traces if they originated from an inbound server request. Such a policy would filter out client requests made during bootstrap.
- Constructor Detail
  - HttpSampler
```
public HttpSampler()
```
    Deprecated.
- Method Detail
  - trySample
```
@Nullable
public Boolean trySample(HttpRequest request)
```
    Deprecated.
    
    Specified by:
    
    trySample in interface SamplerFunction<HttpRequest>
  - trySample
```
@Nullable
public abstract <Req> Boolean trySample(HttpAdapter<Req,?> adapter,
                                        Req request)
```
    Deprecated.
    
    Returns an overriding sampling decision for a new trace. Return null ignore the request and use the trace ID sampler.