All Products
Search
Document Center

Application Real-Time Monitoring Service:GetMultipleTrace

Last Updated:Aug 28, 2026

Queries the details of one or more traces.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

The region ID.

cn-hangzhou

TraceIDs

array

Yes

The trace IDs.

ac1400a115951745017447033d****

string

No

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

integer

Yes

The start time of the trace. The value is a timestamp. Unit: milliseconds.

1657692507000

EndTime

integer

Yes

The time when the trace ends. The value is a timestamp. Unit: milliseconds.

1663999380000

PageNumber

integer

No

The number of the page to return. Default value: 1.

1

PageSize

integer

No

The number of entries to return per page, the maximum value is 1000.

10

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

2983BEF7-4A0D-47A2-94A2-8E9C5E63****

MultiCallChainInfos

array<object>

The details of traces.

array<object>

TraceID

string

The trace ID.

ac1400a115951745017447033d****

Spans

array<object>

The details of the trace.

array<object>

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

integer

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

integer

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

array<object>

The tags of the trace.

object

Key

string

The key of the tag.

http.status.code

Value

string

The value of the tag.

200

LogEventList

array<object>

The log events in the trace.

array<object>

Timestamp

integer

The time when the log was generated. The value is a timestamp.

1595174501747

TagEntryList

array<object>

The tags of the trace.

object

Key

string

The key of the tag.

http.status.code

Value

string

The value of the tag.

200

Examples

Success response

JSON format

{
  "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

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.