All Products
Search
Document Center

Application Real-Time Monitoring Service:DoInsightsAction

Last Updated:Jun 24, 2026

Menjalankan tindakan yang sesuai berdasarkan tipe modul yang ditentukan oleh parameter.

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

Module

string

Yes

Tipe modul

  • QueryTopo

    Fitur kueri topologi. Topologi terdiri dari edge dan node. Setiap edge memiliki tipe yang sesuai, setiap node memiliki entitas yang sesuai, dan setiap entitas memiliki tipenya. Dengan menetapkan parameter filter seperti tipe edge, tipe node, dan rentang waktu kueri, Anda dapat memfilter data topologi yang diperlukan.

  • QueryTopoRed

    Kueri metrik RED topologi (jumlah permintaan, latensi, jumlah error). Saat melakukan kueri topologi dengan opsi kueri metrik diaktifkan, mungkin tidak dapat mengambil seluruh data metrik karena topologi yang terlalu besar. Fitur ini memungkinkan pengguna untuk secara aktif melakukan kueri data metrik dari node tertentu dan edge tertentu.

Catatan: Fitur di atas masih dalam rilis grayscale dan tidak diaktifkan secara default. Untuk mengaktifkannya, silakan hubungi nomor on-call ARMS.

Valid values:

  • QueryTopoRed :

    Kueri metrik RED topologi

  • QueryTopo :

    Kueri topologi

QueryTopo

Data

string

Yes

Parameter kueri. Tipe modul yang berbeda berhubungan dengan parameter kueri yang berbeda.

  • QueryTopo

{
    "regionId": string,  #ID region
    "startTime": string, #Waktu mulai, format: yyyy-MM-dd HH:mm:ss
    "endTime": string, #Waktu akhir, format: yyyy-MM-dd HH:mm:ss
    "edgeFilter": { #Kondisi filter edge
        "includeTypes": [enum], #Tipe edge yang disertakan
        "excludeTypes": [enum], #Tipe edge yang dikecualikan
        "fromNodeFilter": { #Kondisi filter node sumber
            "includeEntityTypes": [enum] #Tipe entitas yang disertakan
            "excludeEntityTypes": [enum] #Tipe entitas yang dikecualikan
        },
        "toNodeFilter": {  #Kondisi filter node target
            "includeEntityTypes": [enum] #Tipe entitas yang disertakan
            "excludeEntityTypes": [enum] #Tipe entitas yang dikecualikan
        }
    },
    "includeIsolatedNodes": boolean, #Apakah menyertakan node terisolasi
    "isolatedNodeFilter": { # Kondisi filter node terisolasi
        "includeEntityTypes": [enum] #Tipe entitas yang disertakan
        "excludeEntityTypes": [enum] #Tipe entitas yang dikecualikan
     },
    "queryMetrics": boolean, # Apakah secara sinkron melakukan kueri metrik RED terkait selama kueri
    "timeoutSecs": int, # Timeout kueri metrik
	"redOption": { #Opsi kontrol kueri metrik
		"skipRt": boolean,  # Apakah melewati kueri metrik RT
		"skipCount": boolean, # Apakah melewati kueri metrik jumlah permintaan
		"skipError": boolean # Apakah melewati kueri metrik jumlah error
	}
}

  • QueryTopoRed

{
    "regionId": string,  #ID region
    "startTime": string, #Waktu mulai, format: yyyy-MM-dd HH:mm:ss
    "endTime": string,   #Waktu akhir, format: yyyy-MM-dd HH:mm:ss
    "edgeIds": [string]  #ID edge yang akan dikueri
    "nodeIds": [string]  #ID node yang akan dikueri
    "redOption": { #Opsi kontrol kueri metrik
        "skipRt": boolean,  # Apakah melewati kueri metrik RT
        "skipCount": boolean, # Apakah melewati kueri metrik jumlah permintaan
        "skipError": boolean # Apakah melewati kueri metrik jumlah error
    }
}

- QueryTopo { "regionId": "cn-hangzhou", "startTime": "2024-07-23 19:16:00", "endTime": "2024-07-23 20:16:00", # 限定拓扑查询范围为 2024-07-23 19:16:00至2024-07-23 20:16:00 "edgeFilter": { "includeTypes": [ "CALLS" # 限定结果拓扑中仅包含调用关系的边 ], "fromNodeFilter": { "includeEntityTypes": [ # 限定调用边的源节点类型必须为应用类型 "APPLICATION" ] }, "toNodeFilter": { "includeEntityTypes": [ # 限定调用边的目标节点必须为应用类型或者外部服务类型 "APPLICATION", "EXTERNAL_SERVICE" ] } }, "includeIsolatedNodes": false, # 结果拓扑中不包含孤立节点 "queryMetrics": true, # 同步查询RED指标 "timeoutSecs": 20, #最多用20秒来查询指标数据 "redOption": { # 查询的指标包括耗时、请求量,跳过错误数的查询 "skipRt": false, "skipCount": false, "skipError": true } } - QueryTopoRed { "regionId": "cn-hangzhou", "startTime": "2024-07-23 10:00:00", "endTime": "2024-07-23 14:00:00", "edgeIds": [ "097843bd50b06fbe2c6c1d8b761a7e8b" ], "nodeIds": [ "23d973261c6923da1b5b7a571ec1aa8b" ], "redOption": { # 查询的指标包括耗时、请求量,跳过错误数的查询 "skipCount": false, "skipError": true, "skipRt": false } }

RegionId

string

No

ID Region.

cn-hangzhou

Topologi terdiri dari edge dan node. Setiap edge memiliki tipe yang sesuai, setiap node memiliki entitas yang sesuai, dan setiap entitas memiliki tipenya. Dengan menetapkan parameter seperti tipe edge, tipe node, dan rentang waktu kueri, Anda dapat memfilter data topologi yang diperlukan.

  • Node terisolasi

    Node terisolasi adalah node yang tidak memiliki relasi dengan node lain.

Ketika tipe field adalah enum, ini berarti nilai field berasal dari enumerasi. Lihat catatan tambahan untuk definisi enumerasi.

Elemen respons

Element

Type

Description

Example

object

Skema Respons

RequestId

string

ID permintaan

626037F5-FDEB-45B0-804C-B3C92797A64E

Code

integer

Kode status. 200 menunjukkan keberhasilan; kode status lainnya menunjukkan adanya pengecualian.

200

Success

boolean

Apakah kueri berhasil:

  • true: Berhasil.

  • false: Gagal.

true

Message

string

Informasi yang dikembalikan ketika panggilan gagal.

success

Data

string

Tipe parameter yang dikembalikan terkait dengan nilai module yang diteruskan.

  • QueryTopo

    {
     "nodes": [Object] #Kumpulan node. Lihat definisi Node dalam catatan tambahan parameter respons
     "edges": [Object] #Kumpulan edge. Lihat definisi Edge dalam catatan tambahan parameter respons
    }
    
  • QueryTopoRed

    {
      "nodeRed": {
      	"nodeId": {
      		"count": double, #Jumlah total permintaan selama periode kueri
      		"error": double, #Jumlah total error selama periode kueri
      		"rt": double, #Latensi rata-rata selama periode kueri, dalam milidetik
      	}
      },
      "edgeRed": {
      	"edgeId": {
      	    "count": double, #Jumlah total permintaan selama periode kueri
      		"error": double, #Jumlah total error selama periode kueri
      		"rt": double, #Latensi rata-rata selama periode kueri, dalam milidetik
      	}
      }
    

}

- QueryTopo { "nodes": [ { "nodeId": "3bfe1a747389273388182760406c079d", "entity": { "regionId": "cn-hangzhou", "appType": "TRACE", "appId": "xxxxxxxxxxxxxxxx", "name": "prometheus-pop-cn-hangzhou", "entityId": "3bfe1a747389273388182760406c079d", "firstSeenTms": 1721733226981, "lastSeenTms": 1721789171614, "type": "APPLICATION" }, "attrs": { "RED": { "count": 643848.0, "error": 0.0, "rt": 172.31701892372112 } } } ], "edges": [ { "from": "98b4184b22e588cf86e9a29aa4179606", "to": "98b4184b22e588cf86e9a29aa4179606", "type": "CALLS", "attrs": { "RED": { "count": 4.0, "error": 0.0, "rt": 37.0 } }, "edgeId": "5d611597e4b0013d0947615c9eca4de6", "firstSeenTms": 1721783795125, "lastSeenTms": 1721787371614 } ] } - QueryTopoRed { "nodeRed": { "361d9f32e58cef316bf2355f3ff05575": { "count": 3258110.0, "error": 74.0, "rt": 167.39844355494878 } }, "edgeRed": {} }

  • Definisi Node

     {
     	"nodeId": string, #ID Node
     	"entity": Object, #Informasi entitas. Field berbeda tergantung pada tipe. Lihat "Informasi entitas" dalam catatan tambahan             
     	"attrs": { #Informasi atribut yang diperluas 
     		"RED": { # Metrik RED
     			"count": double, #Total volume permintaan selama periode kueri
     			"error": double, #Jumlah total error selama periode kueri
     			"rt": double, # Latensi rata-rata selama periode kueri, dalam milidetik
     		}
     	}
     }
    
  • Definisi Edge

     	{
     	"from": string, #ID Node
     	"to": string,   #ID Node
     	"type": enum, #Lihat "Tipe Edge" dalam catatan tambahan
     	"attrs": { #Informasi atribut yang diperluas
     		"RED": { # Metrik RED
     			"count": double, #Total volume permintaan selama periode kueri
     			"error": double, #Jumlah total error selama periode kueri
     			"rt": double,    #Latensi rata-rata selama periode kueri, dalam milidetik
     		}
     	},
     	"edgeId": string, #ID Edge
     	"firstSeenTms": long, #Waktu ketika edge pertama kali ditemukan, timestamp milidetik
     	"lastSeenTms": long,  #Waktu ketika edge terakhir ditemukan, timestamp milidetik
     }
    
    

Contoh

Respons sukses

JSONformat

{
  "RequestId": "626037F5-FDEB-45B0-804C-B3C92797A64E",
  "Code": 200,
  "Success": true,
  "Message": "success",
  "Data": "- QueryTopo\n\n\n\t{\n\t\t\"nodes\": [\n\t\t\t{\n\t\t\t\t\"nodeId\": \"3bfe1a747389273388182760406c079d\",\n\t\t\t\t\"entity\": {\n\t\t\t\t\t\"regionId\": \"cn-hangzhou\",\n\t\t\t\t\t\"appType\": \"TRACE\",\n\t\t\t\t\t\"appId\": \"xxxxxxxxxxxxxxxx\",\n\t\t\t\t\t\"name\": \"prometheus-pop-cn-hangzhou\",\n\t\t\t\t\t\"entityId\": \"3bfe1a747389273388182760406c079d\",\n\t\t\t\t\t\"firstSeenTms\": 1721733226981,\n\t\t\t\t\t\"lastSeenTms\": 1721789171614,\n\t\t\t\t\t\"type\": \"APPLICATION\"\n\t\t\t\t},\n\t\t\t\t\"attrs\": {\n\t\t\t\t\t\"RED\": {\n\t\t\t\t\t\t\"count\": 643848.0,\n\t\t\t\t\t\t\"error\": 0.0,\n\t\t\t\t\t\t\"rt\": 172.31701892372112\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t],\n\t\t\"edges\": [\n\t\t\t{\n\t\t\t\t\"from\": \"98b4184b22e588cf86e9a29aa4179606\",\n\t\t\t\t\"to\": \"98b4184b22e588cf86e9a29aa4179606\",\n\t\t\t\t\"type\": \"CALLS\",\n\t\t\t\t\"attrs\": {\n\t\t\t\t\t\"RED\": {\n\t\t\t\t\t\t\"count\": 4.0,\n\t\t\t\t\t\t\"error\": 0.0,\n\t\t\t\t\t\t\"rt\": 37.0\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\t\"edgeId\": \"5d611597e4b0013d0947615c9eca4de6\",\n\t\t\t\t\"firstSeenTms\": 1721783795125,\n\t\t\t\t\"lastSeenTms\": 1721787371614\n\t\t\t}\n\t\t]\n\t}\n\n\n- QueryTopoRed\n\n\t{\n\t\t\"nodeRed\": {\n\t\t\t\"361d9f32e58cef316bf2355f3ff05575\": {\n\t\t\t\t\"count\": 3258110.0,\n\t\t\t\t\"error\": 74.0,\n\t\t\t\t\"rt\": 167.39844355494878\n\t\t\t}\n\t\t},\n\t\t\"edgeRed\": {}\n\t}\n\n"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.