Optional. A filter against labels for the request.
By default, searches use prefix matching. To specify exact match, prepend
a plus symbol (+) to the search term.
Multiple terms are ANDed. Syntax:
root:NAME_PREFIX or NAME_PREFIX: Return traces where any root
span starts with NAME_PREFIX.
+root:NAME or +NAME: Return traces where any root span's name is
exactly NAME.
span:NAME_PREFIX: Return traces where any span starts with
NAME_PREFIX.
+span:NAME: Return traces where any span's name is exactly
NAME.
latency:DURATION: Return traces whose overall latency is
greater or equal to than DURATION. Accepted units are nanoseconds
(ns), milliseconds (ms), and seconds (s). Default is ms. For
example, latency:24ms returns traces whose overall latency
is greater than or equal to 24 milliseconds.
label:LABEL_KEY: Return all traces containing the specified
label key (exact match, case-sensitive) regardless of the key:value
pair's value (including empty values).
LABEL_KEY:VALUE_PREFIX: Return all traces containing the specified
label key (exact match, case-sensitive) whose value starts with
VALUE_PREFIX. Both a key and a value must be specified.
+LABEL_KEY:VALUE: Return all traces containing a key:value pair
exactly matching the specified text. Both a key and a value must be
specified.
Optional. Maximum number of traces to return. If not specified or <= 0, the
implementation selects a reasonable value. The implementation may
return fewer traces than the requested page size.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eListTracesRequest\u003c/code\u003e class is a request message for the \u003ccode\u003eListTraces\u003c/code\u003e method in the Google Cloud Trace v1 API, used to retrieve trace data, and all its fields are required unless otherwise stated.\u003c/p\u003e\n"],["\u003cp\u003eThis class implements several interfaces, including \u003ccode\u003eIMessage\u003c/code\u003e, \u003ccode\u003eIEquatable\u003c/code\u003e, \u003ccode\u003eIDeepCloneable\u003c/code\u003e, \u003ccode\u003eIBufferMessage\u003c/code\u003e, and \u003ccode\u003eIPageRequest\u003c/code\u003e, and inherits from the \u003ccode\u003eobject\u003c/code\u003e class.\u003c/p\u003e\n"],["\u003cp\u003eKey properties of the \u003ccode\u003eListTracesRequest\u003c/code\u003e class include \u003ccode\u003eStartTime\u003c/code\u003e, \u003ccode\u003eEndTime\u003c/code\u003e, \u003ccode\u003eFilter\u003c/code\u003e, \u003ccode\u003eOrderBy\u003c/code\u003e, \u003ccode\u003ePageSize\u003c/code\u003e, \u003ccode\u003ePageToken\u003c/code\u003e, \u003ccode\u003eProjectId\u003c/code\u003e, and \u003ccode\u003eView\u003c/code\u003e, which allow for specifying time ranges, filtering criteria, sorting, pagination, and the type of data returned.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eFilter\u003c/code\u003e property allows users to filter traces based on various criteria like root span names, span names, latency, labels, HTTP method, and URL, using a specific syntax that supports prefix matching and exact matching.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version of the ListTracesRequest API is 3.4.0, and there are older versions available ranging from version 2.2.0 to the latest.\u003c/p\u003e\n"]]],[],null,["# Google Cloud Trace v1 API - Class ListTracesRequest (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.ListTracesRequest)\n- [3.3.0](/dotnet/docs/reference/Google.Cloud.Trace.V1/3.3.0/Google.Cloud.Trace.V1.ListTracesRequest)\n- [3.2.0](/dotnet/docs/reference/Google.Cloud.Trace.V1/3.2.0/Google.Cloud.Trace.V1.ListTracesRequest)\n- [3.1.0](/dotnet/docs/reference/Google.Cloud.Trace.V1/3.1.0/Google.Cloud.Trace.V1.ListTracesRequest)\n- [3.0.0](/dotnet/docs/reference/Google.Cloud.Trace.V1/3.0.0/Google.Cloud.Trace.V1.ListTracesRequest)\n- [2.3.0](/dotnet/docs/reference/Google.Cloud.Trace.V1/2.3.0/Google.Cloud.Trace.V1.ListTracesRequest)\n- [2.2.0](/dotnet/docs/reference/Google.Cloud.Trace.V1/2.2.0/Google.Cloud.Trace.V1.ListTracesRequest) \n\n public sealed class ListTracesRequest : IMessage\u003cListTracesRequest\u003e, IEquatable\u003cListTracesRequest\u003e, IDeepCloneable\u003cListTracesRequest\u003e, IBufferMessage, IMessage, IPageRequest\n\nReference documentation and code samples for the Google Cloud Trace v1 API class ListTracesRequest.\n\nThe request message for the `ListTraces` method. All fields are required\nunless specified. \n\nInheritance\n-----------\n\n[object](https://learn.microsoft.com/dotnet/api/system.object) \\\u003e ListTracesRequest \n\nImplements\n----------\n\n[IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage-1.html)[ListTracesRequest](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.ListTracesRequest), [IEquatable](https://learn.microsoft.com/dotnet/api/system.iequatable-1)[ListTracesRequest](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.ListTracesRequest), [IDeepCloneable](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IDeepCloneable-1.html)[ListTracesRequest](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1.ListTracesRequest), [IBufferMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IBufferMessage.html), [IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage.html), [IPageRequest](https://github.com/googleapis/gax-dotnet/blob/83f42b5edc4529818dbdb34d9ea9ecc3c04f7b6e/Google.Api.Gax.Grpc/PagedEnumerableCommon.cs) \n\nInherited Members\n-----------------\n\n[object.GetHashCode()](https://learn.microsoft.com/dotnet/api/system.object.gethashcode) \n[object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype) \n[object.ToString()](https://learn.microsoft.com/dotnet/api/system.object.tostring)\n\nNamespace\n---------\n\n[Google.Cloud.Trace.V1](/dotnet/docs/reference/Google.Cloud.Trace.V1/latest/Google.Cloud.Trace.V1)\n\nAssembly\n--------\n\nGoogle.Cloud.Trace.V1.dll\n\nConstructors\n------------\n\n### ListTracesRequest()\n\n public ListTracesRequest()\n\n### ListTracesRequest(ListTracesRequest)\n\n public ListTracesRequest(ListTracesRequest other)\n\nProperties\n----------\n\n### EndTime\n\n public Timestamp EndTime { get; set; }\n\nEnd of the time interval (inclusive) during which the trace data was\ncollected from the application.\n\n### Filter\n\n public string Filter { get; set; }\n\nOptional. A filter against labels for the request.\n\nBy default, searches use prefix matching. To specify exact match, prepend\na plus symbol (`+`) to the search term.\nMultiple terms are ANDed. Syntax:\n\n- `root:NAME_PREFIX` or `NAME_PREFIX`: Return traces where any root span starts with `NAME_PREFIX`.\n- `+root:NAME` or `+NAME`: Return traces where any root span's name is exactly `NAME`.\n- `span:NAME_PREFIX`: Return traces where any span starts with `NAME_PREFIX`.\n- `+span:NAME`: Return traces where any span's name is exactly `NAME`.\n- `latency:DURATION`: Return traces whose overall latency is greater or equal to than `DURATION`. Accepted units are nanoseconds (`ns`), milliseconds (`ms`), and seconds (`s`). Default is `ms`. For example, `latency:24ms` returns traces whose overall latency is greater than or equal to 24 milliseconds.\n- `label:LABEL_KEY`: Return all traces containing the specified label key (exact match, case-sensitive) regardless of the key:value pair's value (including empty values).\n- `LABEL_KEY:VALUE_PREFIX`: Return all traces containing the specified label key (exact match, case-sensitive) whose value starts with `VALUE_PREFIX`. Both a key and a value must be specified.\n- `+LABEL_KEY:VALUE`: Return all traces containing a key:value pair exactly matching the specified text. Both a key and a value must be specified.\n- `method:VALUE`: Equivalent to `/http/method:VALUE`.\n- `url:VALUE`: Equivalent to `/http/url:VALUE`.\n\n### OrderBy\n\n public string OrderBy { get; set; }\n\nOptional. Field used to sort the returned traces.\nCan be one of the following:\n\n- `trace_id`\n- `name` (`name` field of root span in the trace)\n- `duration` (difference between `end_time` and `start_time` fields of the root span)\n- `start` (`start_time` field of the root span)\n\nDescending order can be specified by appending `desc` to the sort field\n(for example, `name desc`).\n\nOnly one sort field is permitted.\n\n### PageSize\n\n public int PageSize { get; set; }\n\nOptional. Maximum number of traces to return. If not specified or \\\u003c= 0, the\nimplementation selects a reasonable value. The implementation may\nreturn fewer traces than the requested page size.\n\n### PageToken\n\n public string PageToken { get; set; }\n\nToken identifying the page of results to return. If provided, use the\nvalue of the `next_page_token` field from a previous request.\n\n### ProjectId\n\n public string ProjectId { get; set; }\n\nRequired. ID of the Cloud project where the trace data is stored.\n\n### StartTime\n\n public Timestamp StartTime { get; set; }\n\nStart of the time interval (inclusive) during which the trace data was\ncollected from the application.\n\n### View\n\n public ListTracesRequest.Types.ViewType View { get; set; }\n\nOptional. Type of data returned for traces in the list. Default is\n`MINIMAL`."]]
