DescribeSiteMonitorData - - Centre de documentation Alibaba Cloud

Interroge les données de surveillance détaillées d'une tâche de surveillance de site.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeSiteMonitorData	Opération à effectuer. Définissez la valeur sur DescribeSiteMonitorData.
MetricName	String	Yes	Availability	Nom de la métrique. Valeurs valides : Availability ResponseTime
TaskId	String	Yes	49f7b317-7645-4cc9-94fd-ea42e522****	ID de la tâche de surveillance de site.
Type	String	No	metric	Type de l'objet surveillé dont vous souhaitez interroger les données. Valeurs valides : metric event
StartTime	String	No	1551579637000	Début de la plage de temps de la requête. Formats pris en charge : Horodatage UNIX : nombre de millisecondes écoulées depuis le 1er janvier 1970, 00:00:00 UTC. Format temporel : YYYY-MM-DDThh:mm:ssZ.
EndTime	String	No	1551581437000	Fin de la plage de temps de la requête. Formats pris en charge : Horodatage UNIX : nombre de millisecondes écoulées depuis le 1er janvier 1970, 00:00:00 UTC. Format temporel : YYYY-MM-DDThh:mm:ssZ.
Period	String	No	60	Intervalle de renvoi des données de surveillance. La valeur doit être un multiple entier de 60. Unité : secondes. Remarque La valeur par défaut correspond à l'intervalle minimum d'envoi des requêtes de détection à l'adresse surveillée.
NextToken	String	No	49f7b317-7645-4cc9-94fd-ea42e5220930ea42e5220930ea42e522****	Curseur de pagination.
Length	Integer	No	1000	Nombre de points de données à renvoyer.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	3febb181-0d98-4af9-8b04-7faf36b048b9	ID de la requête.
Code	String	200	Code d'état HTTP. Remarque Le code d'état 200 indique que l'appel a réussi.
Success	String	true	Indique si l'appel a réussi. La valeur true signifie un succès ; false, un échec.
NextToken	String	ea42e5220930ea42e522****	Curseur de pagination.
Data	String	[{"Maximum":247,"Mimimum":61,"Average":154,"userId":"127067667954**","taskId":"49f7b317-7645-4cc9-94fd-ea42e522**","timestamp":1551581760000}]	Données de surveillance renvoyées.
Message	String	Successful	Message renvoyé.

Les données renvoyées contiennent une chaîne JSON qui peut inclure tout ou partie des paramètres suivants :

Error4XXRate : pourcentage de résultats de détection présentant des codes d'état 4XX.
Error6XXRate : pourcentage de résultats de détection présentant des codes d'état 6XX.
Error5XXRate : pourcentage de résultats de détection présentant des codes d'état 5XX.
Error4XXNumber : nombre de résultats de détection présentant des codes d'état 4XX.
Error5XXNumber : nombre de résultats de détection présentant des codes d'état 5XX.
Error6XXNumber : nombre de résultats de détection présentant des codes d'état 6XX.
Over5totalTime : pourcentage de requêtes de détection dont le temps de réponse dépasse 5 000 ms.
Over3totalTime : pourcentage de requêtes de détection dont le temps de réponse dépasse 3 000 ms.
Over2totalTime : pourcentage de requêtes de détection dont le temps de réponse dépasse 2 000 ms.
Over10FailureRate : pourcentage de points de détection dont le taux d'échec des requêtes dépasse 10 %.
Over100FailureRate : pourcentage de points de détection dont le taux d'échec des requêtes dépasse 99 %.
Over30FailureRate : pourcentage de points de détection dont le taux d'échec des requêtes dépasse 30 %.
Over50FailureRate : pourcentage de points de détection dont le taux d'échec des requêtes dépasse 50 %.
Over80FailureRate : pourcentage de points de détection dont le taux d'échec des requêtes dépasse 80 %.
Over90FailureRate : pourcentage de points de détection dont le taux d'échec des requêtes dépasse 90 %.
Over400NumberRate : pourcentage de résultats de détection dont le code d'état est supérieur à 400.
Over500NumberRate : pourcentage de résultats de détection dont le code d'état est supérieur à 500.
AvailableNumber : nombre de résultats de détection dont le code d'état est inférieur à 400.
UnavailableNumber : nombre de résultats de détection dont le code d'état est supérieur à 399.
Availability : pourcentage de résultats de détection dont le code d'état est inférieur à 400.
Unavailability : pourcentage de résultats de détection dont le code d'état est supérieur à 399.
ErrorCodeMaximum : code d'erreur maximal parmi les résultats de détection renvoyés sur une période donnée. Par exemple, si cinq points de détection envoient des requêtes et renvoient cinq codes d'état en une minute, dont quatre valent 200 et un vaut 404, le code d'erreur maximal est 404.
ErrorCodeMinimum : code d'erreur minimal parmi les résultats de détection renvoyés sur une période de surveillance. Par exemple, si cinq points de détection envoient des requêtes et renvoient cinq codes d'état en une minute, dont quatre valent 200 et un vaut 404, le code d'erreur minimal est 200.

Remarque

Nous vous recommandons d'utiliser les métriques AvailableNumber, UnavailableNumber, Availability, Unavailability, ErrorCodeMaximum ou ErrorCodeMinimum, dont les valeurs sont faciles à calculer.

Exemples

Exemple de requête

http(s)://[Endpoint]/? Action=DescribeSiteMonitorData
&MetricName=Availability
&TaskId=49f7b317-7645-4cc9-94fd-ea42e522****
&<Common request parameters>

Exemple de réponse réussie

XML format

<DescribeSiteMonitorData>
		  <Data>
			    <Over5totalTime>0</Over5totalTime>
			    <Error4XXRate>0</Error4XXRate>
			    <UnavailableNumber>0</UnavailableNumber>
			    <Over2totalTime>0</Over2totalTime>
			    <timestamp>1551581040000</timestamp>
			    <Over100FailureRate>0</Over100FailureRate>
			    <Over10FailureRate>0</Over10FailureRate>
			    <Availability>100</Availability>
			    <Over80FailureRate>0</Over80FailureRate>
			    <userId>123****</userId>
			    <AvailableNumber>2</AvailableNumber>
			    <Unavailability>0</Unavailability>
			    <ErrorCodeMaximum>0</ErrorCodeMaximum>
			    <Over10totalTime>0</Over10totalTime>
			    <taskId>49f7b317-7645-4cc9-94fd-1****</taskId>
			    <Over30FailureRate>0</Over30FailureRate>
			    <Error6XXRate>0</Error6XXRate>
			    <Over500NumberRate>0</Over500NumberRate>
			    <Over3totalTime>0</Over3totalTime>
			    <Over400NumberRate>0</Over400NumberRate>
			    <Error5XXRate>0</Error5XXRate>
			    <Error5XXNumber>0</Error5XXNumber>
			    <Over90FailureRate>0</Over90FailureRate>
			    <Error4XXNumber>0</Error4XXNumber>
			    <Over50FailureRate>0</Over50FailureRate>
			    <ErrorCodeMinimum>0</ErrorCodeMinimum>
			    <Error6XXNumber>0</Error6XXNumber>
		  </Data>
		  <Data>
			    <Over5totalTime>0</Over5totalTime>
			    <Error4XXRate>0</Error4XXRate>
			    <UnavailableNumber>0</UnavailableNumber>
			    <Over2totalTime>0</Over2totalTime>
			    <timestamp>1551581100000</timestamp>
			    <Over100FailureRate>0</Over100FailureRate>
			    <Over10FailureRate>0</Over10FailureRate>
			    <Availability>100</Availability>
			    <Over80FailureRate>0</Over80FailureRate>
			    <userId>12345</userId>
			    <AvailableNumber>2</AvailableNumber>
			    <Unavailability>0</Unavailability>
			    <ErrorCodeMaximum>0</ErrorCodeMaximum>
			    <Over10totalTime>0</Over10totalTime>
			    <taskId>49f7b317-7645-4cc9-94fd-1****</taskId>
			    <Over30FailureRate>0</Over30FailureRate>
			    <Error6XXRate>0</Error6XXRate>
			    <Over500NumberRate>0</Over500NumberRate>
			    <Over3totalTime>0</Over3totalTime>
			    <Over400NumberRate>0</Over400NumberRate>
			    <Error5XXRate>0</Error5XXRate>
			    <Error5XXNumber>0</Error5XXNumber>
			    <Over90FailureRate>0</Over90FailureRate>
			    <Error4XXNumber>0</Error4XXNumber>
			    <Over50FailureRate>0</Over50FailureRate>
			    <ErrorCodeMinimum>0</ErrorCodeMinimum>
			    <Error6XXNumber>0</Error6XXNumber>
		  </Data>
		  <RequestId>DBDEAC51-EA3C-4853-8F25-6B48D38A28A9</RequestId>
		  <Success>true</Success>
		  <Code>200</Code>
</DescribeSiteMonitorData>

JSON format

{
    "Data": [
        {
            "Over5totalTime": 0,
            "Error4XXRate": 0,
            "UnavailableNumber": 0,
            "Over2totalTime": 0,
            "timestamp": 1551581040000,
            "Over100FailureRate": 0,
            "Over10FailureRate": 0,
            "Availability": 100,
            "Over80FailureRate": 0,
            "userId": "123****",
            "AvailableNumber": 2,
            "Unavailability": 0,
            "ErrorCodeMaximum": 0,
            "Over10totalTime": 0,
            "taskId": "49f7b317-7645-4cc9-94fd-1****",
            "Over30FailureRate": 0,
            "Error6XXRate": 0,
            "Over500NumberRate": 0,
            "Over3totalTime": 0,
            "Over400NumberRate": 0,
            "Error5XXRate": 0,
            "Error5XXNumber": 0,
            "Over90FailureRate": 0,
            "Error4XXNumber": 0,
            "Over50FailureRate": 0,
            "ErrorCodeMinimum": 0,
            "Error6XXNumber": 0
        },
        {
            "Over5totalTime": 0,
            "Error4XXRate": 0,
            "UnavailableNumber": 0,
            "Over2totalTime": 0,
            "timestamp": 1551581100000,
            "Over100FailureRate": 0,
            "Over10FailureRate": 0,
            "Availability": 100,
            "Over80FailureRate": 0,
            "userId": "12345",
            "AvailableNumber": 2,
            "Unavailability": 0,
            "ErrorCodeMaximum": 0,
            "Over10totalTime": 0,
            "taskId": "49f7b317-7645-4cc9-94fd-1****",
            "Over30FailureRate": 0,
            "Error6XXRate": 0,
            "Over500NumberRate": 0,
            "Over3totalTime": 0,
            "Over400NumberRate": 0,
            "Error5XXRate": 0,
            "Error5XXNumber": 0,
            "Over90FailureRate": 0,
            "Error4XXNumber": 0,
            "Over50FailureRate": 0,
            "ErrorCodeMinimum": 0,
            "Error6XXNumber": 0
        }
    ],
    "RequestId": "DBDEAC51-EA3C-4853-8F25-6B48D38A28A9",
    "Success": true,
    "Code": "200"
}

Codes d'erreur

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