Menjalankan tindakan yang sesuai berdasarkan tipe modul yang ditentukan oleh parameter.
Coba sekarang
Test
RAM authorization
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| Module |
string |
Yes |
Tipe modul
Catatan: Fitur di atas masih dalam rilis grayscale dan tidak diaktifkan secara default. Untuk mengaktifkannya, silakan hubungi nomor on-call ARMS. Valid values:
|
QueryTopo |
| Data |
string |
Yes |
Parameter kueri. Tipe modul yang berbeda berhubungan dengan parameter kueri yang berbeda.
|
- 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 |
| Message |
string |
Informasi yang dikembalikan ketika panggilan gagal. |
success |
| Data |
string |
Tipe parameter yang dikembalikan terkait dengan nilai module yang diteruskan.
} |
- 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.