GetMultipleTrace - Application Real-Time Monitoring Service

Queries the details of one or more traces.

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
RegionId	string	Yes	The region ID.	cn-hangzhou
TraceIDs	array	Yes	The trace IDs.
	string	Yes	The trace ID. You can specify one to nine trace IDs. You can log on to the Application Real-Time Monitoring Service (ARMS) console and obtain the trace ID on the Trace Query page.	ac1400a115951745017447033d****
StartTime	long	No	The start time of the trace. The value is a timestamp. Unit: milliseconds.	1657692507000
EndTime	long	No	The time when the trace ends. The value is a timestamp. Unit: milliseconds.	1663999380000

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The request ID.	2983BEF7-4A0D-47A2-94A2-8E9C5E63****
MultiCallChainInfos	object []	The details of traces.
TraceID	string	The trace ID.	ac1400a115951745017447033d****
Spans	object []	The details of the trace.
SpanId	string	The span ID.	1234
OperationName	string	The name of the traced span.	/demo/queryNotExistDB/11
ResultCode	string	The status code returned.	1
Timestamp	long	The timestamp.	1595174501747
RpcType	integer	The type of the remote procedure call (RPC) mode. 0: HTTP entry 25: HTTP call 1: High-speed Service Framework (HSF) call 2: HSF provision 40: on-premises API call 60: MySQL call 62: Oracle call 63: PostgreSQL call 70: Redis call 4: Taobao Distributed Data Layer (TDDL) call 5: Tair call 13: MetaQ message sending 252: MetaQ message receiving 3: notification sending 254: notification receiving 7: Apache Dubbo call 8: Apache Dubbo provision 19: SOFARPC call 18: SOFARPC provision 11: Distributed Service Framework (DSF) call 12: DSF provision -1: unknown call	0
ServiceIp	string	The IP address of the host where the application resides.	172.20.XX.XX
HaveStack	boolean	Indicates whether a method stack was provided. `true`: A method stack was provided. `false`: No method stack was provided.	true
ParentSpanId	string	The ID of the parent span.	18
Duration	long	The amount of time consumed by the trace. Unit: milliseconds.	11
RpcId	string	RPC ID	0.1
ServiceName	string	The name of the application.	arms-k8s-demo-subcomponent
TraceID	string	The trace ID.	ac1400a115951745017447033d****
TagEntryList	object []	The tags of the trace.
Key	string	The key of the tag.	http.status.code
Value	string	The value of the tag.	200
LogEventList	object []	The log events in the trace.
Timestamp	long	The time when the log was generated. The value is a timestamp.	1595174501747
TagEntryList	object []	The tags of the trace.
Key	string	The key of the tag.	http.status.code
Value	string	The value of the tag.	200

Examples

Sample success responses

JSONformat

{
  "RequestId": "2983BEF7-4A0D-47A2-94A2-8E9C5E63****",
  "MultiCallChainInfos": [
    {
      "TraceID": "ac1400a115951745017447033d****",
      "Spans": [
        {
          "SpanId": "1234",
          "OperationName": "/demo/queryNotExistDB/11",
          "ResultCode": "1",
          "Timestamp": 1595174501747,
          "RpcType": 0,
          "ServiceIp": "172.20.XX.XX",
          "HaveStack": true,
          "ParentSpanId": "18",
          "Duration": 11,
          "RpcId": "0.1",
          "ServiceName": "arms-k8s-demo-subcomponent",
          "TraceID": "ac1400a115951745017447033d****",
          "TagEntryList": [
            {
              "Key": "http.status.code",
              "Value": "200"
            }
          ],
          "LogEventList": [
            {
              "Timestamp": 1595174501747,
              "TagEntryList": [
                {
                  "Key": "http.status.code",
                  "Value": "200"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Error codes

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

Change history

Change time

Summary of changes

Operation

2023-12-21

The internal configuration of the API is changed, but the call is not affected

see changesets

Change item	Change content
	The internal configuration of the API is changed, but the call is not affected.