DescribeMetricData - : Central de Documentação do Alibaba Cloud

Limites

O limite de chamadas para cada operação de API é de 10 vezes por segundo. A conta Alibaba Cloud e os usuários RAM associados compartilham essa cota.

Precauções

A retenção dos dados de monitoramento de cada serviço de nuvem depende do parâmetro Period (período estatístico). Quanto maior o valor de Period, maior o intervalo de tempo abrangido pelos dados consultados e maior a duração da retenção. A lista a seguir detalha essas relações:

Valores de Period inferiores a 60 segundos resultam em retenção de sete dias.
Valor de Period igual a 60 segundos resulta em retenção de 31 dias.
Valor de Period igual a 300 segundos resulta em retenção de 91 dias.

Notas de uso

Nota

Ao contrário da operação

DescribeMetricList

, a operação DescribeMetricData oferece recursos estatísticos. Você pode definir o parâmetro

Dimension

como {"instanceId": "i-abcdefgh12****"} para agregar todos os dados da sua conta Alibaba Cloud.

Este tópico fornece um exemplo de como consultar os dados de monitoramento da métrica cpu_idle do Elastic Compute Service (ECS). O namespace do ECS é acs_ecs_dashboard.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação. O OpenAPI Explorer também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeMetricData	Operação a ser executada. Defina o valor como DescribeMetricData.
Namespace	String	Sim	acs_ecs_dashboard	Namespace do serviço de nuvem. Para mais informações sobre namespaces de serviços de nuvem, consulte Apêndice 1: Métricas.
MetricName	String	Sim	cpu_idle	Métrica usada para monitorar o serviço de nuvem. Para mais informações sobre métricas de serviços de nuvem, consulte Apêndice 1: Métricas.
Period	String	Não	60	Período estatístico dos dados de monitoramento. Valores válidos: 15, 60, 900 e 3600. Unidade: segundos. Nota Sem a especificação deste parâmetro, a consulta usa o período de relatório dos valores da métrica. Os períodos estatísticos variam conforme a métrica definida em `MetricName`. Para detalhes, consulte Apêndice 1: Métricas.
StartTime	String	Não	1618368900000	Início do intervalo de tempo para consulta dos dados de monitoramento. Sem a especificação de `StartTime` e `EndTime`, o sistema consulta os dados do último período estatístico. Com a especificação de `StartTime` e `EndTime`, o sistema consulta os dados do último período estatístico dentro do intervalo definido. Veja como determinar o período de consulta nos exemplos abaixo: Com `Period` igual a 15, o intervalo não pode exceder 20 minutos. Exemplo: StartTime 2021-05-08 08:10:00 e EndTime 2021-05-08 08:30:00 retornam os dados dos últimos 15 segundos desse intervalo. Com `Period` igual a 60 ou 900, o intervalo não pode exceder 2 horas. Exemplo: Period 60, StartTime 2021-05-08 08:00:00 e EndTime 2021-05-08 10:00:00 retornam os dados dos últimos 60 segundos desse intervalo. Com `Period` igual a 3600, o intervalo não pode exceder dois dias. Exemplo: StartTime 2021-05-08 08:00:00 e EndTime 2021-05-10 08:00:00 retornam os dados dos últimos 3.600 segundos desse intervalo. Formatos aceitos: Timestamp UNIX: milissegundos decorridos desde 00:00:00 de quinta-feira, 1º de janeiro de 1970. Formato de hora: AAAA-MM-DDThh:mm:ssZ Nota Defina `StartTime` com horário posterior a 00:00:00 de quinta-feira, 1º de janeiro de 1970. Caso contrário, o parâmetro será inválido. Use timestamps UNIX para evitar problemas de fuso horário.
EndTime	String	Não	1618368960000	Fim do intervalo de tempo para consulta dos dados de monitoramento. Sem a especificação de `StartTime` e `EndTime`, o sistema consulta os dados do último período estatístico. Com a especificação de `StartTime` e `EndTime`, o sistema consulta os dados do último período estatístico dentro do intervalo definido. Veja como determinar o período de consulta nos exemplos abaixo: Com `Period` igual a 15, o intervalo não pode exceder 20 minutos. Exemplo: StartTime 2021-05-08 08:10:00 e EndTime 2021-05-08 08:30:00 retornam os dados dos últimos 15 segundos desse intervalo. Com `Period` igual a 60 ou 900, o intervalo não pode exceder 2 horas. Exemplo: Period 60, StartTime 2021-05-08 08:00:00 e EndTime 2021-05-08 10:00:00 retornam os dados dos últimos 60 segundos desse intervalo. Com `Period` igual a 3600, o intervalo não pode exceder dois dias. Exemplo: StartTime 2021-05-08 08:00:00 e EndTime 2021-05-10 08:00:00 retornam os dados dos últimos 3.600 segundos desse intervalo. Formatos aceitos: Timestamp UNIX: milissegundos decorridos desde 00:00:00 de quinta-feira, 1º de janeiro de 1970. Formato de hora: AAAA-MM-DDThh:mm:ssZ Nota Use timestamps UNIX para evitar problemas de fuso horário.
Dimensions	String	Não	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]	Dimensões de monitoramento do recurso especificado. Defina o valor como um conjunto de pares `chave:valor`. Exemplo: `{"userId":"120886317861"}` ou `{"instanceId":"i-2ze2d6j5uhg20x47"}`. Nota Limite de 50 instâncias por solicitação.
Express	String	Não	{"groupby":["userId","instanceId"]}	Expressão para cálculo dos resultados da consulta em tempo real. Nota Somente a expressão `groupby` é compatível. Ela funciona de modo semelhante à instrução `GROUP BY` de bancos de dados.
Length	String	Não	1000	Número de entradas por página. Valor padrão: 1000. Nota Valor máximo permitido: 1440.

Para mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Code	String	200	Código de status. Nota O código 200 indica êxito na solicitação.
Message	String	The specified resource is not found.	Mensagem de erro.
RequestId	String	6A5F022D-AC7C-460E-94AE-B9E75083D027	ID da solicitação.
Datapoints	String	[{\"timestamp\":1618368900000,\"Average\":95.8291666666667,\"Minimum\":65.48,\"Maximum\":100.0},{\"timestamp\":1618368960000,\"Average\":95.8683333333333,\"Minimum\":67.84,\"Maximum\":100.0}]	Dados de monitoramento. O valor contém os seguintes campos: `timestamp`: timestamp de acionamento do alerta. `userId`: ID do usuário associado ao alerta. `instanceId`: ID da instância associada ao alerta. `Minimum`, `Average` e `Maximum`: métodos de agregação.
Period	String	60	Período estatístico dos dados de monitoramento. Valores válidos: 15, 60, 900 e 3600. Unidade: segundos.

Exemplos

Solicitações de exemplo

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

Respostas de sucesso de exemplo

Formato XML

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

<DescribeMetricDataResponse>
	<RequestId>7598FEED-3B79-4B4A-AD01-435F34DA8EDC</RequestId>
	<Period>60</Period>	
    <Datapoints>[{\"timestamp\":1618368900000,\"Average\":95.8291666666667,\"Minimum\":65.48,\"Maximum\":100.0},{\"timestamp\":1618368960000,\"Average\":95.8683333333333,\"Minimum\":67.84,\"Maximum\":100.0}]</Datapoints>
	<Code>200</Code>
</DescribeMetricDataResponse>

Formato JSON

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

{
  "RequestId" : "7598FEED-3B79-4B4A-AD01-435F34DA8EDC",
  "Period" : "60",
  "Datapoints" : "[{\"timestamp\":1618368900000,\"Average\":95.8291666666667,\"Minimum\":65.48,\"Maximum\":100.0},{\"timestamp\":1618368960000,\"Average\":95.8683333333333,\"Minimum\":67.84,\"Maximum\":100.0}]",
  "Code" : "200"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
404	ResourceNotFound	The specified resource is not found.	O recurso especificado não foi encontrado.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.