DescribeMetricLast - - Centro de documentación de Alibaba Cloud

Consulta los datos de monitoreo más recientes de una métrica.

Límites

Cada operación de API se puede invocar hasta 50 veces por segundo. Una cuenta de Alibaba Cloud y los usuarios RAM dentro de esa cuenta comparten la cuota.

Precauciones

La duración del almacenamiento de los datos de monitoreo de cada servicio en la nube depende del parámetro Period (periodo estadístico). Un valor mayor en el parámetro Period indica que los datos de monitoreo consultados abarcan un rango de tiempo más amplio. Además, la duración del almacenamiento de dichos datos es mayor. A continuación se describen las relaciones específicas:

Si el valor del parámetro Period es menor a 60 segundos, la duración del almacenamiento es de siete días.
Si el valor del parámetro Period es de 60 segundos, la duración del almacenamiento es de 31 días.
Si el valor del parámetro Period es de 300 segundos, la duración del almacenamiento es de 91 días.

Notas de uso

Este tema muestra un ejemplo sobre cómo consultar los datos de monitoreo más recientes de la métrica CPUUtilization para Elastic Compute Service (ECS). El namespace de ECS es acs_ecs_dashboard. El resultado devuelto indica que los datos de monitoreo de la instancia i-abcdefgh12**** de la cuenta 123456789876**** se consultaron con un intervalo de 60 segundos. Los valores máximo, mínimo y promedio de la métrica son 100, 93.1 y 99.52, respectivamente.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda invocar esta operación en OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeMetricLast	La operación que desea ejecutar. Establezca el valor en DescribeMetricLast.
Namespace	String	Sí	acs_ecs_dashboard	El namespace del servicio en la nube. Para obtener más información sobre los namespaces de los servicios en la nube, consulte Apéndice 1: Métricas.
MetricName	String	Sí	CPUUtilization	La métrica que se utiliza para monitorear el servicio en la nube. Para obtener más información sobre los nombres de las métricas, consulte Apéndice 1: Métricas.
Period	String	No	60	El periodo estadístico de los datos de monitoreo. Valores válidos: 15, 60, 900 y 3600. Unidad: segundos. Nota Si no se especifica este parámetro, los datos de monitoreo se consultan según el periodo en el que se reportan los valores de la métrica. Los periodos estadísticos varían según las métricas que especifica `MetricName`. Para obtener más información, consulte Apéndice 1: Métricas.
StartTime	String	No	2019-01-31 10:00:00	El inicio del rango de tiempo para consultar los datos de monitoreo.
EndTime	String	No	2019-01-31 10:10:00	El final del rango de tiempo para consultar los datos de monitoreo. Para datos por segundo, la hora de inicio se obtiene al comparar la hora que especifica el parámetro StartTime con la hora del parámetro EndTime menos 20 minutos. Se utiliza como hora de inicio el punto en el tiempo más antiguo de los dos comparados. Para datos por minuto, la hora de inicio se obtiene al comparar la hora que especifica el parámetro StartTime con la hora del parámetro EndTime menos 2 horas. Se utiliza como hora de inicio el punto en el tiempo más antiguo de los dos comparados. Para datos por hora, la hora de inicio se obtiene al comparar la hora que especifica el parámetro StartTime con la hora del parámetro EndTime menos dos días. Se utiliza como hora de inicio el punto en el tiempo más antiguo de los dos comparados.
Dimensions	String	No	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]	Las dimensiones de monitoreo del recurso especificado. Establezca el valor como un conjunto de pares `clave:valor`. Ejemplo: `{"userId":"120886317861"}` o `{"instanceId":"i-2ze2d6j5uhg20x47"}`. Nota Puede consultar un máximo de 50 instancias en una sola solicitud.
NextToken	String	No	15761432850009dd70bb64cff1f0fff6c0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****	El token de paginación. Si la cantidad de resultados supera el número máximo de entradas permitidas en una sola página, se devuelve un token de paginación. Este token se usa como parámetro de entrada para obtener la siguiente página de resultados. Si ya se obtuvieron todos los resultados, no se devuelve ningún token.
Length	String	No	1000	El número de entradas por página. Valor predeterminado: 1000. Este valor indica que cada página devuelve un máximo de 1,000 entradas de datos de monitoreo. Nota El valor máximo del parámetro Length en una solicitud es 1440.
Express	String	No	{"groupby":["userId","instanceId"]}	La expresión que se utiliza para calcular los resultados de la consulta en tiempo real.

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
NextToken	String	xxxxxx	El token de paginación.
RequestId	String	021472A6-25E3-4094-8D00-BA4B6A5486C3	El ID de la solicitud.
Success	Boolean	true	Indica si la solicitud fue exitosa. Valores válidos: true false
Datapoints	String	[{"timestamp":1548777660000,"userId":"123456789876**","instanceId":"i-abcdefgh12**","Minimum":93.1,"Average":99.52,"Maximum":100}]	Los datos de monitoreo.
Code	String	200	El código de estado. Nota El código de estado 200 indica que la solicitud fue exitosa.
Message	String	The specified resource is not found.	El mensaje de error.
Period	String	60	El intervalo de tiempo. Unidad: segundos.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<QueryMetricListResponse>
	<Period>60</Period>
	<Datapoints>
		<timestamp>1548777660000</timestamp>
		<Maximum>100</Maximum>
		<userId>123456789876****</userId>
		<Minimum>93.1</Minimum>
		<instanceId>i-abcdefgh12****</instanceId>
		<Average>99.52</Average>
	</Datapoints>
	<RequestId>6A5F022D-AC7C-460E-94AE-B9E75083D027</RequestId>
	<Success>true</Success>
	<Code>200</Code>
</QueryMetricListResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Period" : "60",
  "Datapoints" : [ {
    "timestamp" : 1548777660000,
    "Maximum" : 100,
    "userId" : "123456789876****",
    "Minimum" : 93.1,
    "instanceId" : "i-abcdefgh12****",
    "Average" : 99.52
  } ],
  "RequestId" : "6A5F022D-AC7C-460E-94AE-B9E75083D027",
  "Success" : true,
  "Code" : "200"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
404	ResourceNotFound	The specified resource is not found.	No se encontró el recurso especificado.

Para ver la lista de códigos de error, consulte Códigos de error del servicio.