查询消息轨迹
功能介绍
查询消息轨迹。
URI
GET /v2/{engine}/{project_id}/instances/{instance_id}/trace
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
engine |
是 |
String |
消息引擎。 缺省值：reliability |
project_id |
是 |
String |
项目ID，获取方式请参见获取项目ID。 |
instance_id |
是 |
String |
实例ID。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
msg_id |
否 |
String |
消息ID。 |
请求参数
无
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
trace |
Array of trace objects |
消息轨迹列表。 |
参数 |
参数类型 |
描述 |
|---|---|---|
success |
Boolean |
是否成功。 |
trace_type |
String |
轨迹类型 |
timestamp |
Number |
时间。 |
group_name |
String |
生产组或消费组。 |
cost_time |
Number |
耗时。 |
request_id |
String |
请求ID。 |
consume_status |
Number |
消费状态。 |
topic |
String |
主题名称。 |
msg_id |
String |
消息ID。 |
offset_msg_id |
String |
offset消息ID。 |
tags |
String |
消息的标签。 |
keys |
String |
消息的keys。 |
store_host |
String |
存储消息的主机IP。 |
client_host |
String |
产生消息的主机IP。 |
retry_times |
String |
重试次数。 |
body_length |
Number |
消息体长度。 |
msg_type |
String |
消息类型。 |
transaction_state |
String |
事务状态。 |
transaction_id |
String |
事务ID。 |
from_transaction_check |
Boolean |
是否为事务回查的响应。 |
请求示例
查询RocketMQ实例的消息轨迹。
GET https://{endpoint}/v2/{engine}/{project_id}/instances/{instance_id}/trace
响应示例
状态码： 200
查询成功。
[ {
"success" : true,
"trace_type" : "Pub",
"timestamp" : 1634822858013,
"group_name" : "ProducerGroupName",
"cost_time" : 47,
"request_id" : "644F0069C829287CBBF26B9A54390000",
"consume_status" : 0,
"topic" : "aaaaa",
"msg_id" : "7F000001561018B4AAC26B9A0D1D0004",
"offset_msg_id" : "C0A8011700002774000000000000BE12",
"tags" : "TagA",
"keys" : "OrderID188",
"store_host" : "192.168.0.1:10101",
"client_host" : "127.0.0.1",
"retry_times" : 0,
"body_length" : 11,
"msg_type" : "Normal_Msg",
"transaction_state" : null,
"transaction_id" : null,
"from_transaction_check" : false
} ]
状态码
状态码 |
描述 |
|---|---|
200 |
查询成功。 |
错误码
请参见错误码。
