OnsTrendTopicInputTps - - Centro de documentación de Alibaba Cloud

Consulta las estadísticas de publicación de mensajes en un topic específico dentro de un intervalo de tiempo determinado.

Nota

Esta operación permite consultar las estadísticas de los mensajes publicados en un topic específico del entorno de producción. Puede obtener la cantidad de mensajes publicados en el topic o las transacciones por segundo (TPS) de publicación para cada periodo de muestreo dentro del intervalo de tiempo especificado.

Nota

Si su aplicación publica pocos mensajes y no lo hace a intervalos regulares, se recomienda consultar la cantidad de mensajes publicados en el topic durante cada periodo de muestreo, ya que las estadísticas de TPS podrían no mostrar una tendencia clara.

Límites de solicitud

Cada cuenta de Alibaba Cloud puede invocar esta operación hasta 15 veces por minuto. Si el número de solicitudes enviadas en un minuto alcanza este límite, las nuevas solicitudes fallarán, lo cual podría interrumpir su servicio. Para más información sobre los límites de solicitud de cada operación, consulte Límites de solicitud de API.

Autorización

Las cuentas de Alibaba Cloud pueden invocar esta operación de forma predeterminada. Un usuario de Resource Access Management (RAM) solo podrá hacerlo si cuenta con los permisos necesarios. La siguiente tabla describe los permisos que se deben otorgar al usuario de RAM para ejecutar esta operación. Para obtener detalles sobre cómo asignar permisos, consulte Directivas.

API

Action

Recurso en una instancia con namespace

Recurso en una instancia sin namespace

OnsTrendTopicInputTps

mq:QueryInstanceBaseInfo

mq:QueryTrendTopicInputTps

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

acs:mq:::{topic}

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	OnsTrendTopicInputTps	La operación que se desea ejecutar. Establezca el valor como OnsTrendTopicInputTps.
Topic	String	Sí	test	El nombre del topic que se desea consultar.
BeginTime	Long	Sí	1570852800000	Inicio del intervalo de tiempo a consultar. El valor es una marca de tiempo UNIX que representa los milisegundos transcurridos desde la época (1 de enero de 1970, 00:00:00 UTC).
EndTime	Long	Sí	1570868400000	Fin del intervalo de tiempo a consultar. El valor es una marca de tiempo UNIX que representa los milisegundos transcurridos desde la época (1 de enero de 1970, 00:00:00 UTC).
Type	Integer	Sí	0	Tipo de información que se desea consultar. Valores válidos: 0: cantidad de mensajes publicados en el topic especificado durante cada periodo de muestreo. 1: TPS de publicación de mensajes en el topic especificado durante cada periodo de muestreo.
InstanceId	String	Sí	MQ_INST_111111111111_DOxxxxxx	ID de la instancia de Message Queue for Apache RocketMQ que contiene el topic que se desea consultar.
Period	Long	No	10	Periodo de muestreo. Unidad: minutos. Valores válidos: 1, 5 y 10.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	E213AD8A-0730-4B3D-A35A-340DA47D****	ID de la solicitud. El sistema genera un identificador único para cada solicitud, útil para la resolución de problemas.
Data	Object		Datos devueltos en la respuesta.
Records	Array of StatsDataDo		Conjunto de datos devuelto según cada periodo de muestreo.
StatsDataDo
Y	Float	0	Indica las TPS de publicación de mensajes o la cantidad de mensajes publicados en el topic.
X	Long	1570852800000	Marca de tiempo. Valor UNIX que representa los milisegundos transcurridos desde la época (1 de enero de 1970, 00:00:00 UTC).
XUnit	String	time	Unidad de la marca de tiempo. Unidad: milisegundos.
YUnit	String	msg	Unidad del valor correspondiente al parámetro Y.
Title	String	MQ_INST_111111111111_DOxxxxxx%test trend of received messages	Nombre de la tabla que almacena los datos.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas exitosas de ejemplo

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 error

Para consultar la lista de códigos de error, consulte el Centro de errores de API.

Consulta de estadísticas de mensajes en la consola

En la consola de Message Queue for Apache RocketMQ, puede consultar las estadísticas de los mensajes publicados en un topic. Para más información, consulte Panel.