QueryMqttTraceMessagePublish - : Central de Documentação do Alibaba Cloud

Consulta os rastros de envio de uma mensagem específica. Se uma mensagem não for enviada e recebida conforme o esperado, use esta operação para visualizar os detalhes da mensagem. Por exemplo, consulte o horário de publicação e o cliente que a publicou. Esta operação ajuda a localizar e identificar a causa do problema.

Faturamento

Cada chamada bem-sucedida à operação QueryMqttTraceMessagePublish incrementa em um as transações de mensagens por segundo (TPS). Portanto, essa chamada é cobrada. Para mais informações sobre faturamento, consulte Faturamento.

Limite de QPS

O limite de consultas por segundo (QPS) desta operação é 500 por usuário. O sistema aciona o throttling se o número de chamadas exceder esse limite, o que pode afetar seus negócios. Invoque esta operação apenas quando necessário. Para mais informações, consulte Limites de QPS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	QueryMqttTraceMessagePublish	A operação a ser executada. Defina o valor como QueryMqttTraceMessagePublish.
MqttRegionId	String	Sim	cn-hangzhou	O ID da região da instância do ApsaraMQ forMQTT. Para mais informações, consulte Endpoints.
InstanceId	String	Sim	mqtt-cn-i7m26mf****	O ID da instância do ApsaraMQ forMQTT. O valor deve corresponder ao ID da instância usado no cliente ApsaraMQ forMQTT. Visualize o ID da instância na seção Basic Information da página Instance Details da instância no console do ApsaraMQ forMQTT.
BeginTime	Long	Sim	1618646400000	O início do intervalo de tempo da consulta. Este valor é um timestamp UNIX que representa o número de milissegundos decorridos desde a época (epoch time) de 1º de janeiro de 1970, 00:00:00 UTC. Unidade: milissegundos.
EndTime	Long	Sim	1621591200000	O fim do intervalo de tempo da consulta. Este valor é um timestamp UNIX que representa o número de milissegundos decorridos desde a época (epoch time) de 1º de janeiro de 1970, 00:00:00 UTC. Unidade: milissegundos.
MsgId	String	Sim	AC1EC0030EAB78308DB16A3EC773****	O ID da mensagem.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	69AD5550-BF22-438A-9202-A6E89185****	O ID da solicitação. Este é um parâmetro comum. Cada solicitação possui um ID exclusivo para facilitar a solução de problemas e a localização de falhas.
MessageTraceLists	Array of MessageTraceLists		Os rastros da mensagem consultada.
Action	String	pub_mqtt	A ação na mensagem. Valores válidos: pub_mqtt: indica que um cliente ApsaraMQ forMQTT enviou a mensagem. pub_mq: indica que um cliente Message Queue for Apache RocketMQ enviou a mensagem.
ActionCode	String	mqtt.trace.action.msg.pub.mqtt	O código retornado para a ação na mensagem. Valores válidos: mqtt.trace.action.msg.pub.mqtt: retornado quando o parâmetro Action é pub_mqtt. mqtt.trace.action.msg.pub.mq: retornado quando o parâmetro Action é pub_mq.
ActionInfo	String	Pub From Mqtt Client	As informações retornadas para a ação na mensagem. Valores válidos: Pub From Mqtt Client: retornado quando o parâmetro Action é pub_mqtt. Pub From MQ: retornado quando o parâmetro Action é pub_mq.
ClientId	String	GID_test@@@producer	O ID do cliente que enviou a mensagem.
MsgId	String	AC1EC0030EAB78308DB16A3EC773BD95	O ID da mensagem.
Time	String	2021-05-21 15:08:19.210	O horário de envio da mensagem.

Exemplos

Exemplos de solicitações

http(s)://onsmqtt.cn-hangzhou.aliyuncs.com/?Action=QueryMqttTraceMessagePublish
&MqttRegionId=cn-hangzhou
&InstanceId=mqtt-cn-i7m26mf****
&BeginTime=1618646400000
&EndTime=1621591200000
&MsgId=AC1EC0030EAB78308DB16A3EC773****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<QueryMqttTraceMessagePublishResponse>
    <MessageTraceLists>
        <Action>pub_mqtt</Action>
        <ActionCode>mqtt.trace.action.msg.pub.mqtt</ActionCode>
        <ClientId>GID_test@@@producer</ClientId>
        <Time>2021-05-21 15:08:19.210</Time>
        <ActionInfo>Pub From Mqtt Client</ActionInfo>
        <MsgId>AC1EC0030EAB78308DB16A3EC773****</MsgId>
    </MessageTraceLists>
    <RequestId>69AD5550-BF22-438A-9202-A6E89185****</RequestId>
</QueryMqttTraceMessagePublishResponse>

Formato JSON

{   
        "MessageTraceLists": {
            "Action": "pub_mqtt",
            "ActionCode": "mqtt.trace.action.msg.pub.mqtt",
            "ClientId": "GID_test@@@producer",
            "Time": "2021-05-21 15:08:19.210",
            "ActionInfo": "Pub From Mqtt Client",
            "MsgId": "AC1EC0030EAB78308DB16A3EC773****"
        },
        "RequestId": "69AD5550-BF22-438A-9202-A6E89185****"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
404	ApiNotSupport	The specified API operation is not supported.	A operação de API especificada não é suportada.
500	SystemOverFlow	An error occurred while processing your request. Please try again.	Ocorreu um erro durante o processamento da solicitação. Tente novamente.

Para obter uma lista de códigos de erro, visite o API Error Center.

Operações no console do ApsaraMQ forMQTT

Além de invocar a operação QueryMqttTraceMessagePublish, visualize os rastros de envio de uma mensagem diretamente no console do ApsaraMQ forMQTT. Para mais informações, consulte Consultar rastros de mensagens.