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.
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."],[],[],null,["# Package types (1.16.2)\n\nVersion latestkeyboard_arrow_down\n\n- [1.16.2 (latest)](/python/docs/reference/cloudtrace/latest/google.cloud.trace_v1.types)\n- [1.16.0](/python/docs/reference/cloudtrace/1.16.0/google.cloud.trace_v1.types)\n- [1.15.0](/python/docs/reference/cloudtrace/1.15.0/google.cloud.trace_v1.types)\n- [1.14.1](/python/docs/reference/cloudtrace/1.14.1/google.cloud.trace_v1.types)\n- [1.13.5](/python/docs/reference/cloudtrace/1.13.5/google.cloud.trace_v1.types)\n- [1.12.0](/python/docs/reference/cloudtrace/1.12.0/google.cloud.trace_v1.types)\n- [1.11.3](/python/docs/reference/cloudtrace/1.11.3/google.cloud.trace_v1.types)\n- [1.10.0](/python/docs/reference/cloudtrace/1.10.0/google.cloud.trace_v1.types)\n- [1.9.1](/python/docs/reference/cloudtrace/1.9.1/google.cloud.trace_v1.types)\n- [1.8.0](/python/docs/reference/cloudtrace/1.8.0/google.cloud.trace_v1.types)\n- [1.7.3](/python/docs/reference/cloudtrace/1.7.3/google.cloud.trace_v1.types)\n- [1.6.2](/python/docs/reference/cloudtrace/1.6.2/google.cloud.trace_v1.types)\n- [1.5.1](/python/docs/reference/cloudtrace/1.5.1/google.cloud.trace_v1.types)\n- [1.4.0](/python/docs/reference/cloudtrace/1.4.0/google.cloud.trace_v1.types)\n- [1.3.4](/python/docs/reference/cloudtrace/1.3.4/google.cloud.trace_v1.types)\n- [1.2.0](/python/docs/reference/cloudtrace/1.2.0/google.cloud.trace_v1.types)\n- [1.1.0](/python/docs/reference/cloudtrace/1.1.0/google.cloud.trace_v1.types)\n- [1.0.0](/python/docs/reference/cloudtrace/1.0.0/google.cloud.trace_v1.types)\n- [0.24.2](/python/docs/reference/cloudtrace/0.24.2/google.cloud.trace_v1.types)\n- [0.23.0](/python/docs/reference/cloudtrace/0.23.0/google.cloud.trace_v1.types)\n- [0.22.1](/python/docs/reference/cloudtrace/0.22.1/google.cloud.trace_v1.types) \nAPI documentation for `trace_v1.types` package. \n\nClasses\n-------\n\n### [GetTraceRequest](/python/docs/reference/cloudtrace/latest/google.cloud.trace_v1.types.GetTraceRequest)\n\nThe request message for the `GetTrace` method.\n\n### [ListTracesRequest](/python/docs/reference/cloudtrace/latest/google.cloud.trace_v1.types.ListTracesRequest)\n\nThe request message for the `ListTraces` method. All fields are\nrequired unless specified.\n\n### [ListTracesResponse](/python/docs/reference/cloudtrace/latest/google.cloud.trace_v1.types.ListTracesResponse)\n\nThe response message for the `ListTraces` method.\n\n### [PatchTracesRequest](/python/docs/reference/cloudtrace/latest/google.cloud.trace_v1.types.PatchTracesRequest)\n\nThe request message for the `PatchTraces` method.\n\n### [Trace](/python/docs/reference/cloudtrace/latest/google.cloud.trace_v1.types.Trace)\n\nA trace describes how long it takes for an application to\nperform an operation. It consists of a set of spans, each of\nwhich represent a single timed event within the operation.\n\n### [TraceSpan](/python/docs/reference/cloudtrace/latest/google.cloud.trace_v1.types.TraceSpan)\n\nA span represents a single timed event within a trace. Spans\ncan be nested and form a trace tree. Often, a trace contains a\nroot span that describes the end-to-end latency of an operation\nand, optionally, one or more subspans for its suboperations.\nSpans do not need to be contiguous. There may be gaps between\nspans in a trace.\n\n### [Traces](/python/docs/reference/cloudtrace/latest/google.cloud.trace_v1.types.Traces)\n\nList of new or updated traces."]]