public sealed class ListTracesRequest : IMessage<ListTracesRequest>, IEquatable<ListTracesRequest>, IDeepCloneable<ListTracesRequest>, IBufferMessage, IMessage, IPageRequest
Reference documentation and code samples for the Google Cloud Trace v1 API class ListTracesRequest.
The request message for the ListTraces
method. All fields are required
unless specified.
Implements
IMessageListTracesRequest, IEquatableListTracesRequest, IDeepCloneableListTracesRequest, IBufferMessage, IMessage, IPageRequestNamespace
Google.Cloud.Trace.V1Assembly
Google.Cloud.Trace.V1.dll
Constructors
ListTracesRequest()
public ListTracesRequest()
ListTracesRequest(ListTracesRequest)
public ListTracesRequest(ListTracesRequest other)
Parameter | |
---|---|
Name | Description |
other |
ListTracesRequest |
Properties
EndTime
public Timestamp EndTime { get; set; }
End of the time interval (inclusive) during which the trace data was collected from the application.
Property Value | |
---|---|
Type | Description |
Timestamp |
Filter
public string Filter { get; set; }
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
orNAME_PREFIX
: Return traces where any root span starts withNAME_PREFIX
.+root:NAME
or+NAME
: Return traces where any root span's name is exactlyNAME
.span:NAME_PREFIX
: Return traces where any span starts withNAME_PREFIX
.+span:NAME
: Return traces where any span's name is exactlyNAME
.latency:DURATION
: Return traces whose overall latency is greater or equal to thanDURATION
. Accepted units are nanoseconds (ns
), milliseconds (ms
), and seconds (s
). Default isms
. 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 withVALUE_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.method:VALUE
: Equivalent to/http/method:VALUE
.url:VALUE
: Equivalent to/http/url:VALUE
.
Property Value | |
---|---|
Type | Description |
string |
OrderBy
public string OrderBy { get; set; }
Optional. Field used to sort the returned traces. Can be one of the following:
trace_id
name
(name
field of root span in the trace)duration
(difference betweenend_time
andstart_time
fields of the root span)start
(start_time
field of the root span)
Descending order can be specified by appending desc
to the sort field
(for example, name desc
).
Only one sort field is permitted.
Property Value | |
---|---|
Type | Description |
string |
PageSize
public int PageSize { get; set; }
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.
Property Value | |
---|---|
Type | Description |
int |
PageToken
public string PageToken { get; set; }
Token identifying the page of results to return. If provided, use the
value of the next_page_token
field from a previous request.
Property Value | |
---|---|
Type | Description |
string |
ProjectId
public string ProjectId { get; set; }
Required. ID of the Cloud project where the trace data is stored.
Property Value | |
---|---|
Type | Description |
string |
StartTime
public Timestamp StartTime { get; set; }
Start of the time interval (inclusive) during which the trace data was collected from the application.
Property Value | |
---|---|
Type | Description |
Timestamp |
View
public ListTracesRequest.Types.ViewType View { get; set; }
Optional. Type of data returned for traces in the list. Default is
MINIMAL
.
Property Value | |
---|---|
Type | Description |
ListTracesRequestTypesViewType |