Class TraceDecisionPredicate (4.4.0)

public sealed class TraceDecisionPredicate

Used to determine if an HttpRequest should be traced. This will not override a decision by the trace header.

Inheritance

Object > TraceDecisionPredicate

Inherited Members

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Object.ToString()

Namespace

Google.Cloud.Diagnostics.AspNetCore

Assembly

Google.Cloud.Diagnostics.AspNetCore.dll

Properties

Default

public static TraceDecisionPredicate Default { get; }

A default TraceDecisionPredicate that only disables tracing health checks.

Property Value
Type	Description
`TraceDecisionPredicate`

DoNothing

public static TraceDecisionPredicate DoNothing { get; }

A TraceDecisionPredicate that does not have any effect on trace decisions and does not disable tracing health checks.

Property Value
Type	Description
`TraceDecisionPredicate`

Methods

Create(Func<HttpRequest, Nullable<Boolean>>, Boolean)

public static TraceDecisionPredicate Create(Func<HttpRequest, bool?> traceDecisionPredicate, bool ignoreHealthChecks = true)

Creates a TraceDecisionPredicate.

Parameters
Name	Description
`traceDecisionPredicate`	`Func<HttpRequest, Nullable<Boolean>>` Used to determine if a request should be traced. Takes an HttpRequest. It should return true if the request should be traced, false if the request should not be traced and null if the decision should be left to other sampling mechanisms. Must not be null.
`ignoreHealthChecks`	`Boolean` Optional. True if Google App Engine health check requests should not be traced. Defaults to true.

Returns
Type	Description
`TraceDecisionPredicate`

Remarks

Ignoring of health checks (ignoreHealthChecks) takes precedence over the predicate (traceDecisionPredicate). If ignoreHealthChecks is true and the request is a health check traceDecisionPredicate will not be called.

ShouldTrace(HttpRequest)

public bool? ShouldTrace(HttpRequest request)

Used to determine if a request should be traced. This will not override a trace header decision.

Parameter
Name	Description
`request`	`HttpRequest` The HTTP request to check.

Returns
Type	Description
`Nullable<Boolean>`	True if the request should be traced, false if the request should not be traced and null if the decision should be left to other sampling mechanisms.