Consulta estatísticas de consumo de mensagens por consumidores em um grupo especificado dentro de um intervalo de tempo definido.
Observação
Esta operação permite consultar as seguintes estatísticas coletadas no ambiente de produção:
Número de mensagens consumidas durante cada período de amostragem
Transações por segundo (TPS) de consumo de mensagens durante cada período de amostragem
Se sua aplicação publica poucas mensagens e não o faz em intervalos específicos, recomendamos consultar o número de mensagens consumidas por período de amostragem. As estatísticas de TPS podem não apresentar uma tendência clara de variação nesses casos.
Limite de solicitações
Cada conta Alibaba Cloud pode chamar esta operação até 15 vezes por minuto. Se o número de solicitações enviadas para chamar esta operação dentro de um minuto atingir o limite, novas solicitações falharão. Isso pode interromper seus negócios. Para obter informações sobre o limite de solicitações de cada operação, consulte Limites de solicitação de API.
Autorização
Por padrão, contas Alibaba Cloud podem chamar esta operação. Um usuário do Resource Access Management (RAM) só pode executar esta operação após receber as permissões necessárias. A tabela a seguir descreve as permissões que devem ser concedidas a um usuário RAM para chamar esta operação. Para saber como conceder permissões, consulte Políticas.
|
API |
Action |
Recurso em uma instância com namespace |
Recurso em uma instância sem namespace |
|
OnsTrendGroupOutputTps |
mq:QueryInstanceBaseInfo mq:QueryTrendGroupOutputTps |
acs:mq:::{instanceId}%{groupId} |
acs:mq:::{groupId} |
Parâmetros da solicitação
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| Action | String | Sim | OnsTrendGroupOutputTps | A operação a ser executada. Defina o valor como OnsTrendGroupOutputTps. |
| GroupId | String | Sim | GID_test | O ID do grupo de consumidores a ser consultado. |
| Topic | String | Sim | test | O nome do tópico a ser consultado. |
| BeginTime | Long | Sim | 1570852800000 | O início do intervalo de tempo a ser consultado. O valor é um timestamp UNIX que representa o número de milissegundos decorridos desde a época 1º de janeiro de 1970, 00:00:00 UTC. |
| EndTime | Long | Sim | 1570868400000 | O fim do intervalo de tempo a ser consultado. O valor é um timestamp UNIX que representa o número de milissegundos decorridos desde a época 1º de janeiro de 1970, 00:00:00 UTC. |
| Type | Integer | Sim | 0 | O tipo de informação a ser consultada. Valores válidos:
|
| InstanceId | String | Sim | MQ_INST_111111111111_DOxxxxxx | O ID da instância do Message Queue for Apache RocketMQ que contém o grupo de consumidores especificado. |
| Period | Long | Não | 10 | O 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 |
CE57AEDC-8FD2-43ED-8E3B-1F878077**** |
O ID da solicitação. O sistema gera um ID exclusivo para cada solicitação. Use esse ID para solucionar problemas. |
|
Data |
Object |
Os dados retornados. |
|
|
Records |
Array of StatsDataDo |
O conjunto de dados retornado com base no período de amostragem. |
|
|
StatsDataDo |
|||
|
Y |
Float |
0 |
Indica o TPS de consumo de mensagens ou o número de mensagens consumidas. |
|
X |
Long |
1570867800000 |
Indica o timestamp. O valor é um timestamp UNIX que representa o número de milissegundos decorridos desde a época 1º de janeiro de 1970, 00:00:00 UTC. |
|
XUnit |
String |
time |
A unidade do timestamp. Unidade: milissegundos. |
|
YUnit |
String |
msg |
A unidade do valor do parâmetro Y. |
|
Title |
String |
MQ_INST_111111111111_DOxxxxxx%test@MQ_INST_111111111111_DOxxxxxx%GID_test trend of received messages |
O nome da tabela que armazena os dados. |
Exemplos
Exemplos de solicitações
http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsTrendGroupOutputTps
&BeginTime=1570852800000
&EndTime=1570868400000
&GroupId=GID_test
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&Topic=test
&Type=0
&<Common request parameters>Exemplos de respostas de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<OnsTrendGroupOutputTpsResponse>
<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>1570855200000</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_INST_111111111111_DOxxxxxx%GID_test trend of received messages</Title>
</Data>
<RequestId>CE57AEDC-8FD2-43ED-8E3B-1F878077****</RequestId>
</OnsTrendGroupOutputTpsResponse>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" : 1570855200000
}, {
"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@MQ_INST_111111111111_DOxxxxxx%GID_test trend of received messages"
},
"RequestId" : "CE57AEDC-8FD2-43ED-8E3B-1F878077****"
}Códigos de erro
Para obter uma lista de códigos de erro, visite a Central de Erros de API.
Visualize as estatísticas de consumo de mensagens no console
No Message Queue for Apache RocketMQ console, visualize as estatísticas de consumo de mensagens pelos consumidores em um grupo de consumidores. Para obter mais informações, consulte Painel.