OnsTrendGroupOutputTps - - Centre de documentation Alibaba Cloud

Interroge les statistiques de consommation des messages par les consommateurs d'un groupe spécifié, sur une plage horaire donnée.

Remarque

Cette opération permet d'interroger les statistiques suivantes collectées dans l'environnement de production :

Le nombre de messages consommés durant chaque période d'échantillonnage
Le débit en transactions par seconde (TPS) pour la consommation des messages durant chaque période d'échantillonnage

Remarque

Si votre application publie peu de messages et n'en publie pas à intervalles réguliers, nous vous recommandons d'interroger le nombre de messages consommés durant chaque période d'échantillonnage. En effet, les statistiques TPS peuvent ne pas afficher de tendance claire.

Limite de requêtes

Chaque compte Alibaba Cloud peut appeler cette opération jusqu'à 15 fois par minute. Si le nombre de requêtes envoyées atteint cette limite en une minute, les nouvelles requêtes échouent, ce qui peut interrompre votre activité. Pour plus d'informations sur les limites de requêtes de chaque opération, consultez la section Limites de requêtes API.

Autorisation

Par défaut, les comptes Alibaba Cloud peuvent appeler cette opération. Un utilisateur RAM (Resource Access Management) ne peut l'appeler qu'après avoir reçu les autorisations requises. Le tableau suivant décrit les autorisations à accorder à un utilisateur RAM pour appeler cette opération. Pour savoir comment accorder des autorisations, consultez la section Politiques.

API

Action

Ressource dans une instance utilisant un namespace

Ressource dans une instance n'utilisant pas de namespace

OnsTrendGroupOutputTps

mq:QueryInstanceBaseInfo

mq:QueryTrendGroupOutputTps

acs:mq:*:*:{instanceId}%{groupId}

acs:mq:*:*:{groupId}

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	OnsTrendGroupOutputTps	Opération à effectuer. Définissez la valeur sur OnsTrendGroupOutputTps.
GroupId	String	Oui	GID_test	ID du groupe de consommateurs à interroger.
Topic	String	Oui	test	Nom du topic à interroger.
BeginTime	Long	Oui	1570852800000	Début de la plage horaire à interroger. La valeur est un horodatage UNIX représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC.
EndTime	Long	Oui	1570868400000	Fin de la plage horaire à interroger. La valeur est un horodatage UNIX représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC.
Type	Integer	Oui	0	Type d'information à interroger. Valeurs valides : 0 : nombre de messages consommés durant chaque période d'échantillonnage. 1 : débit en TPS pour la consommation des messages durant chaque période d'échantillonnage.
InstanceId	String	Oui	MQ_INST_111111111111_DOxxxxxx	ID de l'instance Message Queue for Apache RocketMQ contenant le groupe de consommateurs spécifié.
Period	Long	Non	10	Période d'échantillonnage. Unité : minutes. Valeurs valides : 1, 5 et 10.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	CE57AEDC-8FD2-43ED-8E3B-1F878077****	ID de la requête. Le système génère un ID unique pour chaque requête. Vous pouvez résoudre les problèmes en vous basant sur cet ID.
Data	Object		Données renvoyées.
Records	Array of StatsDataDo		Ensemble de données renvoyé selon la période d'échantillonnage.
StatsDataDo
Y	Float	0	Débit en TPS pour la consommation des messages ou nombre de messages consommés.
X	Long	1570867800000	Horodatage. La valeur est un horodatage UNIX représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC.
XUnit	String	time	Unité de l'horodatage. Unité : millisecondes.
YUnit	String	msg	Unité de la valeur du paramètre Y.
Title	String	MQ_INST_111111111111_DOxxxxxx%test@MQ_INST_111111111111_DOxxxxxx%GID_test trend of received messages	Nom du tableau stockant les données.

Exemples

Exemples de requêtes

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>

Exemples de réponses réussies

Format 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>

Format 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****"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.

Afficher les statistiques de consommation des messages dans la console

Dans la console Message Queue for Apache RocketMQ, consultez les statistiques de consommation des messages par les consommateurs d'un groupe de consommateurs. Pour plus d'informations, consultez la section Tableau de bord.