GetTrace - Application Real-Time Monitoring Service - Alibaba Cloud Documentation Center

Queries the details of a trace.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
TraceID	string	Yes	The unique ID of the trace.	1c6881aab84191a4
AppType	string	No	The type of the application. You can set the value to XTRACE or leave this parameter unspecified.	XTRACE
RegionId	string	Yes	The ID of the region.	cn-beijing

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The ID of the request.	1E2B6A4C-6B83-4062-8B6F-AEEC1F******
Spans	array<object>	The details of the trace.
	object	The details of the trace.
SpanId	string	Span ID.	fec891bb8f8XXX
HaveStack	boolean	Indicates whether the span has child spans. Valid values: true: The span has child spans. false: The span has no child spans.	false
ServiceIp	string	The IP address of the server where the span resides.	192.168.XXX.XXX
OperationName	string	The name of the span.	/api
ParentSpanId	string	The ID of the parent span.	fec891bb8f8XXX
ResultCode	string	The status code.	200
Duration	long	The time used to call the trace. Unit: milliseconds.	1000
RpcId	string	The parent-child and sibling relationship between spans. For example, span 1.1 is the parent of span 1.1.1, and span 1.1.2 and span 1.1.1 are siblings.	1.1
Timestamp	long	The timestamp when the span was generated. Unit: microseconds.	1689845513298000
ServiceName	string	The name of the application.	server1
TraceID	string	The unique ID of the trace.	1c6881aab84191a4****
TagEntryList	array<object>	The tags in the span.
	object	The tags in the span.
Key	string	The tag key in the span.	logLevel
Value	string	The tag value in the span.	Warning
LogEventList	array<object>	The log events in the trace.
	object	The log events in the trace.
Timestamp	long	The timestamp when the log event was generated.	1583683202047000
TagEntryList	array<object>	The tags in the log event.
	object	The tags in the log event.
Key	string	The tag key in the log event.	logLevel
Value	string	The tag value in the log event.	Warning

Examples

Sample success responses

JSONformat

{
  "RequestId": "1E2B6A4C-6B83-4062-8B6F-AEEC1F******",
  "Spans": {
    "Span": [
      {
        "SpanId": "fec891bb8f8XXX",
        "HaveStack": false,
        "ServiceIp": "192.168.XXX.XXX",
        "OperationName": "/api",
        "ParentSpanId": "fec891bb8f8XXX",
        "ResultCode": "200",
        "Duration": 1000,
        "RpcId": "1.1",
        "Timestamp": 1689845513298000,
        "ServiceName": "server1",
        "TraceID": "1c6881aab84191a4****",
        "TagEntryList": {
          "TagEntry": [
            {
              "Key": "logLevel",
              "Value": "Warning"
            }
          ]
        },
        "LogEventList": {
          "LogEvent": [
            {
              "Timestamp": 1583683202047000,
              "TagEntryList": {
                "TagEntry": [
                  {
                    "Key": "logLevel",
                    "Value": "Warning"
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation

No change history