All Products
Search
Document Center

Application Real-Time Monitoring Service:GetTrace

Last Updated:Jun 12, 2026

Mempercepat pengambilan detail jejak.

Deskripsi operasi

Catatan

Java SDK harus diperbarui ke v2.7.24.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

TraceID

string

Yes

ID jejak. Anda dapat memperoleh ID jejak di halaman Trace Query atau halaman API Snapshot pada Konsol ARMS.

ac14001a15954493811405707d****

RegionId

string

Yes

ID wilayah.

cn-hangzhou

StartTime

integer

No

Timestamp Waktu mulai. Unit: milidetik.

Catatan

Jika panjang TraceID adalah 30, parameter ini bersifat opsional. Jika panjang TraceID bukan 30, parameter ini wajib diisi.

1623827602000

EndTime

integer

No

Timestamp Waktu selesai. Unit: milidetik.

Catatan

Jika panjang TraceID adalah 30, parameter ini bersifat opsional. Jika panjang TraceID bukan 30, parameter ini wajib diisi.

1623827603000

PageNumber

integer

No

Nomor halaman kueri.

1

PageSize

integer

No

Jumlah entri per halaman untuk kueri. Nilai maksimum: 100.

10

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

6A9AEA84-7186-4D8D-B498-4585C6A2****

Spans

array<object>

Detail jejak.

array<object>

SpanId

string

ID rentang.

1234

OperationName

string

Nama API yang diinstrumentasi.

/api/demo

ResultCode

string

Kode hasil.

222

Timestamp

integer

Timestamp saat rentang dibuat.

1590388651

RpcType

integer

Tipe RPC:

  • -2 front

  • -3 app

  • 0 http

  • 25 http_client

  • 1 hsf_client

  • 2 hsf

  • 40 local

  • 41 async

  • 52 DB2

  • 53 Informix

  • 54 SequoiaDB

  • 55 Gbase

  • 56 GaussDB

  • 57 KingBase

  • 58 infuxdb

  • 59 clickhouse

  • 60 mysql

  • 61 mysql

  • 62 oracle

  • 63 postgresql

  • 64 mongodb

  • 65 ppas

  • 66 sqlserver

  • 67 mariadb

  • 68 dmdb

  • 69 oceanbase

  • 70 redis

  • 71 memcached

  • 72 elasticsearch

  • 73 kudu

  • 4 tddl

  • 5 tair

  • 13 mq_client

  • 252 mq

  • 23 kafka_client

  • 256 kafka

  • 3 notify_client

  • 254 notify

  • 7 dubbo_client

  • 8 dubbo

  • 11 dsf_client

  • 12 dsf

  • 9 grpc

  • 10 grpc_client

  • 16 thrift

  • 17 thrift_client

  • 18 sofa

  • 19 sofa_client

  • -1 unknown

  • 98 user_method

  • 100 root

  • 101 client

  • 102 server

  • 103 producer

  • 104 consumer

  • 105 db

  • 106 xtrace_other

  • 1301 schedulerx

  • 1302 XXL_Job

  • 1303 Spring_Scheduled

  • 1304 Quartz

  • 1305 ElasticJob

  • 1308 Jdk_Timer

1

ServiceIp

string

Alamat IP Host tempat aplikasi berjalan.

172.20.XX.XX

HaveStack

boolean

Apakah informasi stack metode tersedia. Nilai valid:

  • true: Informasi stack metode tersedia.

  • false: Informasi stack metode tidak tersedia.

false

ParentSpanId

string

ID rentang induk.

18

Duration

integer

Durasi jejak. Unit: milidetik.

1000

RpcId

string

ID RPC.

0

ServiceName

string

Nama aplikasi.

arms-demo

TraceID

string

ID jejak.

ac14001a15954493811405707d****

TagEntryList

array<object>

Daftar tag jejak.

object

Key

string

The key of the tag.

http.status.code

Value

string

The value of the tag.

200

LogEventList

array<object>

Event log dalam jejak.

array<object>

Timestamp

integer

The timestamp when the log event was generated.

1590388651

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

Children

array<object>

Daftar rentang anak dari rentang saat ini.

object

Detail rentang anak.

[ { "ParentSpanId":"c33603355032xxxx", "ServiceIp":"10.208.xxx.xxx", "OperationName":"/product/toy/8ac7ddeb-1c3c-4911-850c-665a5a0xxxx", "RpcType":0, "Duration":2, "TagEntryList":[ { "Value":"10.208.0.xxx", "Key":"source.ip" } ], "Timestamp":1652669026201, "HaveStack":true, "LogEventList":[ ], "ServiceName":"xxxxxx", "RpcId":"0.2", "TraceID":"ea1ad000a1165266902619685xxxxx", "Children":[ ], "ResultCode":"0", "SpanId":"7069ab30d7cbxxxx" } ]

Contoh

Respons sukses

JSONformat

{
  "RequestId": "6A9AEA84-7186-4D8D-B498-4585C6A2****",
  "Spans": [
    {
      "SpanId": "1234",
      "OperationName": "/api/demo",
      "ResultCode": "222",
      "Timestamp": 1590388651,
      "RpcType": 1,
      "ServiceIp": "172.20.XX.XX",
      "HaveStack": false,
      "ParentSpanId": "18",
      "Duration": 1000,
      "RpcId": "0",
      "ServiceName": "arms-demo",
      "TraceID": "ac14001a15954493811405707d****",
      "TagEntryList": [
        {
          "Key": "http.status.code",
          "Value": "200"
        }
      ],
      "LogEventList": [
        {
          "Timestamp": 1590388651,
          "TagEntryList": [
            {
              "Key": "http.status.code",
              "Value": "200"
            }
          ]
        }
      ],
      "Children": [
        [
          {
            "ParentSpanId": "c33603355032xxxx",
            "ServiceIp": "10.208.xxx.xxx",
            "OperationName": "/product/toy/8ac7ddeb-1c3c-4911-850c-665a5a0xxxx",
            "RpcType": 0,
            "Duration": 2,
            "TagEntryList": [
              {
                "Value": "10.208.0.xxx",
                "Key": "source.ip"
              }
            ],
            "Timestamp": 1652669026201,
            "HaveStack": true,
            "LogEventList": [],
            "ServiceName": "xxxxxx",
            "RpcId": "0.2",
            "TraceID": "ea1ad000a1165266902619685xxxxx",
            "Children": [],
            "ResultCode": "0",
            "SpanId": "7069ab30d7cbxxxx"
          }
        ]
      ]
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.