DescribeMetricData - - Centro de documentación de Alibaba Cloud

Consulta los datos de monitoreo de una métrica de serie temporal de un servicio en la nube durante un periodo especificado.

Para obtener más información sobre cómo asignar valores a los parámetros Namespace, Project, Metric, Period y Dimensions para servicios en la nube, consulte DescribeMetricMetaList o Apéndice 1: Métricas.

Nota

A diferencia de

DescribeMetricList

, esta operación proporciona funciones estadísticas. Establezca el parámetro Dimension en {"userId:"xxxx"} para agregar todos los datos del usuario especificado.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que ejecute esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeMetricData	La operación que desea ejecutar. Establezca el valor en DescribeMetricData.
MetricName	String	Sí	cpu_idle	El nombre de la métrica que desea consultar.
Namespace	String	Sí	acs_ecs_dashboard	El namespace del servicio. Especifique el valor con el formato acs_Service.
Period	String	No	60	El intervalo de tiempo para consultar datos de monitoreo. Unidad: segundos. Valores válidos: 60, 300 y 900. Establezca este parámetro según sea necesario.
StartTime	String	No	2019-01-30 00:00:00	El inicio del rango de tiempo a consultar. Formatos compatibles: Marca de tiempo UNIX: el número de milisegundos transcurridos desde el 1 de enero de 1970, 00:00:00 UTC. Formato de hora: AAAA-MM-DDThh:mm:ssZ. Nota El periodo especificado por StartTime y EndTime incluye el punto temporal indicado por EndTime, pero no incluye el punto temporal indicado por StartTime. StartTime debe ser anterior a EndTime.
EndTime	String	No	2019-01-30 00:10:00	El final del rango de tiempo a consultar. Formatos compatibles: Marca de tiempo UNIX: el número de milisegundos transcurridos desde el 1 de enero de 1970, 00:00:00 UTC. Formato de hora: AAAA-MM-DDThh:mm:ssZ.
Dimensions	String	No	[{"instanceId": "i-abcdefgh12****"}]	Las dimensiones que especifican los recursos para los cuales desea consultar datos de monitoreo. Establezca el valor como un conjunto de pares clave-valor. Un par clave-valor típico es `instanceId:XXXXXX`. Tanto la clave como el valor pueden tener una longitud de 1 a 64 bytes. Los valores que superen los 64 caracteres se truncarán. La clave y el valor pueden contener letras, dígitos, puntos (.), guiones (-), guiones bajos (_), barras diagonales (/) y barras invertidas (\). Nota Dimensions debe organizarse en una cadena JSON y seguir el orden obligatorio.
Express	String	No	"{"groupby":["userId","instanceId"]}"	La expresión para el cálculo en tiempo real sobre los resultados de la consulta. Solo se admite la expresión groupby. Esta expresión es similar a la instrucción GROUP BY utilizada en bases de datos.
Length	String	No	1000	El número de entradas a devolver en cada página.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Code	String	200	El código de respuesta. Nota El código HTTP 200 indica que la solicitud fue exitosa.
Datapoints	String	[{"timestamp":1548777660000,"userId":"123**","instanceId":"i-abc**","Minimum":9.92,"Average":9.92,"Maximum":9.92}]	Los datos de monitoreo de la métrica. El valor incluye los siguientes campos: timestamp: la marca de tiempo cuando se activó la alerta. userId: el ID del usuario para el cual se activó la alerta. instanceId: el ID de la instancia para la cual se activó la alerta. Minimum, Average y Maximum: los métodos de agregación.
Message	String	The Request is not authorization.	El mensaje de error.
Period	String	60	El intervalo de tiempo en el que se consultaron los datos de monitoreo. Unidad: segundos. Valores válidos: 60, 300 y 900.
RequestId	String	6A5F022D-AC7C-460E-94AE-B9E75083D027	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/? Action=DescribeMetricData
&MetricName=cpu_idle
&Namespace=acs_ecs_dashboard
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<DescribeMetricData>
		  <Period>60</Period>
		  <Datapoints>
			    <timestamp>1490152860000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>93.1</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.52</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490152920000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>92.59</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.49</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490152980000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>92.86</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.44</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153040000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>91.43</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.36</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153100000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>93.55</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.51</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153160000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>93.1</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.52</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153220000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>92.59</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.42</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153280000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>91.18</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.34</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153340000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>92.86</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.46</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153400000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>91.18</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.35</Average>
		  </Datapoints>
		  <RequestId>6A5F022D-AC7C-460E-94AE-B9E75083D027</RequestId>
		  <Code>200</Code>
</DescribeMetricData>

Formato JSON

{
    "Period": "60",
    "Datapoints": [
        {
            "timestamp": 1490152860000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 93.1,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.52
        },
        {
            "timestamp": 1490152920000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 92.59,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.49
        },
        {
            "timestamp": 1490152980000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 92.86,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.44
        },
        {
            "timestamp": 1490153040000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 91.43,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.36
        },
        {
            "timestamp": 1490153100000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 93.55,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.51
        },
        {
            "timestamp": 1490153160000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 93.1,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.52
        },
        {
            "timestamp": 1490153220000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 92.59,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.42
        },
        {
            "timestamp": 1490153280000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 91.18,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.34
        },
        {
            "timestamp": 1490153340000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 92.86,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.46
        },
        {
            "timestamp": 1490153400000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 91.18,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.35
        }
    ],
    "RequestId": "6A5F022D-AC7C-460E-94AE-B9E75083D027",
    "Code": "200"
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.