A trace describes how long it takes for an application to perform an
operation. It consists of a set of spans, each of which represent a single
timed event within the operation.
This file describes an API for collecting and viewing traces and spans
within a trace. A Trace is a collection of spans corresponding to a single
operation or set of operations for an application. A span is an individual
timed event which forms a node of the trace tree. Spans for a single trace
may span multiple services.
A span represents a single timed event within a trace. Spans can be nested
and form a trace tree. Often, a trace contains a root span that describes the
end-to-end latency of an operation and, optionally, one or more subspans for
its suboperations. Spans do not need to be contiguous. There may be gaps
between spans in a trace.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThe latest version available for Google.Cloud.Trace.V1 is 3.4.0, with previous versions ranging from 3.3.0 down to 2.2.0 also documented.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eTraceService\u003c/code\u003e API is designed for collecting and viewing traces and spans, where a trace is a set of spans related to an application operation.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eTraceServiceClient\u003c/code\u003e is a client wrapper with a builder, allowing for configuration of credentials, endpoints, and more, while \u003ccode\u003eTraceService\u003c/code\u003e has a base class for server-side implementation.\u003c/p\u003e\n"],["\u003cp\u003eSeveral request and response classes are defined, such as \u003ccode\u003eGetTraceRequest\u003c/code\u003e, \u003ccode\u003eListTracesRequest\u003c/code\u003e, \u003ccode\u003eListTracesResponse\u003c/code\u003e, and \u003ccode\u003ePatchTracesRequest\u003c/code\u003e, for retrieving and managing trace data.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eTraceSpan\u003c/code\u003e represents a single timed event within a trace, which includes information on the span kind and can be nested within a trace.\u003c/p\u003e\n"]]],[],null,["# Google Cloud Trace v1 API - Namespace Google.Cloud.Trace.V1 (3.4.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.4.0 (latest)](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1)\n- [3.3.0](/dotnet/docs/reference/Google.Cloud.Trace.V1/3.3.0/Google.Cloud.Trace.V1)\n- [3.2.0](/dotnet/docs/reference/Google.Cloud.Trace.V1/3.2.0/Google.Cloud.Trace.V1)\n- [3.1.0](/dotnet/docs/reference/Google.Cloud.Trace.V1/3.1.0/Google.Cloud.Trace.V1)\n- [3.0.0](/dotnet/docs/reference/Google.Cloud.Trace.V1/3.0.0/Google.Cloud.Trace.V1)\n- [2.3.0](/dotnet/docs/reference/Google.Cloud.Trace.V1/2.3.0/Google.Cloud.Trace.V1)\n- [2.2.0](/dotnet/docs/reference/Google.Cloud.Trace.V1/2.2.0/Google.Cloud.Trace.V1) \n\nClasses\n-------\n\n### [GetTraceRequest](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.GetTraceRequest)\n\nThe request message for the `GetTrace` method.\n\n### [ListTracesRequest](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.ListTracesRequest)\n\nThe request message for the `ListTraces` method. All fields are required\nunless specified.\n\n### [ListTracesRequest.Types](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.ListTracesRequest.Types)\n\nContainer for nested types declared in the ListTracesRequest message type.\n\n### [ListTracesResponse](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.ListTracesResponse)\n\nThe response message for the `ListTraces` method.\n\n### [PatchTracesRequest](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.PatchTracesRequest)\n\nThe request message for the `PatchTraces` method.\n\n### [Trace](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.Trace)\n\nA trace describes how long it takes for an application to perform an\noperation. It consists of a set of spans, each of which represent a single\ntimed event within the operation.\n\n### [TraceService](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.TraceService)\n\nThis file describes an API for collecting and viewing traces and spans\nwithin a trace. A Trace is a collection of spans corresponding to a single\noperation or set of operations for an application. A span is an individual\ntimed event which forms a node of the trace tree. Spans for a single trace\nmay span multiple services.\n\n### [TraceService.TraceServiceBase](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.TraceService.TraceServiceBase)\n\nBase class for server-side implementations of TraceService\n\n### [TraceService.TraceServiceClient](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.TraceService.TraceServiceClient)\n\nClient for TraceService\n\n### [TraceServiceClient](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.TraceServiceClient)\n\nTraceService client wrapper, for convenient use.\n\n### [TraceServiceClientBuilder](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.TraceServiceClientBuilder)\n\nBuilder class for [TraceServiceClient](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.TraceServiceClient) to provide simple configuration of credentials, endpoint etc.\n\n### [TraceServiceClientImpl](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.TraceServiceClientImpl)\n\nTraceService client wrapper implementation, for convenient use.\n\n### [TraceServiceSettings](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.TraceServiceSettings)\n\nSettings for [TraceServiceClient](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.TraceServiceClient) instances.\n\n### [TraceSpan](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.TraceSpan)\n\nA span represents a single timed event within a trace. Spans can be nested\nand form a trace tree. Often, a trace contains a root span that describes the\nend-to-end latency of an operation and, optionally, one or more subspans for\nits suboperations. Spans do not need to be contiguous. There may be gaps\nbetween spans in a trace.\n\n### [TraceSpan.Types](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.TraceSpan.Types)\n\nContainer for nested types declared in the TraceSpan message type.\n\n### [Traces](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.Traces)\n\nList of new or updated traces.\n\nEnums\n-----\n\n### [ListTracesRequest.Types.ViewType](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.ListTracesRequest.Types.ViewType)\n\nType of data returned for traces in the list.\n\n### [TraceSpan.Types.SpanKind](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.TraceSpan.Types.SpanKind)\n\nType of span. Can be used to specify additional relationships between spans\nin addition to a parent/child relationship."]]