Alibaba Cloud Document Center: Find the Documentation for Your Needs

Note A maximum of 100 data entries can be returned each time this operation is called. If you want to query all existing traces, we recommend that you call the SearchTracesByPage operation. For more information, see SearchTracesByPage.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	SearchTraces	The operation that you want to perform. The operation that you want to perform. Set the value to SearchTraces.
StartTime	Long	Yes	1595174400000	The beginning of the time range to query. Unit: milliseconds.
EndTime	Long	Yes	1595210400000	The end of the time range to query. Unit: milliseconds.
RegionId	String	Yes	cn-hangzhou	The ID of the region.
ServiceName	String	No	arms-k8s-demo-subcomponent	The name of the application.
OperationName	String	No	/demo/queryNotExistDB/11	The name of the traced span.
MinDuration	Long	No	2	The minimum amount of time consumed by traces. Unit: milliseconds.
Reverse	Boolean	No	false	Specifies whether to sort the query results in chronological order or reverse chronological order. Default value: `false`. `true`: sorts the query results in reverse chronological order. `false`: sorts the query results in chronological order.
ServiceIp	String	No	172.20.XX.XX	The IP address of the host where the application resides.
Pid	String	No	b590lhguqs@9781be0f44dXXXX	The ID of the application.
Tag.N.Key	String	No	http.status_code	The key of the tag.
Tag.N.Value	String	No	200	The value of the tag.
ExclusionFilters.N.Key	String	No	http.status_code	The key that is used to filter the query results.
ExclusionFilters.N.Value	String	No	404	The value of the key that is used to filter the query results.

Response parameters


Parameter	Type	Example	Description
RequestId	String	4C518054-852F-4023-ABC1-4AF95FF7****	The ID of the request.
TraceInfos	Array of TraceInfo		The details of the returned traces.
OperationName	String	get***	The name of the traced span.
ServiceIp	String	172.20..	The IP address of the host where the application resides.
Duration	Long	6	The amount of time consumed by the trace. Unit: milliseconds.
Timestamp	Long	1595174436993	The timestamp.
ServiceName	String	arms-k8s-demo-subcomponent	The name of the application.
TraceID	String	ac1400a115951744369937024d****	The ID of the trace.

Examples

Sample requests

http(s)://[Endpoint]/?Action=SearchTraces
&StartTime=1595174400000
&EndTime=1595210400000
&RegionId=cn-hangzhou
&ServiceName=arms-k8s-demo-subcomponent
&OperationName=/demo/queryNotExistDB/11
&MinDuration=2
&Reverse=false
&ServiceIp=172.20.XX.XX
&Pid=b590lhguqs@9781be0f44dXXXX
&Tag=[{"Key":"http.status_code","Value":"200"}]
&ExclusionFilters=[{"Key":"http.status_code","Value":"404"}]
&Common request parameters

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<SearchTracesResponse>
    <RequestId>4C518054-852F-4023-ABC1-4AF95FF7****</RequestId>
    <TraceInfos>
        <OperationName>get***</OperationName>
        <ServiceIp>172.20.**.**</ServiceIp>
        <Duration>6</Duration>
        <Timestamp>1595174436993</Timestamp>
        <ServiceName>arms-k8s-demo-subcomponent</ServiceName>
        <TraceID>ac1400a115951744369937024d****</TraceID>
    </TraceInfos>
</SearchTracesResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "4C518054-852F-4023-ABC1-4AF95FF7****",
  "TraceInfos" : [ {
    "OperationName" : "get***",
    "ServiceIp" : "172.20.**.**",
    "Duration" : 6,
    "Timestamp" : 1595174436993,
    "ServiceName" : "arms-k8s-demo-subcomponent",
    "TraceID" : "ac1400a115951744369937024d****"
  } ]
}