Class TraceHeaderContext (4.4.0)

public sealed class TraceHeaderContext : ITraceContext

Context from the Google Cloud Trace Header.

Inheritance

Object > TraceHeaderContext

Implements

ITraceContext

Inherited Members

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Namespace

Google.Cloud.Diagnostics.Common

Assembly

Google.Cloud.Diagnostics.Common.dll

Remarks

A trace can be forced by passing information along in the trace header ("X-Cloud-Trace-Context"). The trace id, parent span id and whether or not to trace can be set. See: https://cloud.google.com/trace/docs/faq#how_do_i_force_a_request_to_be_traced

Fields

TraceHeader

public const string TraceHeader = "X-Cloud-Trace-Context"

The trace header.

Field Value
Type	Description
`String`

Properties

ShouldTrace

public bool? ShouldTrace { get; }

Whether this request should be traced or not. May be null, which means that there's not enough information to know whether this request should be traced or not.

Property Value
Type	Description
`Nullable<Boolean>`

SpanId

public ulong? SpanId { get; }

The span id or null if none is available.

Property Value
Type	Description
`Nullable<UInt64>`

Remarks

This corresponds to the span_id field of the TraceSpan message in the API. See https://cloud.google.com/trace/docs/reference/v2/rpc/google.devtools.cloudtrace.v1#tracespan for more information.

TraceId

public string TraceId { get; }

The trace id or null if none is available.

Property Value
Type	Description
`String`

Remarks

This corresponds to the trace_id field of the Trace message in the API. See https://cloud.google.com/trace/docs/reference/v2/rpc/google.devtools.cloudtrace.v1#trace for more information.

Methods

Create(String, Nullable<UInt64>, Nullable<Boolean>)

public static TraceHeaderContext Create(string traceId, ulong? spanId, bool? shouldTrace)

Creates a TraceHeaderContext from a trace and span id.

Parameters
Name	Description
`traceId`	`String`
`spanId`	`Nullable<UInt64>`
`shouldTrace`	`Nullable<Boolean>`

Returns
Type	Description
`TraceHeaderContext`

FromHeader(String)

public static TraceHeaderContext FromHeader(string header)

Creates a TraceHeaderContext from a header.

Parameter
Name	Description
`header`	`String` The string value of the trace header. Can be null. See: https://cloud.google.com/trace/docs/faq

Returns
Type	Description
`TraceHeaderContext`

FromHeader(String, Func<Nullable<Boolean>>)

public static TraceHeaderContext FromHeader(string header, Func<bool?> traceFallbackPredicate)

Creates a TraceHeaderContext from a header.

Parameters
Name	Description
`header`	`String` The string value of the trace header. Can be null. See: https://cloud.google.com/trace/docs/faq
`traceFallbackPredicate`	`Func<Nullable<Boolean>>` Optional function to override and trace requests. Can be null.

Returns
Type	Description
`TraceHeaderContext`

ToString()

public override string ToString()

Gets the TraceHeaderContext as a string. Formatted as "[trace-id]/[span-id];o=[should-trace]" where "should-trace" is 1 to trace and 0 otherwise.

Returns
Type	Description
`String`

Overrides

Object.ToString()