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

Observação

Use esta operação para consultar estatísticas de mensagens publicadas em um tópico específico no ambiente de produção. É possível obter a quantidade de mensagens publicadas no tópico ou as transações por segundo (TPS) de publicação para cada período de amostragem dentro do intervalo de tempo especificado.

Nota

Se sua aplicação publica poucas mensagens e não segue um intervalo regular, recomendamos consultar o número total de mensagens publicadas por período de amostragem. Nesse cenário, as estatísticas de TPS podem não apresentar uma tendência clara de variação.

Limite de requisições

Cada conta Alibaba Cloud pode chamar esta operação até 15 vezes por minuto. Se o volume de requisições atingir esse limite dentro de um minuto, novas chamadas falharão, o que pode interromper seus serviços. Para mais detalhes sobre os limites de cada operação, consulte Limites de requisição da API.

Autorização

Contas Alibaba Cloud têm permissão nativa para executar esta operação. Usuários do Resource Access Management (RAM) precisam receber as permissões adequadas antes de utilizá-la. A tabela a seguir detalha as permissões necessárias para usuários RAM. Para saber como conceder permissões, consulte Políticas.

API

Action

Recurso em instância com namespace

Recurso em instância sem namespace

OnsTrendTopicInputTps

mq:QueryInstanceBaseInfo

mq:QueryTrendTopicInputTps

acs:mq:::{instanceId}%{topic}

acs:mq:::{topic}

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	OnsTrendTopicInputTps	Operação a ser executada. Defina o valor como OnsTrendTopicInputTps.
Topic	String	Sim	test	Nome do tópico a ser consultado.
BeginTime	Long	Sim	1570852800000	Início do intervalo de tempo da consulta. O valor é um timestamp UNIX que representa os milissegundos decorridos desde a época 1º de janeiro de 1970, 00:00:00 UTC.
EndTime	Long	Sim	1570868400000	Fim do intervalo de tempo da consulta. O valor é um timestamp UNIX que representa os milissegundos decorridos desde a época 1º de janeiro de 1970, 00:00:00 UTC.
Type	Integer	Sim	0	Tipo de informação a ser consultada. Valores válidos: 0: quantidade de mensagens publicadas no tópico especificado durante cada período de amostragem. 1: TPS de publicação de mensagens no tópico especificado durante cada período de amostragem.
InstanceId	String	Sim	MQ_INST_111111111111_DOxxxxxx	ID da instância do Message Queue for Apache RocketMQ que contém o tópico a ser consultado.
Period	Long	Não	10	Período de amostragem. Unidade: minutos. Valores válidos: 1, 5 e 10.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	E213AD8A-0730-4B3D-A35A-340DA47D****	ID da requisição. O sistema gera um identificador único para cada solicitação, útil para solução de problemas.
Data	Object		Dados retornados pela operação.
Records	Array of StatsDataDo		Conjunto de dados agrupados por período de amostragem.
StatsDataDo
Y	Float	0	Representa o TPS de publicação ou o número total de mensagens publicadas no tópico.
X	Long	1570852800000	Timestamp correspondente. Valor em formato UNIX indicando milissegundos desde 1º de janeiro de 1970, 00:00:00 UTC.
XUnit	String	time	Unidade do timestamp. Valor fixo: milissegundos.
YUnit	String	msg	Unidade de medida do parâmetro Y.
Title	String	MQ_INST_111111111111_DOxxxxxx%test trend of received messages	Nome da tabela onde os dados estão armazenados.

Exemplos

Exemplo de requisição

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsTrendTopicInputTps
&BeginTime=1570852800000
&EndTime=1570868400000
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&Topic=test
&Type=0
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<OnsTrendTopicInputTpsResponse>
<Data>
    <Records>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570852800000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570853400000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570854000000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570854600000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570860600000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570861200000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570861800000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570862400000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570863000000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570863600000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570864200000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>1</Y>
            <X>1570864800000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570865400000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570866000000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570866600000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570867200000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570867800000</X>
        </StatsDataDo>
        <StatsDataDo>
            <Y>0</Y>
            <X>1570868400000</X>
        </StatsDataDo>
    </Records>
    <XUnit>time</XUnit>
    <YUnit>msg</YUnit>
    <Title>MQ_INST_111111111111_DOxxxxxx%test-mq_topic trend of received messages</Title>
</Data>
<RequestId>E213AD8A-0730-4B3D-A35A-340DA47D****</RequestId>
</OnsTrendTopicInputTpsResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Data" : {
    "Records" : {
      "StatsDataDo" : [ {
        "Y" : 0,
        "X" : 1570852800000
      }, {
        "Y" : 0,
        "X" : 1570853400000
      }, {
        "Y" : 0,
        "X" : 1570854000000
      }, {
        "Y" : 0,
        "X" : 1570854600000
      }, {
        "Y" : 0,
        "X" : 1570860600000
      }, {
        "Y" : 0,
        "X" : 1570861200000
      }, {
        "Y" : 0,
        "X" : 1570861800000
      }, {
        "Y" : 0,
        "X" : 1570862400000
      }, {
        "Y" : 0,
        "X" : 1570863000000
      }, {
        "Y" : 0,
        "X" : 1570863600000
      }, {
        "Y" : 0,
        "X" : 1570864200000
      }, {
        "Y" : 1,
        "X" : 1570864800000
      }, {
        "Y" : 0,
        "X" : 1570865400000
      }, {
        "Y" : 0,
        "X" : 1570866000000
      }, {
        "Y" : 0,
        "X" : 1570866600000
      }, {
        "Y" : 0,
        "X" : 1570867200000
      }, {
        "Y" : 0,
        "X" : 1570867800000
      }, {
        "Y" : 0,
        "X" : 1570868400000
      } ]
    },
    "XUnit" : "time",
    "YUnit" : "msg",
    "Title": "MQ_INST_111111111111_DOxxxxxx%test trend of received messages"
  },
  "RequestId" : "E213AD8A-0730-4B3D-A35A-340DA47D****"
}

Códigos de erro

Para consultar a lista completa de códigos de erro, acesse o Centro de Erros da API.

Visualize estatísticas de mensagens no console

No Message Queue for Apache RocketMQ console, visualize as estatísticas das mensagens publicadas em um tópico. Para mais informações, consulte Painel.