GetMqSofamqTraceResult

已根据 Message ID 或者 Message Key 创建了轨迹查询任务,并得到了查询任务的 ID。此时,可调用本接口通过传入该查询任务 ID,获取对应的轨迹查询的结果明细。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述

Action

String

GetMqSofamqTraceResult

系统规定参数。取值:GetMqSofamqTraceResult。

InstanceId

String

MQ_INST_111111111111_DOxxxxxx

实例 ID

QueryId

String

272967562652883649157096685****

消息轨迹查询的任务 ID

返回数据

名称

类型

示例值

描述

Data

Struct

该查询任务的结果明细

CreateTime

Long

1570966857000

该查询任务的创建时间

InstanceId

String

MQ_INST_111111111111_DOxxxxxx

实例 ID

MsgId

String

1E05791C117818B4AAC23B1BB0CE****

该查询任务对应的 Message ID

MsgKey

String

keyA

该查询任务对应的 Message Key

QueryId

String

272967562652883649157096685****

查询任务 ID

Status

String

finish

该查询任务的结果。取值说明如下:finish:查询完成;working:查询中;removed:任务已删除。

Topic

String

topic_a

该查询任务的 Topic

TraceList

Array

该查询任务的匹配轨迹列表

BornHost

String

30.5.**.**

消息发送方的客户端地址

Cell

String

RZ00A

生产端的 cell name

CostTime

Long

24

发送耗时,单位毫秒

MsgId

String

0BC1F01800002A9F000000531246****

消息的 ID,即 Message ID

MsgKey

String

ORDERID_100

消息的 Key ,即 Message Key

PubGroupName

String

GID_test

发送方客户端配置的 Group ID

PubTime

Long

1570850870478

消息发送时间

Status

String

SEND_SUCCESS

发送状态。取值说明如下:

  • SEND_SUCCESS:发送成功

  • SEND_FAILED:发送失败

  • SEND_ROLLBACK:事务消息回滚

  • SEND_UNKNOWN:事务消息未提交

  • SEND_DELAY:定时(延时)消息定时中

SubList

Array

消息的消费轨迹列表

Cell

String

RZ00A

cell name

ClientList

Array

该 Group ID 客户端消费记录的明细列表

ClientHost

String

30.5.**.**

消费客户端的客户端地址

CostTime

Long

43

本次消费耗时,单位毫秒

ReconsumeTimes

Long

1

本次消费的投递轮次

Status

String

CONSUME_SUCCESS

消费状态。取值说明如下:

  • CONSUME_FAILED:消费失败

  • CONSUME_SUCCESS:消费成功

  • CONSUME_NOT_RETURN:消费未返回结果

  • SEND_UNKNOWN:事务消息未提交

  • SEND_DELAY:定时(延时)消息定时中

SubGroupName

String

GID_test

该客户端所属的 Group ID

SubTime

Long

1570851590511

消费开始时间戳

FailCount

Long

0

该 Group ID 消费失败次数统计

SubGroupName

String

GID_test

消费方 Group ID

SuccessCount

Long

1

该 Group ID 消费成功次数统计

Tag

String

TagA

消息的 Tag,即 Message Tag

Topic

String

test

消息的 Topic

UpdateTime

Long

1570966857000

该查询任务的最后更新时间

UserId

String

27296756265288****

查询用户 ID

RequestId

String

861E6630-AEC0-4B2D-B214-6CB5E44B7F04

请求ID

ResultCode

String

OK

结果码

ResultMessage

String

OK

结果描述

示例

请求示例

http(s)://[Endpoint]/?Action=GetMqSofamqTraceResult
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&QueryId=272967562652883649157096685****
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>861E6630-AEC0-4B2D-B214-6CB5E44B7F04</RequestId>
<Data>
    <Status>finish</Status>
    <InstanceId>MQ_INST_111111111111_DOxxxxxx</InstanceId>
    <UserId>27296756265288****</UserId>
    <CreateTime>1570966857000</CreateTime>
    <MsgKey>keyA</MsgKey>
    <QueryId>272967562652883649157096685****</QueryId>
    <UpdateTime>1570966857000</UpdateTime>
    <TraceList>
        <CostTime>24</CostTime>
        <Status>SEND_SUCCESS</Status>
        <MsgKey>ORDERID_100</MsgKey>
        <BornHost>30.5.**.**</BornHost>
        <Tag>TagA</Tag>
        <PubGroupName>GID_test</PubGroupName>
        <PubTime>1570850870478</PubTime>
        <Topic>test</Topic>
        <Cell>RZ00A</Cell>
        <MsgId>0BC1F01800002A9F000000531246****        </MsgId>
    </TraceList>
    <TraceList>
        <SubList>
            <FailCount>0</FailCount>
            <SubGroupName>GID_test</SubGroupName>
            <SuccessCount>1</SuccessCount>
            <Cell>RZ00A</Cell>
        </SubList>
        <SubList>
            <ClientList>
                <CostTime>43</CostTime>
                <Status>CONSUME_SUCCESS</Status>
                <ClientHost>30.5.**.**</ClientHost>
                <SubTime>1570851590511</SubTime>
                <SubGroupName>GID_test</SubGroupName>
                <ReconsumeTimes>1</ReconsumeTimes>
            </ClientList>
        </SubList>
    </TraceList>
    <Topic>topic_a</Topic>
    <MsgId>1E05791C117818B4AAC23B1BB0CE****</MsgId>
</Data>
<ResultMessage>OK</ResultMessage>
<ResultCode>OK</ResultCode>

JSON 格式

{"RequestId":"861E6630-AEC0-4B2D-B214-6CB5E44B7F04","Data":{"Status":"finish","InstanceId":"MQ_INST_111111111111_DOxxxxxx","UserId":"27296756265288****","CreateTime":"1570966857000","MsgKey":"keyA","QueryId":"272967562652883649157096685****","UpdateTime":"1570966857000","TraceList":[{"CostTime":"24","Status":"SEND_SUCCESS","MsgKey":"ORDERID_100","BornHost":"30.5.**.**","Tag":"TagA","PubGroupName":"GID_test","PubTime":"1570850870478","Topic":"test","Cell":"RZ00A","MsgId":"0BC1F01800002A9F000000531246****\t"},{"SubList":[{"FailCount":"0","SubGroupName":"GID_test","SuccessCount":"1","Cell":"RZ00A"},{"ClientList":[{"CostTime":"43","Status":"CONSUME_SUCCESS","ClientHost":"30.5.**.**","SubTime":"1570851590511","SubGroupName":"GID_test","ReconsumeTimes":"1"}]}]}],"Topic":"topic_a","MsgId":"1E05791C117818B4AAC23B1BB0CE****"},"ResultMessage":"OK","ResultCode":"OK"}

错误码

访问错误中心查看更多错误码。